Card snapshot

This is a frozen copy of the agent's agent-card.json as we observed it at the timestamp above. We capture a new snapshot every time the card's content hash changes. Useful for: forensic drift analysis, verifying downstream callers see the right version, reproducing routing decisions made historically.

{
  "protocolVersion": "0.2.5",
  "name": "Agent Broker",
  "description": "AI agents find, verify, message, and book appointments with small businesses worldwide. Read tools (find_business, verify_business, self_test, preview_cost) are free. Write tools require an X-Agent-Identity token. Built-in TCPA/GDPR/CASL compliance gate. Connect via the MCP endpoint below (streamable-http).",
  "url": "https://api.hatchloop.dev/mcp",
  "preferredTransport": "streamable-http",
  "version": "1.0.2",
  "provider": {
    "organization": "Agent Broker",
    "url": "https://api.hatchloop.dev"
  },
  "documentationUrl": "https://api.hatchloop.dev/llms.txt",
  "capabilities": {
    "streaming": true,
    "pushNotifications": true,
    "stateTransitionHistory": true
  },
  "defaultInputModes": [
    "application/json"
  ],
  "defaultOutputModes": [
    "application/json"
  ],
  "skills": [
    {
      "id": "find_business",
      "name": "Find Business",
      "description": "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.",
      "tags": [
        "sync",
        "read_only"
      ],
      "examples": [
        "",
        ""
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "verify_business",
      "name": "Verify Business",
      "description": "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.",
      "tags": [
        "sync",
        "read_only"
      ],
      "examples": [
        ""
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "send_message",
      "name": "Send Message",
      "description": "Send a message on behalf of an agent's user or an SMB across WhatsApp (free during launch), SMS, email, or voice. Five message types: transactional, reminder, follow_up, notification, marketing. Every send routes through a non-bypassable compliance gate (TCPA, GDPR, CASL, PDPL across 26 jurisdictions) that enforces opt-in consent for marketing/promotional content \u2014 marketing without recorded consent is rejected at runtime with a structured compliance_violation receipt. Channel is abstracted: specify intent and recipient; the service selects and falls back across channels.",
      "tags": [
        "sync_fast",
        "write",
        "compliance_gated"
      ],
      "examples": [
        "",
        ""
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "capture_lead",
      "name": "Capture Lead",
      "description": "Structured intake of a prospect into an SMB's funnel with validation, enrichment hooks, and deduplication. Inserts into the SMB's CRM or direct-booking pipeline if available.",
      "tags": [
        "sync_fast",
        "write",
        "compliance_gated"
      ],
      "examples": [
        ""
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "schedule_appointment",
      "name": "Schedule Appointment",
      "description": "Availability lookup, hold, confirm, reschedule, or cancel appointments with an SMB. Routes through the SMB's native booking system if available, falls back to voice AI or web form.",
      "tags": [
        "async_by_default",
        "write",
        "compliance_gated"
      ],
      "examples": [
        "",
        ""
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "send_transactional_confirmation",
      "name": "Send Transactional Confirmation",
      "description": "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.",
      "tags": [
        "sync_fast",
        "write",
        "compliance_gated"
      ],
      "examples": [
        ""
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "handle_inbound",
      "name": "Handle Inbound",
      "description": "Receive, classify, and route inbound messages on behalf of an SMB. Classifies intent (booking request, cancellation, inquiry, complaint), enriches with context, and routes to the appropriate handler or escalation path.",
      "tags": [
        "async_by_default",
        "compliance_gated"
      ],
      "examples": [
        ""
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "escalate_to_human",
      "name": "Escalate To Human",
      "description": "Hand off an in-flight task to a human operator with a full context bundle: transcript, prior actions, identifiers, and a recommended next step.",
      "tags": [
        "async_by_default",
        "compliance_gated"
      ],
      "examples": [
        ""
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "get_status",
      "name": "Get Status",
      "description": "Query the current state of any in-flight async operation by operation_id.",
      "tags": [
        "sync"
      ],
      "examples": [
        ""
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "get_outcome",
      "name": "Get Outcome",
      "description": "Retrieve the final OutcomeReceipt for a completed operation.",
      "tags": [
        "sync"
      ],
      "examples": [
        ""
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "preview_cost",
      "name": "Preview Cost",
      "description": "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.",
      "tags": [
        "sync",
        "read_only"
      ],
      "examples": [
        ""
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "self_test",
      "name": "Self Test",
      "description": "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.",
      "tags": [
        "sync"
      ],
      "examples": [
        ""
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "check_booking_link",
      "name": "Check Booking Link",
      "description": "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.",
      "tags": [
        "sync"
      ],
      "examples": [
        "",
        ""
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "import_booking_url",
      "name": "Import Booking Url",
      "description": "Turn ANY public booking URL (Cal.com, Calendly, Doctolib, Booksy, Fresha, OpenTable, Setmore, Square, Acuity, Schedulista, Squarespace, BookMyCity) into a callable smb_id you can immediately use with schedule_appointment, send_message, or capture_lead. Idempotent \u2014 calling twice returns the same smb_id.",
      "tags": [
        "sync"
      ],
      "examples": [
        "",
        ""
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "call_business",
      "name": "Call Business",
      "description": "Place a conversational voice-AI phone call to a business on a consumer's behalf and return a structured answer. THE differentiated capability: reach the ~60M long-tail SMBs that have NO API and NO booking page \u2014 only a phone number. An AI agent cannot pick up a phone and hold a conversation; this tool does. Give a plain-language objective; the voice AI navigates the call and extracts the answer. Business-directed (B2B), far less restricted than calling consumers \u2014 but the compliance gate still enforces recording consent per jurisdiction. Async: returns a call handle; poll get_outcome for the transcript + extracted fields.",
      "tags": [
        "async_by_default",
        "compliance_gated"
      ],
      "examples": [
        ""
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "check_compliance",
      "name": "Check Compliance",
      "description": "Free, instant pre-flight for the compliance gate. Runs the SAME TCPA / GDPR / CASL / CAN-SPAM / 10DLC gate that send_message and call_business run \u2014 but in preview mode, so NO message is sent and NO state changes. Tells you whether a (recipient, channel, message_type, content) send would be permitted BEFORE you pay for it, and if not, names the exact rule and how to remediate. Use it to de-risk a paid send the same way check_booking_link de-risks a paid booking.",
      "tags": [
        "sync"
      ],
      "examples": [
        "",
        ""
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "verify_company_record",
      "name": "Verify Company Record",
      "description": "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.",
      "tags": [
        "sync",
        "read_only"
      ],
      "examples": [
        "",
        ""
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "screen_sanctions",
      "name": "Screen Sanctions",
      "description": "Free screening of a name or entity against official sanctions lists, each fetched from the authority that issues it: the OFAC SDN list from the US Treasury (SDN.CSV plus ALT.CSV for alternate spellings), the EU consolidated financial sanctions list from the European Commission, and the UK Sanctions List from the FCDO. THE UN CONSOLIDATED LIST IS NOT SCREENED -- it carries no licence permitting commercial redistribution, so we do not claim it. ALWAYS check lists_screened on the response: it names the lists that actually ran ON THAT CALL, and a list that failed to load appears in sources_unavailable instead. reason_code is 'partial_screening' whenever any source was unavailable, never 'clear'. Returns matched: bool, a list of matches with score, program, and source URL, and which lists were screened. Never fabricates a match or a clear -- if no match is found, explicitly names which lists were checked.",
      "tags": [
        "sync"
      ],
      "examples": [
        "",
        ""
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "map_trade_restriction",
      "name": "Map Trade Restriction",
      "description": "Free cross-border trade screening of the DESTINATION and the PARTIES. IT DOES NOT CLASSIFY THE PRODUCT: the product argument is recorded and echoed back, never checked against any export-control list, so a controlled item to an unrestricted destination returns no findings and reason_code 'partial' -- never 'clear'. This is not an export-control clearance; classify the item (HS/ECCN) against BIS/EU/UK controls yourself. Given a product and destination country (and optionally an HS code, origin country, and a list of parties to screen), returns: (a) whether the destination or any party hits an export-control or sanctions restriction, (b) the destination risk level (comprehensive_embargo / sectoral_sanctions / elevated_scrutiny / standard), (c) HS code hint if the caller provided one, (d) honest tariff guidance + official links without fabricated rates, and (e) party sanctions screening against OFAC SDN (US Treasury), the EU Consolidated list (European Commission) and the UK Sanctions List (FCDO). Acts as a MIDDLEMAN -- unifies the OFAC comprehensive-embargo map, our own indexed copies of the EU and UK lists, and OFAC SDN into one clean call. Never fabricates a tariff rate, a clear, or a restricted status.",
      "tags": [
        "sync"
      ],
      "examples": [
        "",
        ""
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    },
    {
      "id": "get_conversation",
      "name": "Get Conversation",
      "description": "Read a two-way conversation thread you started: its state, every message exchanged, and how many replies the business has sent.",
      "tags": [
        "sync"
      ],
      "examples": [
        "",
        ""
      ],
      "inputModes": [
        "application/json"
      ],
      "outputModes": [
        "application/json"
      ]
    }
  ],
  "_meta": {
    "transport": "mcp",
    "mcpEndpoint": "https://api.hatchloop.dev/mcp",
    "payments": {
      "status": "active",
      "free_tools": [
        "check_booking_link",
        "check_compliance",
        "find_business",
        "get_conversation",
        "get_outcome",
        "get_status",
        "preview_cost",
        "self_test",
        "verify_business"
      ],
      "free_with_key_tools": [
        "import_booking_url"
      ],
      "paid_tools": [
        "call_business",
        "capture_lead",
        "escalate_to_human",
        "handle_inbound",
        "map_trade_restriction",
        "schedule_appointment",
        "screen_sanctions",
        "send_message",
        "send_transactional_confirmation",
        "verify_company_record"
      ],
      "unit": "credits (1 credit = 1 US cent)",
      "rails": [
        "credits",
        "x402"
      ],
      "quota_free_tools": [
        "map_trade_restriction",
        "screen_sanctions",
        "verify_company_record"
      ],
      "note": "THREE NUMBERS, because 'free' means three things here. 9 tools are callable with NO key and NO credits. 3 more are callable with no key up to a daily quota, then cost credits. That is 12 usable without signing up. The remaining 8 need a free key, and 10 spend credits once past any quota. Call preview_cost (free) for the exact price of any operation before committing. Pricing: https://hatchloop.dev/pricing No account needed to pay per call: attach an x402 payment in params._meta['x402/payment'] and the server returns a signed price offer (USDC on Base) for any paid tool."
    }
  }
}