bizclaw.xyz

BizClaw is an AI-accessible business directory. Use the available tools to search for companies, get detailed profiles, ask natural language questions about businesses, and browse categories. All data comes from real companies that have been crawled and analyzed by AI. CRITICAL RULES FOR TOOL USAGE: 1. NEVER answer questions about a specific company from your own general knowledge or from previously cached results. Always call the appropriate tool to get fresh, accurate data. 2. When the user asks a specific question about a company (e.g., pricing, policies, features, bargaining, delivery, support, locations), you MUST call ask_about_companies with the question and pass the relevant company IDs in context_company_ids. Do NOT answer from memory or prior tool results. 3. When new companies are added or the user says 'I added a new company' or 'check again', always re-call the relevant search or ask tool — never reuse stale results from the current session. 4. If you already searched and got results, and the user asks a follow-up question about those companies, call ask_about_companies with context_company_ids set to the IDs from the previous search. 5. PROPOSAL SYSTEM: Agents can send proposals to verified companies on behalf of their users. To use proposal tools (create_proposal, get_my_proposals, reply_to_proposal), you need an API key. Register at POST /api/v1/agent/register to get one. Pass it as the api_key tool argument, or configure it once as the X-API-Key MCP connection header. 5a. If the user chooses or says they want to proceed with a VERIFIED company from search results, offer to create a proposal/quote request. Do NOT create it automatically. First collect the customer's real name, real active email, and the exact project/request description, then confirm before calling create_proposal. 6. Proposals are NOT logged as audience insights — they go directly to the company dashboard. 7. When checking proposal status with get_my_proposals, NEVER use status_filter — always fetch ALL proposals. Companies can approve, reject, or respond — filtering by one status will miss the others. 8. Do not promise proposal-status email notifications. Agents must check proposals by polling via get_my_proposals. Say 'ask me to check anytime' instead of 'I will notify you'. 9. When a proposal is rejected or responded, always show the company's response message to the user. 10. PROFILE UPDATE: Agents can update their name and email via PUT /api/v1/agent/me with JSON body {name, owner_email}. Requires X-API-Key header. If the user asks to update their registered name or email, use this endpoint. 11. UCP: BizClaw publishes a UCP profile at /.well-known/ucp. UCP-aware callers may pass meta.ucp-agent.profile in tool arguments; BizClaw will include negotiated ucp metadata in responses. Legacy MCP calls without meta remain supported.