MCPサーバー

Agent Broker

dev.hatchloop/agent-broker

このMCPでできること

Finds and verifies businesses, captures leads, sends compliant messages, places calls, and schedules appointments.

call_business
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] [async→get_outcome]
破壊的操作あり 外部アクセスあり
入力スキーマ
{'type': 'object', 'required': ['objective'], 'properties': {'smb_id': {'type': 'string', 'description': 'Known SMB identifier with a phone on record. Provide this OR business_phone.'}, 'objective': {'type': 'string', 'description': 'What the call should accomplish, in plain language.'}, 'country_code': {'type': 'string', 'description': 'ISO 3166-1 alpha-2 for compliance + recording-consent routing.'}, 'on_behalf_of': {'type': 'string', 'description': 'Name of the consumer the call is placed for.'}, 'business_phone': {'type': 'string', 'description': 'Business phone in E.164 (e.g. +14045550123). Provide this OR smb_id.'}, 'extract_fields': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Structured fields to pull from the answer, e.g.…'}, 'idempotency_key': {'type': 'string', 'maxLength': 128, 'description': 'Retry key: a 24h replay returns the original receipt, not re-run or charged.'}, 'max_duration_seconds': {'type': 'integer', 'default': 180, 'maximum': 600}}}
capture_lead
Structured intake of a prospect into an SMB's funnel with validation and deduplication on (smb_id, phone or email). Stores the prospect in the SMB's AgentBroker lead funnel — this is AgentBroker's own lead store, NOT a write into the business's own CRM. [$0.05/per_call] [async→get_outcome]
入力スキーマ
{'type': 'object', 'required': ['smb_id', 'prospect'], 'properties': {'smb_id': {'type': 'string'}, 'source': {'type': 'string', 'description': "Where the consumer-initiated request originated (e.g., 'consumer_request',…"}, 'prospect': {'type': 'object', 'required': ['name'], 'properties': {'name': {'type': 'string'}, 'email': {'type': 'string', 'format': 'email'}, 'notes': {'type': 'string'}, 'phone': {'type': 'string'}, 'service_interest': {'type': 'string'}, 'consent_record_id': {'type': 'string', 'description': "Optional ID of a consent record proving the prospect asked to be contacted (e.g., they filled an SMB's intake form or requested a quote). Required when downstream send_message calls are anticipated."}}}, 'idempotency_key': {'type': 'string', 'maxLength': 128, 'description': 'Retry key: a 24h replay returns the original receipt, not re-run or charged.'}}}
check_booking_link
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]
読み取り専用 冪等
入力スキーマ
{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'description': "Full http(s) URL to classify, e.g. 'https://cal.com/jane' or…"}}}
check_compliance
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]
読み取り専用 冪等
入力スキーマ
{'type': 'object', 'required': ['recipient_id', 'content'], 'properties': {'channel': {'enum': ['sms', 'email', 'voice'], 'type': 'string', 'description': "Delivery channel. Omit to auto-infer sms/email from recipient_id; set 'voice'…"}, 'content': {'type': 'string', 'description': 'The actual message body you intend to send. The gate classifies the real text,…'}, 'state_code': {'type': 'string', 'description': "US state code (e.g. 'CA') for state-specific rules."}, 'country_code': {'type': 'string', 'description': "ISO 3166-1 alpha-2 (e.g. 'US', 'DE', 'CA'). Auto-inferred from phone if…"}, 'message_type': {'type': 'string', 'default': 'transactional', 'description': 'Intent tag: transactional, marketing, reminder, follow_up, notification.…'}, 'recipient_id': {'type': 'string', 'description': "Phone in E.164 (e.g. '+14045550100') or email address the message would go to."}}}
check_quota
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]
読み取り専用 冪等
入力スキーマ
{'type': 'object', 'required': [], 'properties': {}}
escalate_to_human
Hand off an in-flight task to a human operator with a full context bundle: transcript, prior actions, identifiers, and a recommended next step. [$0.2/per_call] [async→get_outcome]
破壊的操作あり
入力スキーマ
{'type': 'object', 'required': ['smb_id', 'reason', 'context'], 'properties': {'reason': {'enum': ['automation_failed', 'customer_requested', 'compliance_hold', 'ambiguous_intent', 'exception_required'], 'type': 'string'}, 'smb_id': {'type': 'string'}, 'context': {'type': 'object', 'properties': {'transcript': {'type': 'array', 'items': {'type': 'object'}}, 'operation_id': {'type': 'string'}, 'prior_actions': {'type': 'array', 'items': {'type': 'object'}}, 'original_operation': {'type': 'string'}, 'recommended_next_step': {'type': 'string'}}}, 'priority': {'enum': ['normal', 'urgent'], 'type': 'string', 'default': 'normal'}, 'idempotency_key': {'type': 'string', 'maxLength': 128, 'description': 'Retry key: a 24h replay returns the original receipt, not re-run or charged.'}}}
find_business
Find real businesses near a place, sorted by distance (nearest of those examined; dense areas are narrowed, see result.search). Data: OpenStreetMap (ODbL, (c) OpenStreetMap contributors, attributed per result); phone, website, hours only when mapped. Coverage varies; community-mapped, NOT verified by us; source=openstreetmap rows cannot be booked. Plus supply-network rows. If OSM is down: retriable 'temporarily unavailable', never invented rows. [free, no key]
読み取り専用 冪等
入力スキーマ
{'type': 'object', 'required': ['vertical', 'location'], 'properties': {'city': {'type': 'string', 'description': 'Alternative to location: a top-level city, normalised into…'}, 'region': {'type': 'string', 'description': 'Alternative to location: a top-level state/region, normalised into…'}, 'location': {'type': 'object', 'required': ['zip_or_city'], 'properties': {'zip_or_city': {'type': 'string', 'description': "City, town, address or postal code, optionally with the country, e.g. 'Nizwa, Oman'. A bare 5-digit ZIP is read as a US ZIP; give any non-US postal code with its country (e.g. '10115, Germany')."}, 'radius_miles': {'type': 'number', 'minimum': 0, 'description': 'Radius in miles (default 3.1, max 25); applies to OpenStreetMap results only.'}}, 'description': "City/town or ZIP, optionally with country ('Nizwa, Oman'). Geocoded by OSM."}, 'vertical': {'enum': ['personal_services', 'home_services', 'professional_services'], 'type': 'string'}, 'capability': {'type': 'string', 'description': "Kind of business, e.g. 'haircut', 'plumber', 'dentist'. Mapped to OSM tags."}, 'price_band': {'type': 'object', 'properties': {'max_usd': {'type': 'number'}}, 'description': 'Supply-network rows only; OpenStreetMap has no prices.'}, 'max_results': {'type': 'integer', 'default': 5, 'maximum': 20, 'minimum': 1}, 'availability_window': {'type': 'object', 'properties': {'end_iso': {'type': 'string', 'format': 'date-time'}, 'start_iso': {'type': 'string', 'format': 'date-time'}}, 'description': 'Accepted but NOT APPLIED - it does not narrow results. We do not hold live…'}}}
get_conversation
Read a two-way conversation thread you started: its state, every message exchanged, and how many replies the business has sent. [free, requires key]
読み取り専用
入力スキーマ
{'type': 'object', 'properties': {'reference': {'type': 'string', 'description': "The 4-digit request reference, e.g. '4821'. Requires business_number."}, 'business_number': {'type': 'string', 'description': 'Scopes a `reference` to one business (references are reused across businesses).'}, 'conversation_id': {'type': 'string', 'description': 'From the send_message receipt (preferred).'}}}
get_outcome
Retrieve the final OutcomeReceipt for a completed operation. [free, no key]
読み取り専用 冪等
入力スキーマ
{'type': 'object', 'required': ['operation_id'], 'properties': {'operation_id': {'type': 'string'}}}
get_status
Query the current state of any in-flight async operation by operation_id. [free, no key]
読み取り専用 冪等
入力スキーマ
{'type': 'object', 'required': ['operation_id'], 'properties': {'operation_id': {'type': 'string'}}}
handle_inbound
Classify an inbound message on behalf of an SMB and get a recommended next action. Classifies intent (booking request, cancellation, opt-out, inquiry, complaint) and returns a suggested_action for YOUR agent to act on - opt-outs are recorded durably; nothing else is auto-routed or auto-executed by this tool. [$0.03/per_call] [async→get_outcome]
入力スキーマ
{'type': 'object', 'required': ['smb_id', 'inbound_channel', 'raw_message'], 'properties': {'sender': {'type': 'object', 'properties': {'name': {'type': 'string'}, 'email': {'type': 'string'}, 'phone': {'type': 'string'}}}, 'smb_id': {'type': 'string'}, 'raw_message': {'type': 'string'}, 'routing_rules': {'type': 'object', 'description': 'Optional override routing policy for this SMB'}, 'idempotency_key': {'type': 'string', 'maxLength': 128, 'description': 'Retry key: a 24h replay returns the original receipt, not re-run or charged.'}, 'inbound_channel': {'enum': ['sms', 'email', 'voice_voicemail', 'web_form', 'api'], 'type': 'string'}, 'received_at_iso': {'type': 'string', 'format': 'date-time'}}}
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]
冪等
入力スキーマ
{'type': 'object', 'required': ['booking_url'], 'properties': {'vertical': {'enum': ['personal_services', 'home_services', 'professional_services', 'restaurants', 'retail', 'healthcare', 'fitness'], 'type': 'string', 'description': 'If omitted, inferred from the booking platform.'}, 'booking_url': {'type': 'string', 'format': 'uri', 'description': 'Full URL the user supplied. Must point at one of the 12 supported booking…'}, 'capabilities': {'type': 'array', 'items': {'type': 'string'}, 'description': "Free-form capability tags (e.g., ['haircut','color','blowdry'])."}, 'country_code': {'type': 'string', 'description': "ISO 3166-1 alpha-2 (e.g. 'US', 'FR'); routes compliance on later sends."}, 'business_name': {'type': 'string', 'description': "If omitted, auto-extracted from the page's <title> or og:title."}, 'contact_email': {'type': 'string'}, 'contact_phone': {'type': 'string', 'description': 'If omitted, the platform integration handles outreach.'}, 'idempotency_key': {'type': 'string', 'maxLength': 128, 'description': 'Retry key: a 24h replay returns the original receipt, not re-run or charged.'}}}
lookup_us_contracts
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]
読み取り専用 冪等
入力スキーマ
{'type': 'object', 'required': ['company_name'], 'properties': {'max_results': {'type': 'integer', 'default': 5, 'maximum': 10, 'minimum': 1, 'description': 'Maximum number of contract awards to return (sorted by award amount…'}, 'company_name': {'type': 'string', 'description': 'Company or recipient name to search for in US federal contract awards (e.g.…'}}}
map_trade_restriction
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 in quota, then $0.02/call]
読み取り専用 冪等
入力スキーマ
{'type': 'object', 'required': ['product', 'destination_country'], 'properties': {'hs_code': {'type': 'string', 'description': "Optional Harmonized System code (e.g. '8471.30' for laptops). If provided,…"}, 'parties': {'type': 'array', 'items': {'type': 'string'}, 'maxItems': 20, 'description': 'Optional list of party names to screen (exporter, importer, freight forwarder,…'}, 'product': {'type': 'string', 'description': "Product name or description, e.g. 'laptop computers', 'crude oil', 'medical…"}, 'origin_country': {'type': 'string', 'description': "Optional ISO 3166-1 alpha-2 code for the exporting country (e.g. 'US', 'DE').…"}, 'destination_country': {'type': 'string', 'description': "ISO 3166-1 alpha-2 code for the importing country (e.g. 'IR', 'CA', 'DE').…"}}}
mint_key
Agent self-serve API key issuance. An autonomous agent that has no email inbox can obtain a free-tier API key by proving it holds the MACHINE_MINT_SECRET via HMAC-SHA256. Returns a usable key immediately with no human action required. If the operator has not activated a mint secret on the server, this returns an honest not_configured failure rather than a key - call it once and branch on that before planning around it. [free, no key]
入力スキーマ
{'type': 'object', 'required': ['agent_id', 'timestamp', 'nonce', 'signature'], 'properties': {'nonce': {'type': 'string', 'description': 'Random value (UUID or hex). Prevents replay attacks — use a fresh nonce each…'}, 'agent_id': {'type': 'string', 'description': 'A stable unique identifier for this agent (e.g. a UUID). The issued key is…'}, 'signature': {'type': 'string', 'description': 'HMAC-SHA256(agent_id + str(timestamp) + nonce, MACHINE_MINT_SECRET) as…'}, 'timestamp': {'type': 'integer', 'description': 'Unix epoch seconds at signing time. Must be within 60s of server time.'}}}
preview_cost
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]
読み取り専用 冪等
入力スキーマ
{'type': 'object', 'required': ['operation', 'params'], 'properties': {'params': {'type': 'object', 'description': 'The same request body you would pass to the operation'}, 'operation': {'type': 'string'}}}
schedule_appointment
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] [async→get_outcome]
破壊的操作あり 外部アクセスあり
入力スキーマ
{'type': 'object', 'required': ['smb_id', 'action'], 'properties': {'notes': {'type': 'string'}, 'action': {'enum': ['book', 'cancel', 'check_availability'], 'type': 'string'}, 'smb_id': {'type': 'string'}, 'service': {'type': 'string'}, 'customer': {'type': 'object', 'properties': {'name': {'type': 'string'}, 'email': {'type': 'string'}, 'phone': {'type': 'string'}}}, 'requested_time': {'type': 'object', 'properties': {'preferred_iso': {'type': 'string', 'format': 'date-time'}, 'window_end_iso': {'type': 'string', 'format': 'date-time'}, 'duration_minutes': {'type': 'integer'}, 'window_start_iso': {'type': 'string', 'format': 'date-time'}}}, 'idempotency_key': {'type': 'string', 'maxLength': 128, 'description': 'Retry key: a 24h replay returns the original receipt, not re-run or charged.'}, 'existing_appointment_id': {'type': 'string', 'description': 'Required for cancel'}}}
screen_sanctions
Free screening of a name/entity 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 in quota, then $0.02/call]
読み取り専用 冪等
入力スキーマ
{'type': 'object', 'required': ['name'], 'properties': {'name': {'type': 'string', 'description': "Full name of the person or entity to screen, e.g. 'Kim Jong-un' or 'ACME…"}, 'type': {'enum': ['person', 'entity'], 'type': 'string', 'description': "Optional entity type hint. 'person' for individuals, 'entity' for…"}, 'country': {'type': 'string', 'description': "Optional ISO 3166-1 alpha-2 country code or country name (e.g. 'IR', 'Iran').…"}}}
self_test
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]
読み取り専用 冪等
入力スキーマ
{'type': 'object', 'properties': {}}
send_message
Send a message on behalf of an agent's user or an SMB across WhatsApp (free during launch), SMS, email, or voice, sent immediately with no scheduling. Every send routes through a non-bypassable gate (TCPA, GDPR, CASL, PDPL across 26 jurisdictions): marketing without recorded consent is rejected at runtime with a structured compliance_violation receipt. [from $0.02/call, variable] [async→get_outcome]
破壊的操作あり 外部アクセスあり
入力スキーマ
{'type': 'object', 'required': ['recipient', 'message_type', 'content'], 'properties': {'content': {'type': 'object', 'required': ['body'], 'properties': {'body': {'type': 'string'}, 'subject': {'type': 'string', 'description': 'For email channel'}, 'template_id': {'type': 'string'}, 'template_vars': {'type': 'object'}}}, 'recipient': {'type': 'object', 'required': ['id_type', 'id_value'], 'properties': {'id_type': {'enum': ['phone', 'email', 'smb_id', 'customer_id'], 'type': 'string'}, 'id_value': {'type': 'string'}, 'country_code': {'type': 'string', 'description': 'ISO 3166-1 alpha-2, required for compliance routing'}}}, 'business_id': {'type': 'string', 'description': 'Stable id for the recipient business; used for global demand shaping.'}, 'message_type': {'enum': ['transactional', 'marketing', 'reminder', 'follow_up', 'notification'], 'type': 'string', 'description': "Intent tag for the message. Five permitted types. 'marketing' is allowed only…"}, 'on_behalf_of': {'type': 'string', 'description': "Who this message is FOR (your end-user's name/label). On WhatsApp this opens a…"}, 'idempotency_key': {'type': 'string', 'maxLength': 128, 'description': 'Retry key: a 24h replay returns the original receipt, not re-run or charged.'}, 'preferred_channel': {'enum': ['whatsapp', 'sms', 'email', 'voice', 'auto'], 'type': 'string', 'default': 'auto'}}}
send_transactional_confirmation
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] [async→get_outcome]
破壊的操作あり
入力スキーマ
{'type': 'object', 'required': ['recipient', 'confirmation_type', 'data'], 'properties': {'data': {'type': 'object', 'description': 'Type-specific payload; e.g., {otp_code} for otp, {appointment_time, smb_name}…'}, 'recipient': {'type': 'object', 'required': ['phone_or_email'], 'properties': {'name': {'type': 'string'}, 'phone_or_email': {'type': 'string'}}}, 'idempotency_key': {'type': 'string', 'maxLength': 128, 'description': 'Retry key: a 24h replay returns the original receipt, not re-run or charged.'}, 'confirmation_type': {'enum': ['otp', 'booking_confirmation', 'payment_receipt', 'cancellation_notice', 'reminder'], 'type': 'string'}, 'preferred_channel': {'enum': ['sms', 'email', 'auto'], 'type': 'string', 'default': 'sms'}}}
verify_business
Look up what we know about a business in our supply network: its contact channels, capabilities, and when the record was last verified. This is a DIRECTORY LOOKUP - it does not contact the business. [free, no key]
読み取り専用 冪等
入力スキーマ
{'type': 'object', 'required': ['smb_id'], 'properties': {'smb_id': {'type': 'string'}, 'capability_to_verify': {'type': 'string'}}}
verify_company_record
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 in quota, then $0.02/call]
読み取り専用 冪等
入力スキーマ
{'type': 'object', 'required': ['name'], 'properties': {'lei': {'type': 'string', 'description': 'Optional 20-character Legal Entity Identifier for a direct, precise lookup.'}, 'name': {'type': 'string', 'description': 'Legal company name to look up, e.g. Apple Inc or Volkswagen AG.'}, 'country': {'type': 'string', 'description': 'Optional ISO 3166-1 alpha-2 country filter (e.g. US, DE, GB). Narrows GLEIF…'}}}
変更
find_business
2026年10月1日2:43
変更
call_business
2026年9月29日2:50
変更
send_message
2026年9月29日2:50
変更
find_business
2026年9月29日2:50
変更
get_conversation
2026年9月25日2:50
変更
call_business
2026年9月25日2:50
変更
send_message
2026年9月25日2:50
変更
find_business
2026年9月25日2:50
変更
map_trade_restriction
2026年9月23日2:41
変更
screen_sanctions
2026年9月23日2:41
変更
check_compliance
2026年9月23日2:41
変更
call_business
2026年9月23日2:41
変更
import_booking_url
2026年9月23日2:41
変更
escalate_to_human
2026年9月23日2:41
変更
handle_inbound
2026年9月23日2:41
変更
send_transactional_confirmation
2026年9月23日2:41
変更
schedule_appointment
2026年9月23日2:41
変更
capture_lead
2026年9月23日2:41
変更
send_message
2026年9月23日2:41
変更
find_business
2026年9月23日2:41
追加
lookup_us_contracts
2026年9月17日12:39
追加
mint_key
2026年9月17日12:39
追加
get_conversation
2026年9月17日12:39
追加
map_trade_restriction
2026年9月17日12:39
追加
screen_sanctions
2026年9月17日12:39
追加
verify_company_record
2026年9月17日12:39
追加
check_compliance
2026年9月17日12:39
追加
call_business
2026年9月17日12:39
追加
import_booking_url
2026年9月17日12:39
追加
check_booking_link
2026年9月17日12:39