Agent Broker

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]

{
  "type": "object",
  "properties": {
    "vertical": {
      "type": "string",
      "enum": [
        "personal_services",
        "home_services",
        "professional_services"
      ]
    },
    "location": {
      "type": "object",
      "required": [
        "zip_or_city"
      ],
      "properties": {
        "zip_or_city": {
          "type": "string"
        },
        "radius_miles": {
          "type": "number",
          "minimum": 0,
          "description": "Accepted but NOT applied - no coordinates exist, so results are not restricted to this radius. Disclosed back as radius_miles_applied: false."
        }
      },
      "description": "Where to search. Matched against the business's city, state and ZIP as text -…"
    },
    "capability": {
      "type": "string",
      "description": "Specific service capability required, e.g. 'haircut', 'plumbing',…"
    },
    "price_band": {
      "type": "object",
      "properties": {
        "max_usd": {
          "type": "number"
        }
      }
    },
    "availability_window": {
      "type": "object",
      "properties": {
        "start_iso": {
          "type": "string",
          "format": "date-time"
        },
        "end_iso": {
          "type": "string",
          "format": "date-time"
        }
      },
      "description": "Accepted but NOT APPLIED - it does not narrow results. We do not hold live…"
    },
    "max_results": {
      "type": "integer",
      "default": 5,
      "maximum": 20,
      "minimum": 1
    }
  },
  "required": [
    "vertical",
    "location"
  ]
}

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",
  "properties": {
    "smb_id": {
      "type": "string"
    },
    "capability_to_verify": {
      "type": "string"
    }
  },
  "required": [
    "smb_id"
  ]
}

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]

{
  "type": "object",
  "properties": {
    "recipient": {
      "type": "object",
      "required": [
        "id_type",
        "id_value"
      ],
      "properties": {
        "id_type": {
          "type": "string",
          "enum": [
            "phone",
            "email",
            "smb_id",
            "customer_id"
          ]
        },
        "id_value": {
          "type": "string"
        },
        "country_code": {
          "type": "string",
          "description": "ISO 3166-1 alpha-2, required for compliance routing"
        }
      }
    },
    "message_type": {
      "type": "string",
      "description": "Intent tag for the message. Five permitted types. 'marketing' is allowed only…",
      "enum": [
        "transactional",
        "marketing",
        "reminder",
        "follow_up",
        "notification"
      ]
    },
    "content": {
      "type": "object",
      "required": [
        "body"
      ],
      "properties": {
        "body": {
          "type": "string"
        },
        "subject": {
          "type": "string",
          "description": "For email channel"
        },
        "template_id": {
          "type": "string"
        },
        "template_vars": {
          "type": "object"
        }
      }
    },
    "preferred_channel": {
      "type": "string",
      "enum": [
        "whatsapp",
        "sms",
        "email",
        "voice",
        "auto"
      ],
      "default": "auto"
    },
    "on_behalf_of": {
      "type": "string",
      "description": "Who this message is FOR (your end-user's name/label). On WhatsApp this opens a…"
    },
    "business_id": {
      "type": "string",
      "description": "Stable id for the recipient business; used for global demand shaping."
    },
    "idempotency_key": {
      "type": "string",
      "maxLength": 128,
      "description": "Retry key: a 24h replay returns the original receipt, not re-run or charged."
    }
  },
  "required": [
    "recipient",
    "message_type",
    "content"
  ]
}

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",
  "properties": {
    "smb_id": {
      "type": "string"
    },
    "prospect": {
      "type": "object",
      "required": [
        "name"
      ],
      "properties": {
        "name": {
          "type": "string"
        },
        "phone": {
          "type": "string"
        },
        "email": {
          "type": "string",
          "format": "email"
        },
        "service_interest": {
          "type": "string"
        },
        "notes": {
          "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."
        }
      }
    },
    "source": {
      "type": "string",
      "description": "Where the consumer-initiated request originated (e.g., 'consumer_request',…"
    },
    "idempotency_key": {
      "type": "string",
      "maxLength": 128,
      "description": "Retry key: a 24h replay returns the original receipt, not re-run or charged."
    }
  },
  "required": [
    "smb_id",
    "prospect"
  ]
}

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",
  "properties": {
    "smb_id": {
      "type": "string"
    },
    "action": {
      "type": "string",
      "enum": [
        "book",
        "cancel",
        "check_availability"
      ]
    },
    "service": {
      "type": "string"
    },
    "customer": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string"
        },
        "phone": {
          "type": "string"
        },
        "email": {
          "type": "string"
        }
      }
    },
    "requested_time": {
      "type": "object",
      "properties": {
        "preferred_iso": {
          "type": "string",
          "format": "date-time"
        },
        "window_start_iso": {
          "type": "string",
          "format": "date-time"
        },
        "window_end_iso": {
          "type": "string",
          "format": "date-time"
        },
        "duration_minutes": {
          "type": "integer"
        }
      }
    },
    "existing_appointment_id": {
      "type": "string",
      "description": "Required for cancel"
    },
    "notes": {
      "type": "string"
    },
    "idempotency_key": {
      "type": "string",
      "maxLength": 128,
      "description": "Retry key: a 24h replay returns the original receipt, not re-run or charged."
    }
  },
  "required": [
    "smb_id",
    "action"
  ]
}

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",
  "properties": {
    "recipient": {
      "type": "object",
      "required": [
        "phone_or_email"
      ],
      "properties": {
        "phone_or_email": {
          "type": "string"
        },
        "name": {
          "type": "string"
        }
      }
    },
    "confirmation_type": {
      "type": "string",
      "enum": [
        "otp",
        "booking_confirmation",
        "payment_receipt",
        "cancellation_notice",
        "reminder"
      ]
    },
    "data": {
      "type": "object",
      "description": "Type-specific payload; e.g., {otp_code} for otp, {appointment_time, smb_name}…"
    },
    "preferred_channel": {
      "type": "string",
      "enum": [
        "sms",
        "email",
        "auto"
      ],
      "default": "sms"
    },
    "idempotency_key": {
      "type": "string",
      "maxLength": 128,
      "description": "Retry key: a 24h replay returns the original receipt, not re-run or charged."
    }
  },
  "required": [
    "recipient",
    "confirmation_type",
    "data"
  ]
}

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",
  "properties": {
    "smb_id": {
      "type": "string"
    },
    "inbound_channel": {
      "type": "string",
      "enum": [
        "sms",
        "email",
        "voice_voicemail",
        "web_form",
        "api"
      ]
    },
    "sender": {
      "type": "object",
      "properties": {
        "phone": {
          "type": "string"
        },
        "email": {
          "type": "string"
        },
        "name": {
          "type": "string"
        }
      }
    },
    "raw_message": {
      "type": "string"
    },
    "received_at_iso": {
      "type": "string",
      "format": "date-time"
    },
    "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."
    }
  },
  "required": [
    "smb_id",
    "inbound_channel",
    "raw_message"
  ]
}

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",
  "properties": {
    "smb_id": {
      "type": "string"
    },
    "reason": {
      "type": "string",
      "enum": [
        "automation_failed",
        "customer_requested",
        "compliance_hold",
        "ambiguous_intent",
        "exception_required"
      ]
    },
    "context": {
      "type": "object",
      "properties": {
        "original_operation": {
          "type": "string"
        },
        "operation_id": {
          "type": "string"
        },
        "transcript": {
          "type": "array",
          "items": {
            "type": "object"
          }
        },
        "prior_actions": {
          "type": "array",
          "items": {
            "type": "object"
          }
        },
        "recommended_next_step": {
          "type": "string"
        }
      }
    },
    "priority": {
      "type": "string",
      "enum": [
        "normal",
        "urgent"
      ],
      "default": "normal"
    },
    "idempotency_key": {
      "type": "string",
      "maxLength": 128,
      "description": "Retry key: a 24h replay returns the original receipt, not re-run or charged."
    }
  },
  "required": [
    "smb_id",
    "reason",
    "context"
  ]
}

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

{
  "type": "object",
  "properties": {
    "operation_id": {
      "type": "string"
    }
  },
  "required": [
    "operation_id"
  ]
}

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

{
  "type": "object",
  "properties": {
    "operation_id": {
      "type": "string"
    }
  },
  "required": [
    "operation_id"
  ]
}

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",
  "properties": {
    "operation": {
      "type": "string"
    },
    "params": {
      "type": "object",
      "description": "The same request body you would pass to the operation"
    }
  },
  "required": [
    "operation",
    "params"
  ]
}

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": {}
}

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",
  "properties": {},
  "required": []
}

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",
  "properties": {
    "url": {
      "type": "string",
      "description": "Full http(s) URL to classify, e.g. 'https://cal.com/jane' or…"
    }
  },
  "required": [
    "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",
  "properties": {
    "booking_url": {
      "type": "string",
      "format": "uri",
      "description": "Full URL the user supplied. Must point at one of the 12 supported booking…"
    },
    "business_name": {
      "type": "string",
      "description": "If omitted, auto-extracted from the page's <title> or og:title."
    },
    "vertical": {
      "type": "string",
      "enum": [
        "personal_services",
        "home_services",
        "professional_services",
        "restaurants",
        "retail",
        "healthcare",
        "fitness"
      ],
      "description": "If omitted, inferred from the booking platform."
    },
    "country_code": {
      "type": "string",
      "description": "ISO 3166-1 alpha-2 (e.g. 'US', 'FR'); routes compliance on later sends."
    },
    "contact_phone": {
      "type": "string",
      "description": "If omitted, the platform integration handles outreach."
    },
    "contact_email": {
      "type": "string"
    },
    "capabilities": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Free-form capability tags (e.g., ['haircut','color','blowdry'])."
    },
    "idempotency_key": {
      "type": "string",
      "maxLength": 128,
      "description": "Retry key: a 24h replay returns the original receipt, not re-run or charged."
    }
  },
  "required": [
    "booking_url"
  ]
}

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]

{
  "type": "object",
  "properties": {
    "business_phone": {
      "type": "string",
      "description": "Business phone in E.164 (e.g. +14045550123). Provide this OR smb_id."
    },
    "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."
    },
    "extract_fields": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Structured fields to pull from the answer, e.g.…"
    },
    "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."
    },
    "max_duration_seconds": {
      "type": "integer",
      "maximum": 600,
      "default": 180
    },
    "idempotency_key": {
      "type": "string",
      "maxLength": 128,
      "description": "Retry key: a 24h replay returns the original receipt, not re-run or charged."
    }
  },
  "required": [
    "objective"
  ]
}

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",
  "properties": {
    "recipient_id": {
      "type": "string",
      "description": "Phone in E.164 (e.g. '+14045550100') or email address the message would go to."
    },
    "content": {
      "type": "string",
      "description": "The actual message body you intend to send. The gate classifies the real text,…"
    },
    "channel": {
      "type": "string",
      "enum": [
        "sms",
        "email",
        "voice"
      ],
      "description": "Delivery channel. Omit to auto-infer sms/email from recipient_id; set 'voice'…"
    },
    "message_type": {
      "type": "string",
      "description": "Intent tag: transactional, marketing, reminder, follow_up, notification.…",
      "default": "transactional"
    },
    "country_code": {
      "type": "string",
      "description": "ISO 3166-1 alpha-2 (e.g. 'US', 'DE', 'CA'). Auto-inferred from phone if…"
    },
    "state_code": {
      "type": "string",
      "description": "US state code (e.g. 'CA') for state-specific rules."
    }
  },
  "required": [
    "recipient_id",
    "content"
  ]
}

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",
  "properties": {
    "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…"
    },
    "lei": {
      "type": "string",
      "description": "Optional 20-character Legal Entity Identifier for a direct, precise lookup."
    }
  },
  "required": [
    "name"
  ]
}

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",
  "properties": {
    "name": {
      "type": "string",
      "description": "Full name of the person or entity to screen, e.g. 'Kim Jong-un' or 'ACME…"
    },
    "country": {
      "type": "string",
      "description": "Optional ISO 3166-1 alpha-2 country code or country name (e.g. 'IR', 'Iran').…"
    },
    "type": {
      "type": "string",
      "enum": [
        "person",
        "entity"
      ],
      "description": "Optional entity type hint. 'person' for individuals, 'entity' for…"
    }
  },
  "required": [
    "name"
  ]
}

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",
  "properties": {
    "product": {
      "type": "string",
      "description": "Product name or description, e.g. 'laptop computers', 'crude oil', 'medical…"
    },
    "hs_code": {
      "type": "string",
      "description": "Optional Harmonized System code (e.g. '8471.30' for laptops). If provided,…"
    },
    "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').…"
    },
    "parties": {
      "type": "array",
      "maxItems": 20,
      "items": {
        "type": "string"
      },
      "description": "Optional list of party names to screen (exporter, importer, freight forwarder,…"
    }
  },
  "required": [
    "product",
    "destination_country"
  ]
}

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": {
    "conversation_id": {
      "type": "string",
      "description": "From the send_message receipt (preferred)."
    },
    "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)."
    }
  }
}

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",
  "properties": {
    "agent_id": {
      "type": "string",
      "description": "A stable unique identifier for this agent (e.g. a UUID). The issued key is…"
    },
    "timestamp": {
      "type": "integer",
      "description": "Unix epoch seconds at signing time. Must be within 60s of server time."
    },
    "nonce": {
      "type": "string",
      "description": "Random value (UUID or hex). Prevents replay attacks — use a fresh nonce each…"
    },
    "signature": {
      "type": "string",
      "description": "HMAC-SHA256(agent_id + str(timestamp) + nonce, MACHINE_MINT_SECRET) as…"
    }
  },
  "required": [
    "agent_id",
    "timestamp",
    "nonce",
    "signature"
  ]
}

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",
  "properties": {
    "company_name": {
      "type": "string",
      "description": "Company or recipient name to search for in US federal contract awards (e.g.…"
    },
    "max_results": {
      "type": "integer",
      "default": 5,
      "minimum": 1,
      "maximum": 10,
      "description": "Maximum number of contract awards to return (sorted by award amount…"
    }
  },
  "required": [
    "company_name"
  ]
}