MCP.so
ログイン
A

Agent Broker MCP Server

@basilalshukaili

基本情報

カテゴリ

AI とエージェント

トランスポート

stdio

作者

basilalshukaili

投稿者

Basil ِ

Agent Broker MCP Server について

13 MCP tools to find, message, and book appointments at small businesses worldwide.

Agent Broker MCP Server の設定

以下の設定を使って、このサーバーを MCP 対応クライアントに追加してください。

{
  "mcpServers": {
    "agent-broker": {
      "url": "https://agent-broker-edge.basil-agent.workers.dev/mcp"
    }
  }
}

Agent Broker MCP Server のツール

23

Given criteria (vertical, location, capability, price band, availability window), return ranked candidate businesses from our supply network. THE NETWORK IS SMALL AND STILL MOSTLY SAMPLE DATA: entries that are not real are named [DEMO] and flagged is_demo - check that field before acting on a result. [free, no key]

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]

Send a message on behalf of an agent's user or an SMB via WhatsApp or email — both live. SMS and voice are advertised but NOT wired on this deployment: they always fail honestly (channel_not_configured), uncharged. Sent immediately, no scheduling. Every send passes a non-bypassable gate (TCPA, GDPR, CASL, PDPL, 26 jurisdictions): marketing without recorded consent gets a structured compliance_violation receipt. [from $0.02/call, variable] [async→get_outcome]

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]

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]

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]

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]

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]

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

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

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]

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]

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]

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]

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]

Place a conversational voice-AI phone call to a business on a consumer's behalf. NOT WIRED on this deployment (Vapi unconfigured): every call fails honestly with voice_not_provisioned before dialling, uncharged. 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]

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]

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]

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]

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]

Read a two-way conversation thread you started: its state, every message exchanged, and how many replies the business has sent. [free, requires 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]

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]

概要

What is Agent Broker?

Agent Broker is a compliance-aware service that lets autonomous AI agents discover, verify, communicate, schedule with, and transact with small and mid-sized businesses (SMBs) through a single tool surface. It integrates with MCP, REST, OpenAI function calling, Anthropic tool use, and A2A protocols.

How to use Agent Broker?

Add the MCP server URL and X-Agent-Identity header to your MCP client config, or call operations directly via REST using the $AGENT_BROKER_TOKEN for authentication. You can also use the provided OpenAI or Anthropic tool schemas by fetching the .well-known JSON files.

Key features of Agent Broker

  • 13 operations including search, verify, message, schedule, and transact
  • Enforced compliance (TCPA, GDPR, CASL, 10DLC, two-party consent)
  • Channel fallback: API → SMS → voice → email → web form
  • Idempotency keyed by agent, operation, and key with 24h TTL
  • Cost preview, self-test, and outcome polling operations are free

Use cases of Agent Broker

  • An AI agent finds and books a haircut appointment at an SMB in Atlanta
  • An agent gets a quote on a roof repair from a local contractor
  • An agent sends a transactional confirmation after an online booking
  • An agent captures a prospect lead with dedup and hands it to an SMB
  • An agent escalates a complex customer query to a human operator

よくある質問

1

How does Agent Broker handle compliance?

Every outbound communication passes through `compliance/pre_check()` that classifies content, checks opt-outs and consent, verifies 10DLC registry, and enforces two-party recording consent. Violations surface as `ComplianceViolationError` and are never silently dropped.

2

What runtime dependencies does Agent Broker require?

The service requires Python 3.11+ for the origin layer and runs on Cloudflare Workers for the edge proxy. The README includes a `requirements.txt` and a Docker Compose file for local development.

3

How is data stored and protected?

PII is stored as SHA-256 hashes, never as plaintext. Audit logs and consent records are written immutably to an outcome store. No further details on data residency are provided.

4

What transport and authentication options are available?

You can call Agent Broker via MCP, REST, OpenAI tools, Anthropic tools, or A2A protocol. Authentication uses an `X-Agent-Identity` header containing an agent token. The service is reachable at `agent-broker-edge.basil-agent.workers.dev`.

5

What are the pricing and cost guarantees?

Each operation has a fixed per-call cost (e.g., $0.01 for `find_business`, $0.15 + $0.85 success premium for `schedule_appointment`). The `preview_cost` and `self_test` operations are free. Idempotency keys prevent double charging within a 24‑hour window.

コメント

「AI とエージェント」の他のコンテンツ