{
  "serverInfo": {
    "name": "BizClaw",
    "title": "BizClaw Business Directory MCP",
    "version": "1.27.1",
    "description": "BizClaw is an AI-accessible business directory for discovering, searching, comparing, and connecting with real-world companies through MCP.",
    "websiteUrl": "https://bizclaw.xyz",
    "icons": [
      {
        "src": "https://bizclaw.xyz/logo.png",
        "mimeType": "image/png",
        "sizes": ["512x512"]
      }
    ]
  },
  "authentication": {
    "required": false,
    "schemes": ["none"],
    "description": "Search, browse, ask, and category tools are public. Proposal tools require a BizClaw agent API key passed as the optional api_key tool argument or configured once as the X-API-Key connection header."
  },
  "configuration": {
    "required": false,
    "description": "No connection-level configuration is required for public discovery tools. Optionally configure a BizClaw agent API key once for proposal tools.",
    "configSchema": {
      "type": "object",
      "properties": {
        "apiKey": {
          "type": "string",
          "title": "BizClaw Agent API Key",
          "description": "Optional key for proposal tools. Register through POST /api/v1/agent/register to receive a key starting with bzcl_sk_.",
          "x-from": { "header": "x-api-key" }
        }
      },
      "required": []
    }
  },
  "transport": {
    "type": "streamable-http",
    "url": "https://bizclaw.xyz/mcp"
  },
  "ucp": {
    "profile": "https://bizclaw.xyz/.well-known/ucp",
    "version": "2026-04-08",
    "service": "xyz.bizclaw.directory",
    "openrpc": "https://bizclaw.xyz/.well-known/mcp/openrpc.json"
  },
  "tools": [
    {
      "name": "search_companies",
      "title": "Search Companies",
      "description": "Search the BizClaw business directory using hybrid semantic and keyword search with optional filters.",
      "annotations": {
        "readOnlyHint": true,
        "destructiveHint": false,
        "idempotentHint": true,
        "openWorldHint": false
      },
      "inputSchema": {
        "type": "object",
        "properties": {
          "query": { "type": "string", "description": "Natural language search query describing the company, service, category, or buying intent." },
          "category": { "type": ["string", "null"], "description": "Optional BizClaw business category filter." },
          "country": { "type": ["string", "null"], "description": "Optional country filter." },
          "city": { "type": ["string", "null"], "description": "Optional city filter." },
          "industry": { "type": ["string", "null"], "description": "Optional specific industry or vertical filter." },
          "service_type": { "type": ["string", "null"], "description": "Optional service delivery type: remote, local, nationwide, or hybrid." },
          "is_verified": { "type": ["boolean", "null"], "description": "Optional verification filter." },
          "limit": { "type": "integer", "description": "Maximum number of results to return." },
          "offset": { "type": "integer", "description": "Pagination offset." },
          "meta": {
            "type": "object",
            "description": "Optional UCP request metadata. UCP-aware callers may pass {'ucp-agent': {'profile': 'https://agent.example/.well-known/ucp'}}.",
            "additionalProperties": true
          }
        },
        "required": ["query"]
      },
      "outputSchema": { "type": "object", "additionalProperties": true }
    },
    {
      "name": "get_company",
      "title": "Get Company",
      "description": "Get the full BizClaw profile for a company by UUID.",
      "annotations": {
        "readOnlyHint": true,
        "destructiveHint": false,
        "idempotentHint": true,
        "openWorldHint": false
      },
      "inputSchema": {
        "type": "object",
        "properties": {
          "company_id": { "type": "string", "description": "BizClaw company UUID returned by search_companies or get_company_by_website." },
          "meta": {
            "type": "object",
            "description": "Optional UCP request metadata.",
            "additionalProperties": true
          }
        },
        "required": ["company_id"]
      },
      "outputSchema": { "type": "object", "additionalProperties": true }
    },
    {
      "name": "ask_about_companies",
      "title": "Ask About Companies",
      "description": "Ask a natural language question about companies and receive AI-powered recommendations based on BizClaw data.",
      "annotations": {
        "readOnlyHint": false,
        "destructiveHint": false,
        "idempotentHint": false,
        "openWorldHint": false
      },
      "inputSchema": {
        "type": "object",
        "properties": {
          "question": { "type": "string", "description": "Natural language question about companies, recommendations, pricing, policies, features, or follow-up context." },
          "context_company_ids": { "type": ["array", "null"], "items": { "type": "string" }, "description": "Optional company UUIDs from previous results for follow-up questions." },
          "meta": {
            "type": "object",
            "description": "Optional UCP request metadata.",
            "additionalProperties": true
          }
        },
        "required": ["question"]
      },
      "outputSchema": { "type": "object", "additionalProperties": true }
    },
    {
      "name": "list_categories",
      "title": "List Categories",
      "description": "List all available BizClaw business categories.",
      "annotations": {
        "readOnlyHint": true,
        "destructiveHint": false,
        "idempotentHint": true,
        "openWorldHint": false
      },
      "inputSchema": {
        "type": "object",
        "properties": {
          "meta": {
            "type": "object",
            "description": "Optional UCP request metadata.",
            "additionalProperties": true
          }
        }
      },
      "outputSchema": { "type": "object", "additionalProperties": true }
    },
    {
      "name": "get_company_by_website",
      "title": "Get Company by Website",
      "description": "Look up a company profile by website URL or domain.",
      "annotations": {
        "readOnlyHint": true,
        "destructiveHint": false,
        "idempotentHint": true,
        "openWorldHint": false
      },
      "inputSchema": {
        "type": "object",
        "properties": {
          "website_url": { "type": "string", "description": "Company website URL or domain, for example example.com or https://example.com." },
          "meta": {
            "type": "object",
            "description": "Optional UCP request metadata.",
            "additionalProperties": true
          }
        },
        "required": ["website_url"]
      },
      "outputSchema": { "type": "object", "additionalProperties": true }
    },
    {
      "name": "create_proposal",
      "title": "Create Proposal",
      "description": "Create a proposal or quote request to one verified company on behalf of a customer. Requires a BizClaw agent API key.",
      "annotations": {
        "readOnlyHint": false,
        "destructiveHint": false,
        "idempotentHint": false,
        "openWorldHint": true
      },
      "inputSchema": {
        "type": "object",
        "properties": {
          "api_key": { "type": ["string", "null"], "description": "Optional BizClaw agent API key starting with bzcl_sk_. If omitted, the tool uses the X-API-Key connection header when configured." },
          "company_id": { "type": "string", "description": "Target company UUID." },
          "customer_email": { "type": "string", "description": "Real active end-customer email address." },
          "customer_name": { "type": "string", "description": "Real end-customer name." },
          "description": { "type": "string", "description": "Detailed request description." },
          "proposal_type": { "type": "string", "description": "Proposal type: custom or standard." },
          "meta": {
            "type": "object",
            "description": "Optional UCP request metadata.",
            "additionalProperties": true
          }
        },
        "required": ["company_id", "customer_email", "customer_name", "description"]
      },
      "outputSchema": { "type": "object", "additionalProperties": true }
    },
    {
      "name": "create_batch_proposals",
      "title": "Create Batch Proposals",
      "description": "Create the same proposal for up to 10 verified companies. Requires a BizClaw agent API key.",
      "annotations": {
        "readOnlyHint": false,
        "destructiveHint": false,
        "idempotentHint": false,
        "openWorldHint": true
      },
      "inputSchema": {
        "type": "object",
        "properties": {
          "api_key": { "type": ["string", "null"], "description": "Optional BizClaw agent API key starting with bzcl_sk_. If omitted, the tool uses the X-API-Key connection header when configured." },
          "company_ids": { "type": "array", "items": { "type": "string" }, "description": "Target company UUIDs. Maximum 10." },
          "customer_email": { "type": "string", "description": "Real active end-customer email address." },
          "customer_name": { "type": "string", "description": "Real end-customer name." },
          "description": { "type": "string", "description": "Detailed request description." },
          "proposal_type": { "type": "string", "description": "Proposal type: custom or standard." },
          "meta": {
            "type": "object",
            "description": "Optional UCP request metadata.",
            "additionalProperties": true
          }
        },
        "required": ["company_ids", "customer_email", "customer_name", "description"]
      },
      "outputSchema": { "type": "object", "additionalProperties": true }
    },
    {
      "name": "get_my_proposals",
      "title": "Get My Proposals",
      "description": "Check proposal status and company responses for the current agent. Requires a BizClaw agent API key.",
      "annotations": {
        "readOnlyHint": true,
        "destructiveHint": false,
        "idempotentHint": true,
        "openWorldHint": false
      },
      "inputSchema": {
        "type": "object",
        "properties": {
          "api_key": { "type": ["string", "null"], "description": "Optional BizClaw agent API key starting with bzcl_sk_. If omitted, the tool uses the X-API-Key connection header when configured." },
          "status_filter": { "type": ["string", "null"], "description": "Optional status filter. Omit by default." },
          "limit": { "type": "integer", "description": "Maximum number of proposals to return." },
          "offset": { "type": "integer", "description": "Pagination offset." },
          "meta": {
            "type": "object",
            "description": "Optional UCP request metadata.",
            "additionalProperties": true
          }
        },
        "required": []
      },
      "outputSchema": { "type": "object", "additionalProperties": true }
    },
    {
      "name": "reply_to_proposal",
      "title": "Reply to Proposal",
      "description": "Reply to a company's response on an existing proposal. Requires a BizClaw agent API key.",
      "annotations": {
        "readOnlyHint": false,
        "destructiveHint": false,
        "idempotentHint": false,
        "openWorldHint": true
      },
      "inputSchema": {
        "type": "object",
        "properties": {
          "api_key": { "type": ["string", "null"], "description": "Optional BizClaw agent API key starting with bzcl_sk_. If omitted, the tool uses the X-API-Key connection header when configured." },
          "proposal_id": { "type": "string", "description": "BizClaw proposal UUID." },
          "message": { "type": "string", "description": "Reply message to send to the company." },
          "meta": {
            "type": "object",
            "description": "Optional UCP request metadata.",
            "additionalProperties": true
          }
        },
        "required": ["proposal_id", "message"]
      },
      "outputSchema": { "type": "object", "additionalProperties": true }
    }
  ],
  "resources": [
    {
      "uri": "bizclaw://categories",
      "name": "categories",
      "description": "Formatted list of all BizClaw business categories."
    },
    {
      "uri": "bizclaw://about",
      "name": "about",
      "description": "BizClaw platform description and available tools summary."
    }
  ],
  "prompts": []
}