{"name":"SMB Transaction & Communication Broker","description":"Agent-callable service for the long tail of small businesses. Discover, verify, communicate, schedule, transact — all with built-in TCPA/GDPR/CASL compliance and idempotent semantics.","version":"0.1.0","protocol_version":"a2a-v0.2","url":"https://api.hatchloop.dev","documentation_url":"https://api.hatchloop.dev/docs","default_input_modes":["application/json"],"default_output_modes":["application/json"],"capabilities":{"streaming":true,"push_notifications":true,"state_transition_history":true},"authentication":{"schemes":["bearer","agent-identity-jwt"],"header":"X-Agent-Identity","token_endpoint":"https://api.hatchloop.dev/auth/token"},"skills":[{"id":"find_business","name":"Find Business","description":"Given criteria (vertical, location, capability, price band, availability window), return ranked candidate SMBs from the verified supply network. Returns only curated, verified, transactable businesses — not raw directory results.","tags":["sync","read_only"],"examples":["",""],"input_modes":["application/json"],"output_modes":["application/json"]},{"id":"verify_business","name":"Verify Business","description":"Confirm that an SMB is real, currently operating, and capable of the requested service. Performs a live capability probe against the business's channel.","tags":["sync","read_only"],"examples":[""],"input_modes":["application/json"],"output_modes":["application/json"]},{"id":"send_message","name":"Send Message","description":"Send a message on behalf of an agent's user or an SMB across 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 22 jurisdictions) that enforces opt-in consent for marketing/promotional content — 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":["",""],"input_modes":["application/json"],"output_modes":["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":[""],"input_modes":["application/json"],"output_modes":["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":["",""],"input_modes":["application/json"],"output_modes":["application/json"]},{"id":"send_transactional_confirmation","name":"Send Transactional Confirmation","description":"Idempotent transactional messages: OTPs, booking confirmations, payment receipts, cancellation notices. Guaranteed delivery via redundant channels.","tags":["sync_fast","write","compliance_gated"],"examples":[""],"input_modes":["application/json"],"output_modes":["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":[""],"input_modes":["application/json"],"output_modes":["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":[""],"input_modes":["application/json"],"output_modes":["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":[""],"input_modes":["application/json"],"output_modes":["application/json"]},{"id":"get_outcome","name":"Get Outcome","description":"Retrieve the final OutcomeReceipt for a completed operation.","tags":["sync"],"examples":[""],"input_modes":["application/json"],"output_modes":["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. Accuracy SLO: actual cost within ±5% of preview.","tags":["sync","read_only"],"examples":[""],"input_modes":["application/json"],"output_modes":["application/json"]},{"id":"self_test","name":"Self Test","description":"Live capability probe that verifies the service is healthy, each claimed operation is reachable, and supply network size is current. Use to verify integration before production use.","tags":["sync"],"examples":[""],"input_modes":["application/json"],"output_modes":["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":["",""],"input_modes":["application/json"],"output_modes":["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 — calling twice returns the same smb_id.","tags":["sync"],"examples":["",""],"input_modes":["application/json"],"output_modes":["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 — 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 — 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":[""],"input_modes":["application/json"],"output_modes":["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 — 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":["",""],"input_modes":["application/json"],"output_modes":["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":["",""],"input_modes":["application/json"],"output_modes":["application/json"]},{"id":"screen_sanctions","name":"Screen Sanctions","description":"Free, live screening of a name or entity against official sanctions and watchlists. Queries OpenSanctions (aggregates OFAC SDN, EU Consolidated Financial Sanctions, UN Security Council, UK HMT, and 40+ official lists) plus the OFAC SDN list directly from the US Treasury. 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":["",""],"input_modes":["application/json"],"output_modes":["application/json"]},{"id":"map_trade_restriction","name":"Map Trade Restriction","description":"Free, live cross-border trade-compliance snapshot. 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 via OpenSanctions and OFAC SDN. Acts as a MIDDLEMAN -- unifies the OFAC comprehensive-embargo map, OpenSanctions (40+ official lists including BIS Entity List, EU, UN, UK), and OFAC SDN into one clean call. Never fabricates a tariff rate, a clear, or a restricted status.","tags":["sync"],"examples":["",""],"input_modes":["application/json"],"output_modes":["application/json"]}],"supported_protocols":["mcp","openai-tools","anthropic-tools","rest","a2a"],"discovery_urls":{"mcp":"https://api.hatchloop.dev/mcp","openapi":"https://api.hatchloop.dev/openapi.yaml","manifest":"https://api.hatchloop.dev/manifest","ai_plugin":"https://api.hatchloop.dev/.well-known/ai-plugin.json"}}