Skip to content

Agent Broker

by basilalshukaili · remote · no sign-in to list tools · v1.0.2 · published by GitHub user basilalshukaili

AI agents find, message & book SMBs; pay per call in USDC on Base via x402. 14 tools, compliant.

Deletes · 5Final · 1Changes · 10
CompareRegistry entry

23 tools: 5 can delete or cancel things, 1 do something that can't be undone, 10 change things and 7 only read.

Scanned Oct 21, 2026

1 check matched something in the tool definitions. No finding is not a safety guarantee. How the checks work.

claude mcp add --transport http agent-broker https://agent-broker-edge.basil-agent.workers.dev/mcp

Findings

Matches of fixed checks, with the text they matched.

1 warn
  • Warncheck_booking_link

    The server marks "check_booking_link" read-only (readOnlyHint: true), and its own name, description or input give the class "write".

    Matched text

    annotations: {"readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}; The name "check_booking_link" says "link": a word for a change.

    What this check looks for

Tools

Open a tool for its reasons and full description. Descriptions are the publisher's own words, shown as they are.

23 tools

Deletes or cancels 5Claude Code: deny
  • call_businessPlace a conversational voice-AI phone call to a business on a consumer's behalf.No findings

    Why it is in this group

    • The name "call_business" says "call": a word for a change.
    • The server marks it destructive (destructiveHint: true).
    Description, as the server wrote it
    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]

    Annotations the server declares

    • title: Call Business
    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
  • escalate_to_humanHand off an in-flight task to a human operator with a full context bundle: transcript, prior actions, identifiers, and a recommended next step.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it destructive (destructiveHint: true).
    Description, as the server wrote it
    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]

    Annotations the server declares

    • title: Escalate To Human
    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: false
  • schedule_appointmentCheck availability, book, or cancel via Cal.com.No findings

    Why it is in this group

    • The name "schedule_appointment" says "schedule": a word for a change.
    • The server marks it destructive (destructiveHint: true).
    Description, as the server wrote it
    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]

    Annotations the server declares

    • title: Schedule Appointment
    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
  • send_messageSend a message on behalf of an agent's user or an SMB via WhatsApp or email — both live.No findings

    Why it is in this group

    • The name "send_message" says "send": a word for sending, and what is sent cannot be taken back.
    • The input addresses people (input.recipient): what it sends cannot be taken back.
    • The server marks it destructive (destructiveHint: true).
    Description, as the server wrote it
    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]

    Annotations the server declares

    • title: Send Message
    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: true
  • send_transactional_confirmationIdempotent transactional messages: OTPs, booking confirmations, payment receipts, cancellation notices.No findings

    Why it is in this group

    • The name "send_transactional_confirmation" says "send": a word for sending, and what is sent cannot be taken back.
    • The input addresses people (input.recipient): what it sends cannot be taken back.
    • The server marks it destructive (destructiveHint: true).
    Description, as the server wrote it
    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]

    Annotations the server declares

    • title: Send Transactional Confirmation
    • readOnlyHint: false
    • destructiveHint: true
    • idempotentHint: false
    • openWorldHint: false
Can't be undone 1Claude Code: ask
  • capture_leadStructured intake of a prospect into an SMB's funnel with validation and deduplication on (smb_id, phone or email).No findings

    Why it is in this group

    • The name "capture_lead" says "capture": a word that usually means money moves, which cannot be taken back.
    Description, as the server wrote it
    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]

    Annotations the server declares

    • title: Capture Lead
    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: false
Changes things 10Claude Code: ask
  • 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 …No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
    Description, as the server wrote it
    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]

    Annotations the server declares

    • title: Check Compliance
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
  • handle_inboundClassify an inbound message on behalf of an SMB and get a recommended next action.No findings

    Why it is in this group

    • The name "handle_inbound" says "handle": a word for a change.
    Description, as the server wrote it
    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]

    Annotations the server declares

    • title: Handle Inbound
    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: false
  • import_booking_urlTurn a public booking URL into a callable smb_id for send_message and capture_lead.No findings

    Why it is in this group

    • The name "import_booking_url" says "import": a word for a change.
    Description, as the server wrote it
    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]

    Annotations the server declares

    • title: Import Booking Url
    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
  • 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 unrestric…No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
    Description, as the server wrote it
    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]

    Annotations the server declares

    • title: Map Trade Restriction
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
  • mint_keyAgent self-serve API key issuance.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    Description, as the server wrote it
    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]

    Annotations the server declares

    • title: Mint Key
    • readOnlyHint: false
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: false
  • screen_sanctionsFree screening of a name/entity against sanctions lists: OFAC SDN (US Treasury), EU consolidated list (European Commission), UK Sanctions List (FCDO).No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
    Description, as the server wrote it
    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]

    Annotations the server declares

    • title: Screen Sanctions
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
  • self_testService health probe: runs 6 internal checks and reports how many passed.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
    Description, as the server wrote it
    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]

    Annotations the server declares

    • title: Self Test
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
  • verify_businessLook up what we know about a business in our supply network: its contact channels, capabilities, and when the record was last verified.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
    Description, as the server wrote it
    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]

    Annotations the server declares

    • title: Verify Business
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
  • verify_company_recordFree, live lookup of a company official registry record.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
    Description, as the server wrote it
    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]

    Annotations the server declares

    • title: Verify Company Record
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
Only reads 7Claude Code: allow
  • 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 rese…No findings

    Why it is in this group

    • The description's first verb is "return": a word for reading.
    Description, as the server wrote it
    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]

    Annotations the server declares

    • title: Check Quota
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
  • find_businessGiven criteria (vertical, location, capability, price band, availability window), return ranked candidate businesses from our supply network.No findings

    Why it is in this group

    • The name "find_business" says "find": a word for reading.
    Description, as the server wrote it
    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]

    Annotations the server declares

    • title: Find Business
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
  • get_conversationRead a two-way conversation thread you started: its state, every message exchanged, and how many replies the business has sent.No findings

    Why it is in this group

    • The name "get_conversation" says "get": a word for reading.
    Description, as the server wrote it
    Read a two-way conversation thread you started: its state, every message exchanged, and how many replies the business has sent. [free, requires key]

    Annotations the server declares

    • title: Get Conversation
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: false
    • openWorldHint: false
  • get_outcomeRetrieve the final OutcomeReceipt for a completed operation.No findings

    Why it is in this group

    • The name "get_outcome" says "get": a word for reading.
    Description, as the server wrote it
    Retrieve the final OutcomeReceipt for a completed operation. [free, no key]

    Annotations the server declares

    • title: Get Outcome
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
  • get_statusQuery the current state of any in-flight async operation by operation_id.No findings

    Why it is in this group

    • The name "get_status" says "get": a word for reading.
    Description, as the server wrote it
    Query the current state of any in-flight async operation by operation_id. [free, no key]

    Annotations the server declares

    • title: Get Status
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
  • lookup_us_contractsSearch US federal contract awards by company (recipient) name using the free USASpending.gov public API.No findings

    Why it is in this group

    • The name "lookup_us_contracts" says "lookup": a word for reading.
    Description, as the server wrote it
    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]

    Annotations the server declares

    • title: Lookup Us Contracts
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
  • preview_costReturn an expected cost estimate, latency estimate, and success-probability estimate for a proposed call before execution.No findings

    Why it is in this group

    • The name "preview_cost" says "preview": a word for reading.
    Description, as the server wrote it
    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]

    Annotations the server declares

    • title: Preview Cost
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false

This is not a safety rating, and no finding is not a safety guarantee. The groups and findings come from fixed checks of the tool definitions the server returned on the date shown, not from its code or what it does when called. How the checks work.

Install

Pinned to version 1.0.2. Values in angle brackets are yours to fill in.

claude mcp add --transport http agent-broker https://agent-broker-edge.basil-agent.workers.dev/mcp

Run in a terminal.

Claude Code permissions

Allow the reads, ask before a change, deny the deletes. Paste into .claude/settings.json.

.claude/settings.json
{
  "permissions": {
    "allow": [
      "mcp__agent-broker__find_business",
      "mcp__agent-broker__get_status",
      "mcp__agent-broker__get_outcome",
      "mcp__agent-broker__preview_cost",
      "mcp__agent-broker__check_quota",
      "mcp__agent-broker__get_conversation",
      "mcp__agent-broker__lookup_us_contracts"
    ],
    "ask": [
      "mcp__agent-broker__verify_business",
      "mcp__agent-broker__capture_lead",
      "mcp__agent-broker__handle_inbound",
      "mcp__agent-broker__self_test",
      "mcp__agent-broker__check_booking_link",
      "mcp__agent-broker__import_booking_url",
      "mcp__agent-broker__check_compliance",
      "mcp__agent-broker__verify_company_record",
      "mcp__agent-broker__screen_sanctions",
      "mcp__agent-broker__map_trade_restriction",
      "mcp__agent-broker__mint_key"
    ],
    "deny": [
      "mcp__agent-broker__send_message",
      "mcp__agent-broker__schedule_appointment",
      "mcp__agent-broker__send_transactional_confirmation",
      "mcp__agent-broker__escalate_to_human",
      "mcp__agent-broker__call_business"
    ]
  }
}

Tools that only read are allowed, tools that change things ask first, tools that delete or cancel are denied. It assumes the server is installed as agent-broker. Review it before you use it.