basilalshukaili avatar

Agent Broker

basilalshukaili/agentbroker

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 tools

Verified 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...

Parameters* required
availability_windowobject
Accepted but NOT APPLIED: it does not narrow results (no live calendars). The…
capabilitystring
Kind of business: 'dentist', 'cafe', 'plumber'. Use it or vertical.
citystring
Instead of location: a city, e.g. 'Muscat, Oman'.
location*object
City/town or ZIP, optionally with country ('Nizwa, Oman'). Geocoded by OSM.
max_resultsinteger
default: 5
price_bandobject
Supply-network rows only (OpenStreetMap has no prices).
regionstring
With city: a state or region.
verticalstring
one of personal_services · home_services · professional_services
verify_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]

Parameters* required
capability_to_verifystring
smb_id*string
send_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)...

Parameters* required
business_idstring
Stable id for the recipient business; used for global demand shaping.
content*object
idempotency_keystring
Retry key: a 24h replay returns the original receipt, not re-run or charged.
message_type*string
'marketing' needs recorded opt-in, except US email (CAN-SPAM opt-out rules).…one of transactional · marketing · reminder · follow_up · notification
on_behalf_ofstring
Who this message is FOR (your end-user's name/label). On WhatsApp this opens a…
preferred_channelstring
one of whatsapp · sms · email · voice · autodefault: auto
recipient*object
capture_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...

Parameters* required
idempotency_keystring
Retry key: a 24h replay returns the original receipt, not re-run or charged.
prospect*object
smb_id*string
sourcestring
Where the consumer-initiated request originated (e.g., 'consumer_request',…
schedule_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-...

Parameters* required
action*string
one of book · cancel · check_availability
customerobject
existing_appointment_idstring
Required for cancel
idempotency_keystring
Retry key: a 24h replay returns the original receipt, not re-run or charged.
notesstring
requested_timeobject
servicestring
smb_id*string
send_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...

Parameters* required
confirmation_type*string
one of otp · booking_confirmation · payment_receipt · cancellation_notice · reminder
data*object
Type-specific payload; e.g., {otp_code} for otp, {appointment_time, smb_name}…
idempotency_keystring
Retry key: a 24h replay returns the original receipt, not re-run or charged.
preferred_channelstring
one of sms · email · autodefault: sms
recipient*object
handle_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. [...

Parameters* required
idempotency_keystring
Retry key: a 24h replay returns the original receipt, not re-run or charged.
inbound_channel*string
one of sms · email · voice_voicemail · web_form · api
raw_message*string
received_at_isostring
routing_rulesobject
Optional override routing policy for this SMB
senderobject
smb_id*string
escalate_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...

Parameters* required
context*object
idempotency_keystring
Retry key: a 24h replay returns the original receipt, not re-run or charged.
prioritystring
one of normal · urgentdefault: normal
reason*string
one of automation_failed · customer_requested · compliance_hold · ambiguous_intent · exception_required
smb_id*string
get_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]

Parameters* required
operation_id*string
get_outcomeRetrieve the final OutcomeReceipt for a completed operation. [free, no key]1 params

Retrieve the final OutcomeReceipt for a completed operation. [free, no key]

Parameters* required
operation_id*string
preview_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...

Parameters* required
operation*string
params*object
The same request body you would pass to the operation
self_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...

Parameters* required
url*string
Full http(s) URL to classify, e.g. 'https://cal.com/jane' or…
import_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...

Parameters* required
booking_url*string
Full URL the user supplied. Must point at one of the 12 supported booking…
business_namestring
If omitted, auto-extracted from the page's <title> or og:title.
capabilitiesarray
Free-form capability tags (e.g., ['haircut','color','blowdry']).
contact_emailstring
contact_phonestring
If omitted, the platform integration handles outreach.
country_codestring
ISO 3166-1 alpha-2 (e.g. 'US', 'FR'); routes compliance on later sends.
idempotency_keystring
Retry key: a 24h replay returns the original receipt, not re-run or charged.
verticalstring
If omitted, inferred from the booking platform.one of personal_services · home_services · professional_services · restaurants · retail · healthcare
call_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...

Parameters* required
business_phonestring
Business phone in E.164 (e.g. +14045550123). Provide this OR smb_id.
country_codestring
ISO 3166-1 alpha-2 for compliance + recording-consent routing.
extract_fieldsarray
Structured fields to pull from the answer, e.g.…
idempotency_keystring
Retry key: a 24h replay returns the original receipt, not re-run or charged.
max_duration_secondsinteger
default: 180
objective*string
What the call should accomplish, in plain language.
on_behalf_ofstring
Name of the consumer the call is placed for.
smb_idstring
Known SMB identifier with a phone on record. Provide this OR business_phone.
check_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...

Parameters* required
channelstring
Delivery channel. Omit to auto-infer sms/email from recipient_id; set 'voice'…one of sms · email · voice
content*string
The actual message body you intend to send. The gate classifies the real text,…
country_codestring
ISO 3166-1 alpha-2 (e.g. 'US', 'DE', 'CA'). Auto-inferred from phone if…
message_typestring
One of transactional, marketing, reminder, follow_up, notification (any case).…default: transactional
recipient_id*string
Phone in E.164 (e.g. '+14045550100') or email address the message would go to.
state_codestring
US state code (e.g. 'CA') for state-specific rules.
verify_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...

Parameters* required
countrystring
Optional ISO 3166-1 alpha-2 country filter (e.g. US, DE, GB). Narrows GLEIF…
leistring
Optional 20-character Legal Entity Identifier for a direct, precise lookup.
name*string
Legal company name to look up, e.g. Apple Inc or Volkswagen AG.
screen_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...

Parameters* required
countrystring
Optional ISO 3166-1 alpha-2 country code or country name (e.g. 'IR', 'Iran').…
name*string
Name of the person or entity to screen, in Latin or Arabic script, e.g. 'Kim…
typestring
Optional entity type hint. 'person' for individuals, 'entity' for…one of person · entity
map_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/...

Parameters* required
destination_country*string
ISO 3166-1 alpha-2 code for the importing country (e.g. 'IR', 'CA', 'DE').…
hs_codestring
Optional Harmonized System code (e.g. '8471.30' for laptops). If provided,…
origin_countrystring
Optional ISO 3166-1 alpha-2 code for the exporting country (e.g. 'US', 'DE').…
partiesarray
Optional list of party names to screen (exporter, importer, freight forwarder,…
product*string
Product name or description, e.g. 'laptop computers', 'crude oil', 'medical…
get_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]

Parameters* required
business_numberstring
Scopes a `reference` to one business (references are reused across businesses).
conversation_idstring
From the send_message receipt (preferred).
referencestring
The 4-digit request reference, e.g. '4821'. Requires business_number.
mint_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]

Parameters* required
agent_id*string
A stable unique identifier for this agent (e.g. a UUID). The issued key is…
nonce*string
Random value (UUID or hex). Prevents replay attacks — use a fresh nonce each…
signature*string
HMAC-SHA256(agent_id + str(timestamp) + nonce, MACHINE_MINT_SECRET) as…
timestamp*integer
Unix epoch seconds at signing time. Must be within 60s of server time.
lookup_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...

Parameters* required
company_name*string
Company or recipient name to search for in US federal contract awards (e.g.…
max_resultsinteger
Maximum number of contract awards to return (sorted by award amount…default: 5

Sponsors

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.


View the full README on GitHub

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

Related AI & LLM Tools MCP servers

View all
1bch1212 avatarAgent Commerce Mcpbch1212/agent-commerce-mcpAgent Commerce MCP — agent-native A2A storefront. Discovery, Stripe checkout, affiliate program.0stars
2bernardjhuang avatarAgenttunebernardjhuang/agenttunePersonality tuning files for AI agents: 43 MIT-licensed tunings + 5 inline personality tests.0stars
3bounty-market avatarBountyMarketbounty-market/bountymarket-agent-toolsTask marketplace for AI agents and humans (Australia, AUD, online tasks).0stars
4callobuzz avatarcob-rag-mcpcallobuzz/cob-rag-mcpGive any MCP client a business's own knowledge base from a self-hosted cob-rag-engine.0stars
5markchiang avatarAgent Finmarkchiang/go-agentsAgent Fin: finance MCP server with market data tools0stars
6markchiang avatarAgent Ipmarkchiang/go-agentsAgent IP: MCP server with patents search tools0stars