call_business

[UNAVAILABLE on this deployment: Voice calling is not enabled on this deployment yet: the outbound phone line has not been verified for placing calls.] Place a conversational voice-AI phone call to a business on a consumer's behalf; 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, not charged while no payment rail is on] [async→get_outcome]

destructive

Argument	Type	Description
smb_id	string	Known SMB identifier with a phone on record. Provide this OR business_phone.
objective*	string	What the call should accomplish, in plain language.
country_code	string	ISO 3166-1 alpha-2 for compliance + recording-consent routing.
on_behalf_of	string	Name of the consumer the call is placed for.
business_phone	string	Business phone in E.164 (e.g. +14045550123). Provide this OR smb_id.
extract_fields	array	Structured fields to pull from the answer, e.g.…
idempotency_key	string	Retry key: a 24h replay returns the original receipt, not re-run or charged.
max_duration_seconds	integer

Input schema (JSON)

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

capture_lead

Structured intake of a prospect into an SMB's funnel with validation and deduplication on (smb_id, phone or email). Stored in AgentBroker's own lead funnel, NOT the business's CRM; the business is not notified. [$0.05/per_call, not charged while no payment rail is on] [async→get_outcome] [beta]

Argument	Type	Description
smb_id*	string
source	string	Where the consumer-initiated request originated (e.g., 'consumer_request',…
prospect*	object
idempotency_key	string	Retry key: a 24h replay returns the original receipt, not re-run or charged.

Input schema (JSON)

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

check_booking_link

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]

read-only

Argument	Type	Description
url*	string	Full http(s) URL to classify, e.g. 'https://cal.com/jane' or…

Input schema (JSON)

{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "description": "Full http(s) URL to classify, e.g. 'https://cal.com/jane' or…"
    }
  }
}

check_compliance

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]

read-only

Argument	Type	Description
channel	string	Delivery channel. Omit to auto-infer sms/email from recipient_id; set 'voice'…
content*	string	The actual message body you intend to send. The gate classifies the real text,…
state_code	string	US state code (e.g. 'CA') for state-specific rules.
country_code	string	ISO 3166-1 alpha-2 (e.g. 'US', 'DE', 'CA'). Auto-inferred from phone if…
message_type	string	One of transactional, marketing, reminder, follow_up, notification (any case).…
recipient_id*	string	Phone in E.164 (e.g. '+14045550100') or email address the message would go to.

Input schema (JSON)

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

check_quota

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]

read-only

No arguments.

Input schema (JSON)

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

escalate_to_human

Hand off an in-flight task to a human operator with a context bundle (transcript, prior actions, identifiers, recommended next step). Writes a ticket to the operator queue; sends no notification, promises no response time. [$0.2/per_call, not charged while no payment rail is on] [async→get_outcome] [beta]

destructive

Argument	Type	Description
reason*	string
smb_id*	string
context*	object
priority	string
idempotency_key	string	Retry key: a 24h replay returns the original receipt, not re-run or charged.

Input schema (JSON)

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

find_business

Find real businesses near a place, sorted by distance (nearest of those examined; see result.search). Data: OpenStreetMap (ODbL, (c) OSM contributors); phone, website, hours only when mapped. Coverage varies; community-mapped, NOT verified by us; source=openstreetmap rows cannot be booked. Answers within about 5 s: status partial (search_in_progress) means repeat the call. If OSM is down: retriable 'temporarily unavailable', never invented rows. [free, no key] [beta]

read-only

Argument	Type	Description
city	string	Instead of location: a city, e.g. 'Muscat, Oman'.
region	string	With city: a state or region.
location*	object	City/town or ZIP, optionally with country ('Nizwa, Oman'). Geocoded by OSM.
vertical	string
capability	string	Kind of business: 'dentist', 'cafe', 'plumber'. Use it or vertical.
price_band	object	Supply-network rows only (OpenStreetMap has no prices).
max_results	integer
availability_window

get_conversation

Read a two-way conversation thread you started: its state, every message exchanged, and how many replies the business has sent. [free, requires key]

read-only

Argument	Type	Description
reference	string	The 4-digit request reference, e.g. '4821'. Requires business_number.
business_number	string	Scopes a `reference` to one business (references are reused across businesses).
conversation_id	string	From the send_message receipt (preferred).

Input schema (JSON)

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

get_outcome

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

read-only

Argument	Type	Description
operation_id*	string

Input schema (JSON)

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

get_status

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

read-only

Argument	Type	Description
operation_id*	string

Input schema (JSON)

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

handle_inbound

Classify an inbound message for an SMB and get a suggested_action for YOUR agent to act on. English keyword rules (booking request, cancellation, opt-out, inquiry, complaint): treat the intent as a hint. Opt-outs are recorded durably; nothing else is auto-routed or executed. [$0.03/per_call, not charged while no payment rail is on] [async→get_outcome] [beta]

Argument	Type	Description
sender	object
smb_id*	string
raw_message*	string
routing_rules	object	Optional override routing policy for this SMB
idempotency_key	string	Retry key: a 24h replay returns the original receipt, not re-run or charged.
inbound_channel*	string
received_at_iso	string

Input schema (JSON)

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

import_booking_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] [limited]

Argument	Type	Description
vertical	string	If omitted, inferred from the booking platform.
booking_url*	string	Full URL the user supplied. Must point at one of the 12 supported booking…
capabilities	array	Free-form capability tags (e.g., ['haircut','color','blowdry']).
country_code	string	ISO 3166-1 alpha-2 (e.g. 'US', 'FR'); routes compliance on later sends.
business_name	string	If omitted, auto-extracted from the page's <title> or og:title.
contact_email	string
contact_phone	string	If omitted, the platform integration handles outreach.
idempotency_key	string

lookup_us_contracts

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]

read-only

Argument	Type	Description
max_results	integer	Maximum number of contract awards to return (sorted by award amount…
company_name*	string	Company or recipient name to search for in US federal contract awards (e.g.…

Input schema (JSON)

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

map_trade_restriction

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, no key]

read-only

Argument	Type	Description
hs_code	string	Optional Harmonized System code (e.g. '8471.30' for laptops). If provided,…
parties	array	Optional list of party names to screen (exporter, importer, freight forwarder,…
product*	string	Product name or description, e.g. 'laptop computers', 'crude oil', 'medical…
origin_country	string	Optional ISO 3166-1 alpha-2 code for the exporting country (e.g. 'US', 'DE').…
destination_country*	string	ISO 3166-1 alpha-2 code for the importing country (e.g. 'IR', 'CA', 'DE').…

Input schema (JSON)

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

mint_key

Mint a free-tier API key without email by signing agent_id + timestamp + nonce with the MACHINE_MINT_SECRET (HMAC-SHA256). Refused without that secret (invalid_request); not_configured if the operator has none set. No secret: use POST /keys/request. [free, no key] [limited]

Argument	Type	Description
nonce*	string	Random value (UUID or hex). Prevents replay attacks — use a fresh nonce each…
agent_id*	string	A stable unique identifier for this agent (e.g. a UUID). The issued key is…
signature*	string	HMAC-SHA256(agent_id + str(timestamp) + nonce, MACHINE_MINT_SECRET) as…
timestamp*	integer	Unix epoch seconds at signing time. Must be within 60s of server time.

Input schema (JSON)

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

preview_cost

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]

read-only

Argument	Type	Description
params*	object	The same request body you would pass to the operation
operation*	string

Input schema (JSON)

{
  "type": "object",
  "required": [
    "operation",
    "params"
  ],
  "properties": {
    "params": {
      "type": "object",
      "description": "The same request body you would pass to the operation"
    },
    "operation": {
      "type": "string"
    }
  }
}

schedule_appointment

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, not charged while no payment rail is on] [async→get_outcome] [limited]

destructive

Argument	Type	Description
notes	string
action*	string
smb_id*	string
service	string
customer	object
requested_time	object
idempotency_key	string	Retry key: a 24h replay returns the original receipt, not re-run or charged.
existing_appointment_id	string	Required for cancel

screen_sanctions

Free screening of a name/entity (Latin or Arabic script) 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, no key]

read-only

Argument	Type	Description
name*	string	Name of the person or entity to screen, in Latin or Arabic script, e.g. 'Kim…
type	string	Optional entity type hint. 'person' for individuals, 'entity' for…
country	string	Optional ISO 3166-1 alpha-2 country code or country name (e.g. 'IR', 'Iran').…

Input schema (JSON)

{
  "type": "object",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Name of the person or entity to screen, in Latin or Arabic script, e.g. 'Kim…"
    },
    "type": {
      "enum": [
        "person",
        "entity"
      ],
      "type": "string",
      "description": "Optional entity type hint. 'person' for individuals, 'entity' for…"
    },
    "country": {
      "type": "string",
      "description": "Optional ISO 3166-1 alpha-2 country code or country name (e.g. 'IR', 'Iran').…"
    }
  }
}

self_test

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]

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "properties": {}
}

send_message

Send a message on behalf of an agent's user or an SMB across WhatsApp (free during launch), SMS, email, or voice, sent immediately, no scheduling. Every send passes a non-bypassable gate: TCPA, GDPR, CASL where modeled, else the service's own opt-in default (the Gulf included). Marketing on SMS, voice, WhatsApp and non-US email without recorded opt-in is rejected (compliance_violation receipt). US marketing email follows CAN-SPAM opt-out rules. [from $0.02/call, variable, not charged while no payment rail is on] [async→get_outcome] [Not available on this deployment: SMS, Voice.]

destructive

Argument	Type	Description
content*	object
recipient*	object
business_id	string	Stable id for the recipient business; used for global demand shaping.
message_type*	string	'marketing' needs recorded opt-in, except US email (CAN-SPAM opt-out rules).…
on_behalf_of	string	Who this message is FOR (your end-user's name/label). On WhatsApp this opens a…
idempotency_key	string	Retry key: a 24h replay returns the original receipt, not re-run or charged.
preferred_channel

send_transactional_confirmation

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, not charged while no payment rail is on] [async→get_outcome] [Not available on this deployment: SMS.]

destructive

Argument	Type	Description
data*	object	Type-specific payload; e.g., {otp_code} for otp, {appointment_time, smb_name}…
recipient*	object
idempotency_key	string	Retry key: a 24h replay returns the original receipt, not re-run or charged.
confirmation_type*	string
preferred_channel	string

Input schema (JSON)

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

verify_business

Look up what we know about a business in our supply network: contact channels, capabilities, last verification. A DIRECTORY LOOKUP - it does not contact the business. Supply-network ids only, not osm:... ids. [free, no key] [limited]

read-only

Argument	Type	Description
smb_id*	string
capability_to_verify	string

Input schema (JSON)

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

verify_company_record

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, no key]

read-only

Argument	Type	Description
lei	string	Optional 20-character Legal Entity Identifier for a direct, precise lookup.
name*	string	Legal company name to look up, e.g. Apple Inc or Volkswagen AG.
country	string	Optional ISO 3166-1 alpha-2 country filter (e.g. US, DE, GB). Narrows GLEIF…

Input schema (JSON)

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

Agent Broker

Try it

call_business Destructive

Agent Broker

Try it

call_business Destructive

Tools (23)