
Agent Broker
This is the missing API layer for the 60 million small businesses that don't have one. It exposes 14 operations over MCP to let agents find, verify, message, and book appointments with barbers, plumbers, and accountants through whatever channel actually reaches them: Cal.com, SMS, voice AI, email, or web form fallback. Every write operation costs USDC on Base via x402 payment rails, so agents pay per call without API keys or signup. The compliance layer is non-bypassable and blocks TCPA/GDPR violations before they go out. Reach for this when your agent needs to schedule a haircut or get a roofing quote and you don't want to scrape booking sites or cold call by voice.
- tools
- 23
- auth
- Secret needed
- transport
- HTTP
- last updated
- Sep 6, 2026
Install
From registry metadata$ npx add-mcp https://hatchloop.dev/mcp/agent-broker --name agentbroker --header 'X-Agent-Identity: ${X_AGENT_IDENTITY}'Run in your terminal. add-mcp asks which agents to add it to, then asks for each value it needs. Add -g to install it for every project.
Review the command, arguments and environment values before installing. MCP servers run with your local permissions.
Other ways
Claude Code
$ claude mcp add --transport http agentbroker https://hatchloop.dev/mcp/agent-broker --header 'X-Agent-Identity: YOUR_X_AGENT_IDENTITY'Run in your terminal. Add --scope user to make it available in every project.
Tools
Verified live · 23 toolsVerified live against the running server on Nov 6, 2026.
find_businessFind real businesses near a place, sorted by distance (nearest of those examined; see result.search). Data: OpenStreetMap (ODbL, (c) OSM contributors); phone, website, hours only when mapped. Coverage varies; community-mapped, NOT verified by us; source=openstreetmap rows cann...8 params
Find real businesses near a place, sorted by distance (nearest of those examined; see result.search). Data: OpenStreetMap (ODbL, (c) OSM contributors); phone, website, hours only when mapped. Coverage varies; community-mapped, NOT verified by us; source=openstreetmap rows cann...
availability_windowobjectcapabilitystringcitystringlocation*objectmax_resultsintegerprice_bandobjectregionstringverticalstringpersonal_services · home_services · professional_servicesverify_businessLook up what we know about a business in our supply network: contact channels, capabilities, last verification. A DIRECTORY LOOKUP - it does not contact the business. Supply-network ids only, not osm:... ids. [free, no key] [limited]2 params
Look up what we know about a business in our supply network: contact channels, capabilities, last verification. A DIRECTORY LOOKUP - it does not contact the business. Supply-network ids only, not osm:... ids. [free, no key] [limited]
capability_to_verifystringsmb_id*stringsend_messageSend a message on behalf of an agent's user or an SMB across WhatsApp (free during launch), SMS, email, or voice, sent immediately, no scheduling. Every send passes a non-bypassable gate: TCPA, GDPR, CASL where modeled, else the service's own opt-in default (the Gulf included)...7 params
Send a message on behalf of an agent's user or an SMB across WhatsApp (free during launch), SMS, email, or voice, sent immediately, no scheduling. Every send passes a non-bypassable gate: TCPA, GDPR, CASL where modeled, else the service's own opt-in default (the Gulf included)...
business_idstringcontent*objectidempotency_keystringmessage_type*stringtransactional · marketing · reminder · follow_up · notificationon_behalf_ofstringpreferred_channelstringwhatsapp · sms · email · voice · autodefault: autorecipient*objectcapture_leadStructured intake of a prospect into an SMB's funnel with validation and deduplication on (smb_id, phone or email). Stored in AgentBroker's own lead funnel, NOT the business's CRM; the business is not notified. [$0.05/per_call, not charged while no payment rail is on] [async→g...4 params
Structured intake of a prospect into an SMB's funnel with validation and deduplication on (smb_id, phone or email). Stored in AgentBroker's own lead funnel, NOT the business's CRM; the business is not notified. [$0.05/per_call, not charged while no payment rail is on] [async→g...
idempotency_keystringprospect*objectsmb_id*stringsourcestringschedule_appointmentCheck availability, book, or cancel via Cal.com. Only completes when the SMB's imported booking link is bound to this deployment's ONE connected Cal.com account; otherwise fails honestly (booking_destination_unmapped) with no charge. No working booking path exists yet for non-...8 params
Check availability, book, or cancel via Cal.com. Only completes when the SMB's imported booking link is bound to this deployment's ONE connected Cal.com account; otherwise fails honestly (booking_destination_unmapped) with no charge. No working booking path exists yet for non-...
action*stringbook · cancel · check_availabilitycustomerobjectexisting_appointment_idstringidempotency_keystringnotesstringrequested_timeobjectservicestringsmb_id*stringsend_transactional_confirmationIdempotent transactional messages: OTPs, booking confirmations, payment receipts, cancellation notices. Falls back across configured channels; an unconfigured channel fails honestly rather than reporting a delivery that did not happen. [$0.02/per_call, not charged while no pay...5 params
Idempotent transactional messages: OTPs, booking confirmations, payment receipts, cancellation notices. Falls back across configured channels; an unconfigured channel fails honestly rather than reporting a delivery that did not happen. [$0.02/per_call, not charged while no pay...
confirmation_type*stringotp · booking_confirmation · payment_receipt · cancellation_notice · reminderdata*objectidempotency_keystringpreferred_channelstringsms · email · autodefault: smsrecipient*objecthandle_inboundClassify an inbound message for an SMB and get a suggested_action for YOUR agent to act on. English keyword rules (booking request, cancellation, opt-out, inquiry, complaint): treat the intent as a hint. Opt-outs are recorded durably; nothing else is auto-routed or executed. [...7 params
Classify an inbound message for an SMB and get a suggested_action for YOUR agent to act on. English keyword rules (booking request, cancellation, opt-out, inquiry, complaint): treat the intent as a hint. Opt-outs are recorded durably; nothing else is auto-routed or executed. [...
idempotency_keystringinbound_channel*stringsms · email · voice_voicemail · web_form · apiraw_message*stringreceived_at_isostringrouting_rulesobjectsenderobjectsmb_id*stringescalate_to_humanHand off an in-flight task to a human operator with a context bundle (transcript, prior actions, identifiers, recommended next step). Writes a ticket to the operator queue; sends no notification, promises no response time. [$0.2/per_call, not charged while no payment rail is o...5 params
Hand off an in-flight task to a human operator with a context bundle (transcript, prior actions, identifiers, recommended next step). Writes a ticket to the operator queue; sends no notification, promises no response time. [$0.2/per_call, not charged while no payment rail is o...
context*objectidempotency_keystringprioritystringnormal · urgentdefault: normalreason*stringautomation_failed · customer_requested · compliance_hold · ambiguous_intent · exception_requiredsmb_id*stringget_statusQuery the current state of any in-flight async operation by operation_id. [free, no key]1 params
Query the current state of any in-flight async operation by operation_id. [free, no key]
operation_id*stringget_outcomeRetrieve the final OutcomeReceipt for a completed operation. [free, no key]1 params
Retrieve the final OutcomeReceipt for a completed operation. [free, no key]
operation_id*stringpreview_costReturn an expected cost estimate, latency estimate, and success-probability estimate for a proposed call before execution. Returns the exact price when it is fixed, and a min/max range when the cost depends on channel or outcome. It does not promise an accuracy percentage - ch...2 params
Return an expected cost estimate, latency estimate, and success-probability estimate for a proposed call before execution. Returns the exact price when it is fixed, and a min/max range when the cost depends on channel or outcome. It does not promise an accuracy percentage - ch...
operation*stringparams*objectself_testService health probe: runs 6 internal checks and reports how many passed. Confirms the server is up and responding - it does NOT probe each tool individually. Use to verify connectivity before production use. [free, no key]
Service health probe: runs 6 internal checks and reports how many passed. Confirms the server is up and responding - it does NOT probe each tool individually. Use to verify connectivity before production use. [free, no key]
No parameters. Call it with no arguments.
check_quotaReturns the caller's current quota state: how many operations have been used today, how many remain, the daily limit, the tier (free / credits / unlimited), and when the quota resets. Read-only and free. Works with any valid X-Agent-Identity token; returns tier='anonymous' for...
Returns the caller's current quota state: how many operations have been used today, how many remain, the daily limit, the tier (free / credits / unlimited), and when the quota resets. Read-only and free. Works with any valid X-Agent-Identity token; returns tier='anonymous' for...
No parameters. Call it with no arguments.
check_booking_linkFree, instant pre-flight check for a booking URL. Classifies which booking platform a URL belongs to and tells you whether import_booking_url will accept it, WITHOUT fetching the page or spending money. Returns the platform, the exact smb_id import_booking_url would assign, th...1 params
Free, instant pre-flight check for a booking URL. Classifies which booking platform a URL belongs to and tells you whether import_booking_url will accept it, WITHOUT fetching the page or spending money. Returns the platform, the exact smb_id import_booking_url would assign, th...
url*stringimport_booking_urlTurn a public booking URL into a callable smb_id for send_message and capture_lead. But schedule_appointment only completes on Cal.com bound to our one connected account — the other 11 always fail schedule_appointment honestly, uncharged. Detects 12 platforms (Cal.com, Calendl...8 params
Turn a public booking URL into a callable smb_id for send_message and capture_lead. But schedule_appointment only completes on Cal.com bound to our one connected account — the other 11 always fail schedule_appointment honestly, uncharged. Detects 12 platforms (Cal.com, Calendl...
booking_url*stringbusiness_namestringcapabilitiesarraycontact_emailstringcontact_phonestringcountry_codestringidempotency_keystringverticalstringpersonal_services · home_services · professional_services · restaurants · retail · healthcarecall_business[UNAVAILABLE on this deployment: Voice calling is not enabled on this deployment yet: the outbound phone line has not been verified for placing calls.] Place a conversational voice-AI phone call to a business on a consumer's behalf; give a plain-language objective and it navig...8 params
[UNAVAILABLE on this deployment: Voice calling is not enabled on this deployment yet: the outbound phone line has not been verified for placing calls.] Place a conversational voice-AI phone call to a business on a consumer's behalf; give a plain-language objective and it navig...
business_phonestringcountry_codestringextract_fieldsarrayidempotency_keystringmax_duration_secondsintegerobjective*stringon_behalf_ofstringsmb_idstringcheck_complianceFree, instant pre-flight for the compliance gate: runs the SAME TCPA/GDPR/CASL/CAN-SPAM/10DLC checks as send_message and call_business, in preview mode -- nothing is sent, nothing changes. Tells you whether a send would be permitted before you pay, and if not, names the exact...6 params
Free, instant pre-flight for the compliance gate: runs the SAME TCPA/GDPR/CASL/CAN-SPAM/10DLC checks as send_message and call_business, in preview mode -- nothing is sent, nothing changes. Tells you whether a send would be permitted before you pay, and if not, names the exact...
channelstringsms · email · voicecontent*stringcountry_codestringmessage_typestringrecipient_id*stringstate_codestringverify_company_recordFree, live lookup of a company official registry record. Queries the GLEIF global LEI registry (primary, 2.6 million legal entities worldwide) and SEC EDGAR (US public companies) to return the official legal name, LEI, entity status, jurisdiction, registered address, and regis...3 params
Free, live lookup of a company official registry record. Queries the GLEIF global LEI registry (primary, 2.6 million legal entities worldwide) and SEC EDGAR (US public companies) to return the official legal name, LEI, entity status, jurisdiction, registered address, and regis...
countrystringleistringname*stringscreen_sanctionsFree screening of a name/entity (Latin or Arabic script) against sanctions lists: OFAC SDN (US Treasury), EU consolidated list (European Commission), UK Sanctions List (FCDO). THE UN CONSOLIDATED LIST IS NOT SCREENED -- no licence permits redistribution. Never fabricates a mat...3 params
Free screening of a name/entity (Latin or Arabic script) against sanctions lists: OFAC SDN (US Treasury), EU consolidated list (European Commission), UK Sanctions List (FCDO). THE UN CONSOLIDATED LIST IS NOT SCREENED -- no licence permits redistribution. Never fabricates a mat...
countrystringname*stringtypestringperson · entitymap_trade_restrictionFree cross-border screening of destination and parties: DOES NOT CLASSIFY THE PRODUCT: echoed back, never checked against export-control lists, so a controlled item to an unrestricted destination returns 'partial', never 'clear'. Not an export-control clearance -- classify HS/...5 params
Free cross-border screening of destination and parties: DOES NOT CLASSIFY THE PRODUCT: echoed back, never checked against export-control lists, so a controlled item to an unrestricted destination returns 'partial', never 'clear'. Not an export-control clearance -- classify HS/...
destination_country*stringhs_codestringorigin_countrystringpartiesarrayproduct*stringget_conversationRead a two-way conversation thread you started: its state, every message exchanged, and how many replies the business has sent. [free, requires key]3 params
Read a two-way conversation thread you started: its state, every message exchanged, and how many replies the business has sent. [free, requires key]
business_numberstringconversation_idstringreferencestringmint_keyMint a free-tier API key without email by signing agent_id + timestamp + nonce with the MACHINE_MINT_SECRET (HMAC-SHA256). Refused without that secret (invalid_request); not_configured if the operator has none set. No secret: use POST /keys/request. [free, no key] [limited]4 params
Mint a free-tier API key without email by signing agent_id + timestamp + nonce with the MACHINE_MINT_SECRET (HMAC-SHA256). Refused without that secret (invalid_request); not_configured if the operator has none set. No secret: use POST /keys/request. [free, no key] [limited]
agent_id*stringnonce*stringsignature*stringtimestamp*integerlookup_us_contractsSearch US federal contract awards by company (recipient) name using the free USASpending.gov public API. Returns the top awards sorted by dollar amount: award ID, recipient name, award amount USD, awarding agency, NAICS code/description, and period of performance. Zero upstrea...2 params
Search US federal contract awards by company (recipient) name using the free USASpending.gov public API. Returns the top awards sorted by dollar amount: award ID, recipient name, award amount USD, awarding agency, NAICS code/description, and period of performance. Zero upstrea...
company_name*stringmax_resultsintegerSponsors
Readme
Agent Broker - SMB Transaction & Communication MCP Server
An agent-callable MCP server that lets autonomous AI agents find, verify, message, schedule with, and transact with small and mid-sized businesses (SMBs) through a single compliance-enforced tool surface.
Details
- Repository
- github.com/basilalshukaili/agentbroker
- Website
- hatchloop.dev/agent-broker
- Categories
- AI & LLM Tools, Communication & Messaging
- Transport
- HTTP
- Auth
- Required
- Registry
- MCP registry, active
- Resources
- 5
- Prompts
- 4
- Tools verified
- Nov 6, 2026