Integration

CallerAPI integration

CallerAPI scores phone numbers for spam and fraud. Look up a number's spam score, complaints, business owner and carrier (with an optional live HLR check), read its last port date or full porting history, see which online services it is registered with, match a person's name, birth date and address against the mobile operator's records (KYC), and classify a call transcript or recording as a scam. Read the account's credit balance, recent voice firewall sessions, verdict categories and honeypot personas, the STIR/SHAKEN signer reputation table, and (enterprise plans) the daily verified spam reports and their webhook subscriptions. Most lookups are billed per request. The Twilio and Telnyx call-control URLs (they answer XML), the live audio WebSocket streams, the CSV spam snapshot, the logo image route, the data-partner upload routes, the manual webhook dispatch and the Business Caller ID announce route (it uses a separate publish token) are not exposed. Authentication is an API key sent in the x-auth header.

Connect CallerAPI How integrations work

Ask it in chat

Say what should happen.
The workflow builds itself.

When this happens, do that in CallerAPI.Built from the 20 CallerAPI tools below, on the connection you add once.

What you can do with CallerAPI

Each of these is one operation on one endpoint, available both as a workflow step and as a tool an AI agent can call on its own. Nothing bundles several operations into one action, so what a run did stays readable afterwards.

Most endpoints run on the free plan. A few, mainly the ones that publish on your behalf, need a paid plan.

Session, 2 operations

get_voice_sessionGet voice sessionGETReturns one voice firewall session with its full verdict and intel objects. Use it to recover a missed webhook event or to answer a dispute. Free.
list_voice_sessionsList voice sessionsGETLists the voice firewall sessions (filter, honeypot and scan) that belong to this API key, newest first, with score, level, category and summary. Pass a session id to get_voice_session for the full verdict and intel. Free.

Signer reputation, 2 operations

get_signer_reputationGet signer reputationGETReturns the STIR/SHAKEN reputation of one call signer: score 0 to 100 (higher is worse), band, confidence, and counts of verified, failed, rejected and spam-matching calls.
list_signer_reputationsList signer reputationsGETLists STIR/SHAKEN call signers ranked by reputation score (0 to 100, higher is worse), each with its SPC, organisation name, band, confidence and call counts.

Subscribe, 2 operations

subscribe_spam_report_webhookSubscribe spam report webhookPOSTEnterprise plans only. Subscribes a URL to the daily spam reports webhook: each day CallerAPI posts the verified complaints to it, signed with HMAC-SHA256 of the delivery id using your API key.
unsubscribe_spam_report_webhookUnsubscribe spam report webhookDELETEEnterprise plans only. Removes a URL's subscription to the daily spam reports webhook. Pass the same url as when subscribing.

Capability, 1 operation

get_voice_capabilitiesGet voice capabilitiesGETReports which voice firewall products are on for this key (scan, live_filter, honeypot, transcription) and the credit prices in force, including the cost of one scan_call. Free.

Category, 1 operation

list_verdict_categoriesList verdict categoriesGETLists every value a verdict's category can take, with a label and description. The values are CallerAPI complaint subjects, the same strings lookup_phone_number shows on complaints; none means a clean call. Free.

Daily, 1 operation

list_daily_spam_reportsList daily spam reportsGETEnterprise plans only. Returns one page of the day's verified spam complaints for a country (phone number, dates, subject, comment), with total and next_update. Flat pricing, not billed per request.

Kyc, 1 operation

verify_phone_identityVerify phone identityPOSTMatches a person's name (required), birth date, address and email against the mobile operator's records for the number. Each *_score is 100 exact, 75 strong, 50 partial, 1 weak, 0 no match, -1 no data. EUR 0.30 per call.

Lookup, 1 operation

lookup_phone_numberLookup phone numberGETReturns a number's spam_score (0 to 100), is_spam, reputation, entity_type (BUSINESS, SPAM or UNKNOWN), filed complaints, business_info and carrier_info. Set hlr=true for a live HLR check. Billed per lookup.

Me, 1 operation

get_account_balanceGet account balanceGETReturns the account's email and credit balance: credits_left, credits_spent and credits_monthly. Free.

Online presence, 1 operation

get_phone_online_presenceGet phone online presenceGETReturns, per online service (WhatsApp, Telegram, Facebook, Google, LinkedIn, Office365 and others), a code saying whether the number is registered there. Costs EUR 0.15 per lookup.

Persona, 1 operation

list_honeypot_personasList honeypot personasGETLists the honeypot personas (id, name, age, archetype, language, greeting) the voice firewall honeypot can answer calls with. Free.

Ported, 1 operation

get_phone_ported_dateGet phone ported dateGETReturns whether a number was ported to another carrier and its last port date (ported_date). Useful to spot a recent port-out or SIM swap. Costs EUR 0.008 per lookup.

Porting history, 1 operation

get_phone_porting_historyGet phone porting historyGETReturns every past porting event of a number (porting_history: action, network, timestamp) plus its last port date. Costs EUR 0.02 per lookup; get_phone_ported_date is cheaper when only the last date matters.

Scan, 1 operation

scan_callScan callPOSTClassifies one finished call as a scam or not. Send either transcript or audio_base64, not both. Returns verdict (score 0 to 1, level, category, tactics) and intel. Costs 2 credits, plus 1 per started audio minute.

Subscription, 1 operation

list_spam_report_webhooksList spam report webhooksGETEnterprise plans only. Lists the URLs subscribed to the daily spam reports webhook, with id, active flag and creation date.

Test, 1 operation

test_spam_report_webhookTest spam report webhookPOSTEnterprise plans only. Sends a sample complaints list to a URL once, so you can test parsing and signature checking on your side. It does not create a subscription.

Verify, 1 operation

verify_calling_numberVerify calling numberPOSTBusiness Caller ID check for a telco: says whether the registered owner of the calling number announced this exact call. verdict is verified, spoofed, unverified or unregistered; action is allow or drop. Free.

Use CallerAPI from Claude Code, Cursor or Codex

Connect CallerAPI in LiveContext, create an API key in Settings, then add the LiveContext MCP server to your client. Its CallerAPI operations become tools the client can call, next to every other integration you connected.

Claude Code

claude mcp add --transport http livecontext https://livecontext.ai/mcp --header "X-API-Key: YOUR_API_KEY"

Codex (~/.codex/config.toml)

[mcp_servers.livecontext]
url = "https://livecontext.ai/mcp"

[mcp_servers.livecontext.http_headers]
"X-API-Key" = "YOUR_API_KEY"

Cursor, Claude Desktop and other JSON configs

{
  "mcpServers": {
    "livecontext": {
      "type": "http",
      "url": "https://livecontext.ai/mcp",
      "headers": {
        "X-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

Set up the MCP server step by step

How to connect CallerAPI

Create your workspace
Sign up free. Nothing to install.
Connect CallerAPI once
Add your CallerAPI connection in Settings. Every tool from this integration reuses it, and secrets are encrypted at rest and visible only to you.
Describe the job in chat
The workflow builds itself in front of you and picks the endpoints it needs. Drag the steps yourself on the canvas whenever you would rather be explicit.