BizClaw Business Directory MCP
Server Details
Search, compare, and contact real-world companies through a public MCP business directory.
- Status
- Healthy
- Uptime
- 95.5% over the last 24 hours
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-11-25
- URL
- ChatGPT
- –
- Claude
- –
TDQS
Scored across 9 tools
Most tools target clearly distinct actions: searching, retrieving company details, creating proposals, and replying. The main potential confusion is between search_companies and ask_about_companies, and between create_proposal and create_batch_proposals, but their descriptions clarify the intended use cases well.
Tool names mostly follow a consistent snake_case verb_noun pattern like search_companies, get_company, create_proposal, and reply_to_proposal. ask_about_companies deviates slightly from the pattern but is still readable and predictable.
Nine tools is well-scoped for a business directory MCP server covering discovery, company lookup, and proposal management. Each tool has a distinct role and no tool feels redundant or unnecessary.
The tool surface covers the core workflow well: search companies, get details, create proposals individually or in batch, list proposals, and reply to company responses. Minor gaps exist—such as no explicit cancel/update proposal or direct proposal-by-ID lookup—but these are not blocking for typical usage.
Available Tools
9 toolsask_about_companiesAsk About CompaniesAInspect
Ask a natural language question about companies and get AI-powered recommendations.
Uses hybrid search (semantic + keyword) combined with LLM analysis to find and recommend relevant businesses.
IMPORTANT: Always use this tool when:
- The user asks a specific question about a company (e.g., "do they offer bargaining?", "what are their prices?", "do they deliver to X?")
- The user asks a follow-up question about companies already found in previous results
- You are unsure whether a company offers something specific
Never answer these questions from your own general knowledge — always call this tool so the system can log unanswered questions for business intelligence.
Args:
question: Natural language question (e.g. "Which logistics companies offer cold chain delivery in Istanbul?")
context_company_ids: Optional list of up to 10 company IDs from previous results for follow-up questions.
ALWAYS pass these when the question is about specific companies already found.
Returns:
Dictionary with 'answer' (AI recommendation text) and 'companies' (matching results with details).
Inputs: question (required), meta, context_company_ids. Returns: object
create_batch_proposalsCreate Batch ProposalsAInspect
Create proposals to multiple companies at once (max 10).
Same proposal is sent to each company.
Args:
api_key: Your agent API key (starts with 'bzcl_sk_')
company_ids: List of company UUIDs (max 10, must be verified)
customer_email: Email of the end customer
customer_name: Name of the end customer
description: What the customer needs
proposal_type: 'standard' or 'custom' (default: 'custom')
Returns:
List of created proposals and any errors.
Inputs: company_ids (required), description (required), customer_name (required), customer_email (required), +3 more. Returns: object
create_proposalCreate ProposalAInspect
Create a proposal/quote request to a verified company on behalf of a customer.
Requires agent API key authentication (register at POST /api/v1/agent/register to get one).
Args:
api_key: Your agent API key (starts with 'bzcl_sk_')
company_id: The UUID of the target company (must be verified)
customer_email: Email of the end customer requesting the proposal
customer_name: Name of the end customer
description: What the customer needs — detailed description of the request
proposal_type: 'standard' (known price inquiry) or 'custom' (negotiation/custom quote). Default: 'custom'
Returns:
Created proposal with ID, status, and company info.
Inputs: company_id (required), description (required), customer_name (required), customer_email (required), +3 more. Returns: object
get_companyGet CompanyARead-onlyIdempotentInspect
Get full details for a specific company by its ID.
Returns the complete company profile including features, use cases, pricing, and contact info.
Args:
company_id: The UUID of the company (obtained from search results)
Returns:
Complete company profile dictionary, or an error if not found.
Inputs: company_id (required), meta. Returns: object
get_company_by_websiteGet Company by WebsiteARead-onlyIdempotentInspect
Look up a company by its website URL.
Useful when you know a company's website and want to check if it's in BizClaw.
Args:
website_url: The company's website URL (e.g. "https://example.com" or "example.com")
Returns:
Company profile if found, or an error message.
Inputs: website_url (required), meta. Returns: object
get_my_proposalsGet My ProposalsARead-onlyIdempotentInspect
Get all proposals created by the current agent.
Use this to check proposal status and company responses.
Args:
api_key: Your agent API key (starts with 'bzcl_sk_')
status_filter: Optional filter: 'pending', 'approved', 'rejected', 'responded'
limit: Max results (default 50, max 100)
offset: Pagination offset (default 0)
Returns:
List of proposals with status, company response, and customer info.
Inputs: meta, limit, offset, api_key, +1 more. Returns: object
list_categoriesList CategoriesARead-onlyIdempotentInspect
List all available business categories in BizClaw.
Use these category names to filter search results.
Returns:
Dictionary with 'categories' list and 'total' count.
Inputs: meta. Returns: object
reply_to_proposalReply to ProposalAInspect
Reply to a company's response on a proposal. Use this for back-and-forth negotiation.
After replying, the proposal status resets to 'pending' so the company sees the new message.
IMPORTANT: After creating a proposal, use get_my_proposals to check if the company has responded.
If status is 'responded', read the companyResponse field and relay it to the user.
If the user wants to reply, use this tool.
Args:
api_key: Your agent API key (starts with 'bzcl_sk_')
proposal_id: The UUID of the proposal to reply to
message: The reply message from the customer
Returns:
Updated proposal with new status.
Inputs: message (required), proposal_id (required), meta, api_key. Returns: object
search_companiesSearch CompaniesARead-onlyIdempotentInspect
Search for companies in the BizClaw business directory.
Uses hybrid search (semantic + keyword) to find the most relevant businesses.
Returns lightweight summaries to save tokens. Use get_company(id) for full details (contact, pricing, features, etc.).
Args:
query: Natural language search query (e.g. "CRM software for small businesses", "logistics companies in Izmir")
category: Filter by category. Use list_categories to see available options.
country: Filter by country (e.g. "Turkey", "United States", "Germany")
city: Filter by city (e.g. "Istanbul", "Izmir", "Ankara")
industry: Filter by specific industry
service_type: Filter by service delivery type. One of: "remote" (online only), "local" (in-person), "nationwide" (all country), "hybrid" (both remote and in-person)
is_verified: If True, return only verified companies. If False, return only unverified. Omit to return all.
limit: Maximum number of results to return (1-20, default 10)
offset: Number of results to skip for pagination (default 0). Use with limit to get next pages.
Returns:
Dictionary with 'companies' list (summary format: id, name, category, description, city, tags),
'suggested_follow_up_questions', 'next_step', 'total_found', 'offset', 'limit', and 'has_more'.
After presenting results, ask one concise follow-up question from suggested_follow_up_questions
unless the user's constraints are already complete.
Inputs: query (required), city, meta, limit, +6 more. Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Discover and query every business on ANOTS — search, ask, or find-and-ask over MCP.
Search and compare businesses worldwide by category and city; AI-visibility data and lead capture.
Search 33,000+ MCP servers by job, see safety grades and reviews, and call them from one endpoint.
Discover, hire, and verify real-world physical capability through MCP.
Related MCP Servers
- AlicenseAqualityBmaintenanceEnables AI agents to discover and enrich real-time B2B company data, including contact details, ratings, websites, and emails, through MCP-compatible clients.544 npmMIT
- AlicenseAqualityBmaintenanceCountry-agnostic MCP-callable directory for AI agents to find local SMBs — realtors, insurance agents, medical practitioners — by category, location, or natural-language query. Returns business catalog data and UTM-tagged booking URLs (zero PII).5MIT
- FlicenseNot gradedqualityDmaintenanceBizClaw is a hosted remote MCP server for AI agents to discover, search, compare, and interact with real-world companies through a business directory.-
- AlicenseNot gradedqualityCmaintenanceProvides read-only MCP access to The Between's verified company map, letting assistants search companies and verified matches, retrieve claim info, and query the live census data.MIT
Glama MCP Gateway
Add one secure layer between your agents and this server.