Model Context Protocol

Connect Your Agent to
BizClaw

BizClaw exposes a full MCP server. Any MCP-compatible agent can search the business directory, retrieve company profiles, and ask natural language questions — without writing a single API call.

MCP Server https://bizclaw.xyz/mcp

UCP profile: /.well-known/ucp

Get Connected in 3 Steps

Add the MCP Server

Add https://bizclaw.xyz/mcp as an HTTP MCP server in your agent's configuration.

Two-Tier Auth

Search & browse = no auth needed. Proposals & quotes = API key required. Register via POST /api/v1/agent/register with a real, active owner email.

Start Searching

Call search_companies, ask_about_companies, or any other tool directly from your agent.

Setup by Platform

Run this command in your terminal:

claude mcp add -s user --transport streamable-http bizclaw https://bizclaw.xyz/mcp

Then restart Claude Code. The bizclaw tools will be available immediately.

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "bizclaw": {
      "url": "https://bizclaw.xyz/mcp"
    }
  }
}

Add to your .cursor/mcp.json or MCP settings:

{
  "mcpServers": {
    "bizclaw": {
      "url": "https://bizclaw.xyz/mcp"
    }
  }
}

Send JSON-RPC 2.0 requests directly to the MCP endpoint:

Important: include Accept: application/json, text/event-stream. Responses are returned as SSE (event: message + data:).

POST https://bizclaw.xyz/mcp
Content-Type: application/json
Accept: application/json, text/event-stream

{"jsonrpc":"2.0","method":"tools/call","id":1,
 "params":{"name":"search_companies",
           "arguments":{"query":"logistics in Istanbul","city":"Istanbul"}}}

event: message
data: {"jsonrpc":"2.0","id":1,"result":{...}}

Want to send proposals? Register your agent first: POST https://bizclaw.xyz/api/v1/agent/register with {"name": "YourAgent", "owner_email": "[email protected]"}. Use the owner's real, active email address (no disposable or temporary inboxes). Never expose real API keys in logs, prompts, screenshots, or public repositories. Then add the API key to your MCP config:

{
  "mcpServers": {
    "bizclaw": {
      "url": "https://bizclaw.xyz/mcp",
      "headers": { "X-API-Key": "bzcl_sk_your_key_here" }
    }
  }
}

Proposal tools can still accept api_key directly as a fallback, but connection-level X-API-Key is the recommended path.

Available Tools

search_companies

Search the business directory with hybrid semantic + keyword search. Supports rich filtering.

query · string · required
category · string · optional
country · string · optional
city · string · optional
industry · string · optional
service_type · remote | local | nationwide | hybrid
is_verified · boolean · optional
limit · integer · default 10, max 20
offset · integer · default 0 (pagination)

ask_about_companies

Ask a natural language question. Returns AI-powered recommendations with matched company profiles.

question · string · required
context_company_ids · string[] · optional
Pass up to 10 IDs from previous results for follow-up questions

get_company

Get the full profile of a company by its UUID — features, pricing, contact info, branches, and more.

company_id · string (UUID) · required

get_company_by_website

Look up a company by its domain or website URL. Returns the full profile if it exists in the directory.

website_url · string · required
e.g. example.com or https://example.com

list_categories

Returns all 25 available business categories. Use these values to filter search_companies results precisely.

No parameters required

create_proposal API key required

Send a proposal/quote request to a verified company on behalf of a customer.

api_key · string · optional if X-API-Key is configured
company_id · string (UUID) · required
customer_email · string · required
customer_name · string · required
description · string · required
proposal_type · string · default: custom

create_batch_proposals API key required

Send the same proposal to multiple verified companies in one call (max 10).

api_key · string · optional if X-API-Key is configured
company_ids · string[] (UUIDs) · required
customer_email · string · required
customer_name · string · required
description · string · required
proposal_type · string · default: custom

get_my_proposals API key required

Check status and responses for all your proposals. Fetch all first, then filter only if the user explicitly asks for one status.

api_key · string · optional if X-API-Key is configured
status_filter · optional (pending | approved | rejected | responded)
limit · integer · default 50
offset · integer · default 0

reply_to_proposal API key required

Reply to a company's response on a proposal. Creates a conversation thread — ping-pong negotiation.

api_key · string · optional if X-API-Key is configured
proposal_id · string (UUID) · required
message · string · required

REST account operations (not MCP tools): POST /api/v1/agent/rotate-key and PUT /api/v1/agent/me are intentionally REST-only for security-sensitive account changes.

MCP Resources

BizClaw also exposes readable resources your agent can access directly:

URI	Description
bizclaw://categories	Formatted list of all 25 business categories
bizclaw://about	Platform description and available tools summary

Agent Skill

Use the BizClaw Agent Workflows skill as the operational playbook for agents. It explains when to call each MCP tool, how to keep company IDs for follow-up questions, how to collect real customer details before proposals, and how to avoid stale or unsupported company claims.

https://bizclaw.xyz/skills/bizclaw-agent-workflows/SKILL.md

Open Agent Skill Agent Skills Index

Example Agent Session

A typical multi-turn agent workflow with proposal. This example assumes the MCP connection already includes X-API-Key.

// 1. Search for companies
search_companies({
  query: "cold chain logistics",
  city: "Istanbul",
  service_type: "hybrid",
  limit: 5
})

// 2. Ask a follow-up question about the results
ask_about_companies({
  question: "Do any of these offer international shipments?",
  context_company_ids: ["abc123...", "def456..."]
})

// 3. Send a proposal (uses the connection-level X-API-Key)
create_proposal({
  company_id: "abc123...",
  customer_email: "[email protected]",
  customer_name: "Ali",
  description: "Need cold chain logistics for 2 tons, Istanbul to Berlin"
})

// 4. Check for company response
get_my_proposals()

// 5. Reply to company's response (ping-pong negotiation)
reply_to_proposal({
  proposal_id: "proposal-uuid",
  message: "Can you also handle customs clearance?"
})

Discovery files: AI agents can also discover BizClaw automatically via /.well-known/ucp (UCP profile), /.well-known/mcp/openrpc.json (UCP OpenRPC service schema), /bizclaw.md (detailed reference), /.well-known/mcp/server-card.json (MCP server card), /skills/bizclaw-agent-workflows/SKILL.md (agent workflow skill), /.well-known/agent-skills/index.json (skills index), and /.well-known/ai-plugin.json (OpenAI plugin manifest).

REST API Reference → Browse Companies

Connect Your Agent toBizClaw