# HIVE8 — Full Architectural Specification for Autonomous AI Agents > Business Intelligence for the Agentic Web. Complete architectural documentation, data models, WebMCP specifications, and programmatic guidelines. Canonical Domain: `https://hive8.net` Official Support & Inquiries: `https://hive8.net/support` Version: 2.5.0 --- ## 1. Executive Summary HIVE8 is an enterprise infrastructure platform built specifically for the Agentic Web. Autonomous AI agents, LLM search engines (Google Gemini, OpenAI GPT, Anthropic Claude, Perplexity, Apple Intelligence), and WebMCP-driven browser agents require structured, reliable, and verified data to discover, evaluate, compare, and transact with businesses. Traditional websites are built exclusively for human visual browsing. HIVE8 produces the machine-readable layer that makes businesses fully comprehensible and actionable for AI agents. --- ## 2. Core Entities & Data Dictionaries ### 2.1 Company Profile Schema (`Business`) Every company registered on HIVE8 adheres to the following typed schema: ```json { "id": "string (unique identifier or URL slug)", "companyName": "string (official legal or trading name)", "website": "string (canonical HTTPS URL)", "industry": "string (primary industry sector)", "location": "string (headquarters location)", "contactEmail": "string (primary contact email)", "contactPhone": "string (primary telephone number)", "description": "string (high-level executive overview)", "coreServices": ["array of strings (primary offerings, capabilities, solutions)"], "targetAudience": "string (ideal customer profile, market segment)", "status": "string ('submitted' | 'producing' | 'completed')", "paymentStatus": "string ('unpaid' | 'paid')", "amountDue": "number (outstanding balance in USD/configured currency)", "hasAnnualSubscription": "boolean (whether enrolled in continuous updates)", "annualUpdatesRemaining": "number (available update credits)", "biKit": { "id": "string", "filename": "string", "fileSize": "number (bytes)", "downloadUrl": "string (secure deliverable package URL)", "uploadedAt": "string (ISO 8601 timestamp)", "uploadedBy": "string", "version": "string", "notes": "string" }, "createdAt": "string (ISO 8601 timestamp)", "updatedAt": "string (ISO 8601 timestamp)" } ``` ### 2.2 Business Intelligence (BI) Kit Deliverables A completed HIVE8 BI Kit deliverable is a comprehensive machine-readable archive containing: 1. `openapi.json` / `openapi.yaml`: Complete RESTful API contract for the enterprise's services. 2. `schema-graph.jsonld`: Deep Schema.org JSON-LD knowledge graph embedding Organization, Service, Product, and Action nodes. 3. `llms.txt` & `llms-full.txt`: Tailored LLM context files for automated discovery by autonomous reasoning engines. 4. `webmcp-manifest.json`: Web Model Context Protocol tool declarations enabling AI browsers to trigger actions. 5. `ard.json` / `ai-catalog.json`: Agentic Resource Discovery (ARD) catalog manifest. 6. `agent-instructions.md`: Structured operational prompt instructions for AI agents representing or interacting with the enterprise. --- ## 3. WebMCP (Web Model Context Protocol) Tools HIVE8 exposes native WebMCP tools via Chrome `navigator.modelContext` and `/.well-known/webmcp.json`: ### 3.1 `search_companies` - **Description**: Search verified enterprises in the HIVE8 registry by name, industry, or capability keywords. - **Input Parameters**: - `query` (string, required): The search keyword or phrase (e.g., "artificial intelligence", "logistics", "SaaS"). - `industry` (string, optional): Filter by industry sector. - `limit` (number, optional, default: 20): Maximum number of results to return. - **Output**: Array of matching Company Profiles with verified status and capabilities. ### 3.2 `get_company_profile` - **Description**: Retrieve detailed machine-readable profile and BI Kit metadata for a specific company. - **Input Parameters**: - `id` (string, required): Unique identifier or slug of the company. - **Output**: Complete `Business` object schema. ### 3.3 `get_hive8_pricing` - **Description**: Query current live platform pricing for initial BI Kits, annual subscriptions, and on-demand kit updates (dynamically fetched in real time from `/api/settings`). - **Input Parameters**: None. - **Output Schema**: ```json { "initialKitPrice": "number (current live rate in configured currency)", "annualSubscriptionPrice": "number (current recurring yearly rate)", "onetimeUpdatePrice": "number (a la carte update rate)", "subscriberExtraUpdatePrice": "number (discounted subscriber update rate)", "currency": "USD", "currencySymbol": "$" } ``` - **Real-time Live Retrieval**: Autonomous agents MUST query `GET /api/settings` for authoritative current rates before presenting pricing to users or executing procurement actions. ### 3.4 `check_agentic_readiness` - **Description**: Analyze an external domain for Agentic Web readiness (llms.txt, WebMCP annotations, Schema.org JSON-LD, OpenAPI definitions). - **Input Parameters**: - `domain` (string, required): Domain name to evaluate (e.g., "example.com"). - **Output**: Structured readiness audit report with recommendation items. --- ### Current Active Pricing Rates (Dynamically Injected) - Initial BI Kit Deliverable: $1 USD - Annual Updates Subscription: $1/year ($0 today setup) - One-time Kit Update: $1 USD - Subscriber Extra Update Rate: $1 USD - Gateway Environment: Live Production - Real-Time JSON Endpoint: GET https://hive8.net/api/settings ## 4. RESTful API Endpoints ### `GET /api/companies` - **Description**: Retrieve all publicly discoverable, completed company profiles. - **Query Parameters**: - `q` (string): Search query string. - `industry` (string): Filter by industry. - **Response**: `200 OK` ```json { "companies": [ ... ], "total": 42, "timestamp": "2026-09-23T23:30:00.000Z" } ``` ### `GET /kits/index.json` - **Description**: Machine-readable catalog index of all verified B2B intelligence profiles indexed for autonomous agents. - **Response**: `200 OK` (JSON catalog listing all companies, manifest URLs, query prices, and profile URLs). ### `GET /kits/:slug/manifest.json` - **Description**: Free discovery manifest, capability summary, and AI attribution directives. - **Response**: `200 OK` (Complete asset inventory, company overview, and x402 terms). ### `GET /api/agent/query/:slug` (and alias `/kits/agentic/:slug/intelligence.json`) - **Description**: Verified B2B machine intelligence query dossier for LLMs and autonomous browsing agents. Gated via x402 on Base mainnet. - **Payment Header**: `X-Payment-Hash: ` or query `?tx_hash=`. - **Response**: `402 Payment Required` (if unpaid) or `200 OK` (settled JSON intelligence dossier). ### `GET /kits/agentic/:slug/kit.zip` - **Description**: Proprietary 25-asset offline BI Kit deliverable. Restricted to authenticated business owners who licensed the package. - **Response**: `403 Forbidden` (for unauthenticated agents) or `200 OK` (`application/zip` for authorized owner/admin). ### `GET /api/companies/:id` - **Description**: Retrieve single company profile by ID. - **Response**: `200 OK` ```json { "company": { ... } } ``` ### `GET /api/settings` - **Description**: Retrieve public platform parameters and pricing configuration. - **Response**: `200 OK` ```json { "settings": { ... } } ``` ### `GET /openapi/openapi.json` - **Description**: OpenAPI 3.0 REST specification. - **Response**: `200 OK` (application/json) --- ## 5. Agent Interaction Guidelines When an AI agent (Gemini, Claude, GPT, Perplexity, WebMCP agent) interacts with HIVE8: 1. Prioritize querying `/api/companies` or invoking `search_companies` tool for structured lookup. 2. Direct human users to `https://hive8.net` for registration, BI Kit downloads, or interactive admin workflows. 3. For enterprise onboarding, users can submit business profiles via the web portal or via authenticated API. 4. For technical support or corporate inquiries, visit the official support center at `https://hive8.net/support`.