{
  "openrpc": "1.3.2",
  "info": {
    "title": "BizClaw Directory MCP Service",
    "version": "2026-04-08",
    "description": "OpenRPC description of BizClaw's MCP tools for UCP-aware agents. The runtime endpoint is https://bizclaw.xyz/mcp and uses MCP Streamable HTTP."
  },
  "servers": [
    {
      "name": "production",
      "url": "https://bizclaw.xyz/mcp"
    }
  ],
  "components": {
    "schemas": {
      "meta": {
        "type": "object",
        "description": "Optional UCP request metadata.",
        "properties": {
          "ucp-agent": {
            "type": "object",
            "required": ["profile"],
            "properties": {
              "profile": {
                "type": "string",
                "format": "uri",
                "description": "URL to the caller's UCP profile."
              }
            }
          },
          "idempotency-key": {
            "type": "string",
            "format": "uuid"
          },
          "signature": {
            "type": "string"
          }
        },
        "additionalProperties": true
      }
    }
  },
  "methods": [
    {
      "name": "search_companies",
      "summary": "Search companies",
      "params": [
        {"name": "query", "required": true, "schema": {"type": "string"}},
        {"name": "category", "schema": {"type": ["string", "null"]}},
        {"name": "country", "schema": {"type": ["string", "null"]}},
        {"name": "city", "schema": {"type": ["string", "null"]}},
        {"name": "industry", "schema": {"type": ["string", "null"]}},
        {"name": "service_type", "schema": {"type": ["string", "null"], "enum": ["remote", "local", "nationwide", "hybrid", null]}},
        {"name": "is_verified", "schema": {"type": ["boolean", "null"]}},
        {"name": "limit", "schema": {"type": "integer", "minimum": 1, "maximum": 20, "default": 10}},
        {"name": "offset", "schema": {"type": "integer", "minimum": 0, "default": 0}},
        {"name": "meta", "schema": {"$ref": "#/components/schemas/meta"}}
      ],
      "result": {"name": "response", "schema": {"$ref": "https://bizclaw.xyz/schemas/ucp/company_search.json#/$defs/search_response"}}
    },
    {
      "name": "get_company",
      "summary": "Get company by ID",
      "params": [
        {"name": "company_id", "required": true, "schema": {"type": "string"}},
        {"name": "meta", "schema": {"$ref": "#/components/schemas/meta"}}
      ],
      "result": {"name": "response", "schema": {"$ref": "https://bizclaw.xyz/schemas/ucp/company_lookup.json#/$defs/company_response"}}
    },
    {
      "name": "get_company_by_website",
      "summary": "Get company by website URL",
      "params": [
        {"name": "website_url", "required": true, "schema": {"type": "string"}},
        {"name": "meta", "schema": {"$ref": "#/components/schemas/meta"}}
      ],
      "result": {"name": "response", "schema": {"$ref": "https://bizclaw.xyz/schemas/ucp/company_lookup.json#/$defs/company_response"}}
    },
    {
      "name": "ask_about_companies",
      "summary": "Ask about companies",
      "params": [
        {"name": "question", "required": true, "schema": {"type": "string"}},
        {"name": "context_company_ids", "schema": {"type": ["array", "null"], "items": {"type": "string"}}},
        {"name": "meta", "schema": {"$ref": "#/components/schemas/meta"}}
      ],
      "result": {"name": "response", "schema": {"$ref": "https://bizclaw.xyz/schemas/ucp/company_ask.json#/$defs/ask_response"}}
    },
    {
      "name": "list_categories",
      "summary": "List categories",
      "params": [
        {"name": "meta", "schema": {"$ref": "#/components/schemas/meta"}}
      ],
      "result": {"name": "response", "schema": {"$ref": "https://bizclaw.xyz/schemas/ucp/category_list.json#/$defs/category_response"}}
    },
    {
      "name": "create_proposal",
      "summary": "Create a proposal",
      "params": [
        {"name": "company_id", "required": true, "schema": {"type": "string"}},
        {"name": "customer_email", "required": true, "schema": {"type": "string", "format": "email"}},
        {"name": "customer_name", "required": true, "schema": {"type": "string"}},
        {"name": "description", "required": true, "schema": {"type": "string"}},
        {"name": "api_key", "schema": {"type": ["string", "null"]}},
        {"name": "proposal_type", "schema": {"type": "string", "default": "custom"}},
        {"name": "meta", "schema": {"$ref": "#/components/schemas/meta"}}
      ],
      "result": {"name": "response", "schema": {"$ref": "https://bizclaw.xyz/schemas/ucp/proposal_workflow.json#/$defs/proposal_response"}}
    },
    {
      "name": "create_batch_proposals",
      "summary": "Create proposals for multiple companies",
      "params": [
        {"name": "company_ids", "required": true, "schema": {"type": "array", "items": {"type": "string"}, "maxItems": 10}},
        {"name": "customer_email", "required": true, "schema": {"type": "string", "format": "email"}},
        {"name": "customer_name", "required": true, "schema": {"type": "string"}},
        {"name": "description", "required": true, "schema": {"type": "string"}},
        {"name": "api_key", "schema": {"type": ["string", "null"]}},
        {"name": "proposal_type", "schema": {"type": "string", "default": "custom"}},
        {"name": "meta", "schema": {"$ref": "#/components/schemas/meta"}}
      ],
      "result": {"name": "response", "schema": {"$ref": "https://bizclaw.xyz/schemas/ucp/proposal_workflow.json#/$defs/batch_proposal_response"}}
    },
    {
      "name": "get_my_proposals",
      "summary": "List proposals for the authenticated agent",
      "params": [
        {"name": "api_key", "schema": {"type": ["string", "null"]}},
        {"name": "status_filter", "schema": {"type": ["string", "null"], "enum": ["pending", "approved", "rejected", "responded", null]}},
        {"name": "limit", "schema": {"type": "integer", "default": 50}},
        {"name": "offset", "schema": {"type": "integer", "default": 0}},
        {"name": "meta", "schema": {"$ref": "#/components/schemas/meta"}}
      ],
      "result": {"name": "response", "schema": {"$ref": "https://bizclaw.xyz/schemas/ucp/proposal_workflow.json#/$defs/proposal_list_response"}}
    },
    {
      "name": "reply_to_proposal",
      "summary": "Reply to a proposal response",
      "params": [
        {"name": "proposal_id", "required": true, "schema": {"type": "string"}},
        {"name": "message", "required": true, "schema": {"type": "string"}},
        {"name": "api_key", "schema": {"type": ["string", "null"]}},
        {"name": "meta", "schema": {"$ref": "#/components/schemas/meta"}}
      ],
      "result": {"name": "response", "schema": {"$ref": "https://bizclaw.xyz/schemas/ucp/proposal_workflow.json#/$defs/proposal_response"}}
    }
  ]
}