Agent Broker

Measured conclusion: Alive, not deep-tested. L2 outcome: not_attempted.

23 MCP tools: compliance, verification, messaging, booking, US contracts. 15 need no key.

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "Agent Broker": {
      "url": "https://hatchloop.dev/mcp/agent-broker",
      "transport": "streamable-http"
    }
  }
}

Measured tools (23)

• find_business read-only

  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 cannot be booked. Answers within about 5 s: status partial (search_in_progress) means repeat the call. If OSM is down: retriable 'temporarily unavailable', never invented rows. [free, no key] [beta]

  Parameters:

  • location (required) — object — City/town or ZIP, optionally with country ('Nizwa, Oman'). Geocoded by OSM.
  • city — string — Instead of location: a city, e.g. 'Muscat, Oman'.
  • region — string — With city: a state or region.
  • vertical — string
  • capability — string — Kind of business: 'dentist', 'cafe', 'plumber'. Use it or vertical.
  • price_band — object — Supply-network rows only (OpenStreetMap has no prices).
  • max_results — integer
  • availability_window — object — Accepted but NOT APPLIED: it does not narrow results (no live calendars). The…

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• verify_business read-only

  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:

  • smb_id (required) — string
  • capability_to_verify — string

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• send_message destructive

  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). Marketing on SMS, voice, WhatsApp and non-US email without recorded opt-in is rejected (compliance_violation receipt). US marketing email follows CAN-SPAM opt-out rules. [from $0.02/call, variable, not charged while no payment rail is on] [async→get_outcome] [Not available on this deployment: SMS, Voice.]

  Parameters:

  • recipient (required) — object
  • message_type (required) — string — 'marketing' needs recorded opt-in, except US email (CAN-SPAM opt-out rules).…
  • content (required) — object
  • business_id — string — Stable id for the recipient business; used for global demand shaping.
  • on_behalf_of — string — Who this message is FOR (your end-user's name/label). On WhatsApp this opens a…
  • idempotency_key — string — Retry key: a 24h replay returns the original receipt, not re-run or charged.
  • preferred_channel — string

  Hints: read-only no · destructive yes · idempotent no · open-world yes

• capture_lead

  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→get_outcome] [beta]

  Parameters:

  • smb_id (required) — string
  • prospect (required) — object
  • source — string — Where the consumer-initiated request originated (e.g., 'consumer_request',…
  • idempotency_key — string — Retry key: a 24h replay returns the original receipt, not re-run or charged.

  Hints: read-only no · destructive no · idempotent no · open-world no

• schedule_appointment destructive

  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-Cal.com platforms (voice AI, web form) — those SMBs fail honestly instead of a fabricated confirmation. [from $0.15/call, variable, not charged while no payment rail is on] [async→get_outcome] [limited]

  Parameters:

  • smb_id (required) — string
  • action (required) — string
  • notes — string
  • service — string
  • customer — object
  • requested_time — object
  • idempotency_key — string — Retry key: a 24h replay returns the original receipt, not re-run or charged.
  • existing_appointment_id — string — Required for cancel

  Hints: read-only no · destructive yes · idempotent no · open-world yes

• send_transactional_confirmation destructive

  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 payment rail is on] [async→get_outcome] [Not available on this deployment: SMS.]

  Parameters:

  • recipient (required) — object
  • confirmation_type (required) — string
  • data (required) — object — Type-specific payload; e.g., {otp_code} for otp, {appointment_time, smb_name}…
  • idempotency_key — string — Retry key: a 24h replay returns the original receipt, not re-run or charged.
  • preferred_channel — string

  Hints: read-only no · destructive yes · idempotent no · open-world no

• handle_inbound

  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. [$0.03/per_call, not charged while no payment rail is on] [async→get_outcome] [beta]

  Parameters:

  • smb_id (required) — string
  • inbound_channel (required) — string
  • raw_message (required) — string
  • sender — object
  • routing_rules — object — Optional override routing policy for this SMB
  • idempotency_key — string — Retry key: a 24h replay returns the original receipt, not re-run or charged.
  • received_at_iso — string

  Hints: read-only no · destructive no · idempotent no · open-world no

• escalate_to_human destructive

  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 on] [async→get_outcome] [beta]

  Parameters:

  • smb_id (required) — string
  • reason (required) — string
  • context (required) — object
  • priority — string
  • idempotency_key — string — Retry key: a 24h replay returns the original receipt, not re-run or charged.

  Hints: read-only no · destructive yes · idempotent no · open-world no

• get_status read-only

  Query the current state of any in-flight async operation by operation_id. [free, no key]

  Parameters:

  • operation_id (required) — string

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_outcome read-only

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

  Parameters:

  • operation_id (required) — string

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• preview_cost read-only

  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 - check cost_range. [free, no key]

  Parameters:

  • operation (required) — string
  • params (required) — object — The same request body you would pass to the operation

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• self_test read-only

  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]

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• check_quota read-only

  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 keyless callers with the anonymous daily limits. [free, no key]

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• check_booking_link read-only

  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, the channels the booking will route through, and the inferred country. Use it to de-risk a paid booking BEFORE calling import_booking_url + schedule_appointment. [free, no key]

  Parameters:

  • url (required) — string — Full http(s) URL to classify, e.g. 'https://cal.com/jane' or…

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• import_booking_url

  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, Calendly, Doctolib, Booksy, Fresha, OpenTable, Setmore, Square, Acuity, Schedulista, Squarespace, BookMyCity). Idempotent — calling twice returns the same smb_id. [free, requires key] [limited]

  Parameters:

  • booking_url (required) — string — Full URL the user supplied. Must point at one of the 12 supported booking…
  • vertical — string — If omitted, inferred from the booking platform.
  • capabilities — array — Free-form capability tags (e.g., ['haircut','color','blowdry']).
  • country_code — string — ISO 3166-1 alpha-2 (e.g. 'US', 'FR'); routes compliance on later sends.
  • business_name — string — If omitted, auto-extracted from the page's <title> or og:title.
  • contact_email — string
  • contact_phone — string — If omitted, the platform integration handles outreach.
  • idempotency_key — string — Retry key: a 24h replay returns the original receipt, not re-run or charged.

  Hints: read-only no · destructive no · idempotent yes · open-world no

• call_business destructive

  [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 navigates the call, extracting the answer. Business-directed (B2B), far less restricted than calling consumers — but the compliance gate still enforces recording consent per jurisdiction. [$0.2/per_call, not charged while no payment rail is on] [async→get_outcome]

  Parameters:

  • objective (required) — string — What the call should accomplish, in plain language.
  • smb_id — string — Known SMB identifier with a phone on record. Provide this OR business_phone.
  • country_code — string — ISO 3166-1 alpha-2 for compliance + recording-consent routing.
  • on_behalf_of — string — Name of the consumer the call is placed for.
  • business_phone — string — Business phone in E.164 (e.g. +14045550123). Provide this OR smb_id.
  • extract_fields — array — Structured fields to pull from the answer, e.g.…
  • idempotency_key — string — Retry key: a 24h replay returns the original receipt, not re-run or charged.
  • max_duration_seconds — integer

  Hints: read-only no · destructive yes · idempotent no · open-world yes

• check_compliance read-only

  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 rule and how to fix it. De-risks a paid send the way check_booking_link de-risks a paid booking. [free, no key]

  Parameters:

  • recipient_id (required) — string — Phone in E.164 (e.g. '+14045550100') or email address the message would go to.
  • content (required) — string — The actual message body you intend to send. The gate classifies the real text,…
  • channel — string — Delivery channel. Omit to auto-infer sms/email from recipient_id; set 'voice'…
  • state_code — string — US state code (e.g. 'CA') for state-specific rules.
  • country_code — string — ISO 3166-1 alpha-2 (e.g. 'US', 'DE', 'CA'). Auto-inferred from phone if…
  • message_type — string — One of transactional, marketing, reminder, follow_up, notification (any case).…

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• verify_company_record read-only

  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 registry authority. Never fabricates: if the company is not found in these free registries, returns an honest not_found with the sources that were queried. [free, no key]

  Parameters:

  • name (required) — string — Legal company name to look up, e.g. Apple Inc or Volkswagen AG.
  • lei — string — Optional 20-character Legal Entity Identifier for a direct, precise lookup.
  • country — string — Optional ISO 3166-1 alpha-2 country filter (e.g. US, DE, GB). Narrows GLEIF…

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• screen_sanctions read-only

  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 match or clear: check lists_screened; reason_code 'partial_screening' (never 'clear') if any source failed. [free, no key]

  Parameters:

  • name (required) — string — Name of the person or entity to screen, in Latin or Arabic script, e.g. 'Kim…
  • type — string — Optional entity type hint. 'person' for individuals, 'entity' for…
  • country — string — Optional ISO 3166-1 alpha-2 country code or country name (e.g. 'IR', 'Iran').…

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• map_trade_restriction read-only

  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/ECCN yourself. Never fabricates a tariff rate, a clear, or a restricted status. [free, no key]

  Parameters:

  • product (required) — string — Product name or description, e.g. 'laptop computers', 'crude oil', 'medical…
  • destination_country (required) — string — ISO 3166-1 alpha-2 code for the importing country (e.g. 'IR', 'CA', 'DE').…
  • hs_code — string — Optional Harmonized System code (e.g. '8471.30' for laptops). If provided,…
  • parties — array — Optional list of party names to screen (exporter, importer, freight forwarder,…
  • origin_country — string — Optional ISO 3166-1 alpha-2 code for the exporting country (e.g. 'US', 'DE').…

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_conversation read-only

  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:

  • reference — string — The 4-digit request reference, e.g. '4821'. Requires business_number.
  • business_number — string — Scopes a `reference` to one business (references are reused across businesses).
  • conversation_id — string — From the send_message receipt (preferred).

  Hints: read-only yes · destructive no · idempotent no · open-world no

• mint_key

  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:

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

  Hints: read-only no · destructive no · idempotent no · open-world no

• lookup_us_contracts read-only

  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 upstream cost, no key required. Data covers 2020-2026 procurement contracts. [free, no key]

  Parameters:

  • company_name (required) — string — Company or recipient name to search for in US federal contract awards (e.g.…
  • max_results — integer — Maximum number of contract awards to return (sorted by award amount…

  Hints: read-only yes · destructive no · idempotent yes · open-world no

Publisher website Repository

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.