Numbers Online — phone intelligence: Claude Code MCP server
Hosted MCP server that delivers phone intelligence for voice AI agents. Checks line types and spam risk before an agent dials.
claude mcp add --transport http numbers-online https://numbers.online/api/v1/mcpWhat Numbers Online — phone intelligence does
The server operates remotely over Streamable HTTP at https://numbers.online/api/v1/mcp. Nothing runs locally. Tool discovery works publicly, but executing actual lookups requires a Bearer token with the mcp scope. Raw phone numbers are never stored in plain text; the system stores only their SHA-256 hashes.
Four read-only tools are exposed: phone_lookup, caller_risk, line_type, and dnc_check. Deterministic line checks and first-party suppression lookups are free, while deep risk analysis is metered per call. Every billable response can return an Ed25519 signed receipt to verify when the check took place.
The do-not-contact signal reflects verified requests registered directly by number owners, not official government registries. Output data is advisory, so the calling agent keeps full ownership of dialing logic and regulatory compliance.
What it helps with
- verify line type and carrier before spending agent minutes
- inspect caller reputation and STIR/SHAKEN status on inbound calls
- query internal owner-submitted do-not-contact preferences
- obtain signed Ed25519 receipts without exposing raw phone numbers
Example prompts for the agent
- Check line type and carrier for
+14155552671usingline_type. - Run
caller_riskon inbound number+14155552671to assess spam likelihood. - Perform a full
phone_lookupon+14155552671before placing the outbound call.
How to install Numbers Online — phone intelligence
Platform CLI: remote server
claude mcp add --transport http numbers-online https://numbers.online/api/v1/mcpPlatform CLI: remote server
codex mcp add numbers-online-phone-intelligence --url https://numbers.online/api/v1/mcpConfig file
{
"mcpServers": {
"numbers-online-phone-intelligence": {
"url": "https://numbers.online/api/v1/mcp"
}
}
}Config file
{
"servers": {
"numbers-online-phone-intelligence": {
"type": "http",
"url": "https://numbers.online/api/v1/mcp"
}
}
}Platform CLI: remote server
gemini mcp add -t http numbers-online-phone-intelligence https://numbers.online/api/v1/mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Numbers Online — phone intelligence
How to install Numbers Online — phone intelligence in Claude Code?
Register the remote endpoint with claude mcp add --transport http numbers-online-phone-intelligence https://numbers.online/api/v1/mcp. For active tool calls, provide an API key in the authorization header.
What tools are included in the server?
It provides line_type and dnc_check at no cost, alongside metered caller_risk and phone_lookup tools. Together they report carrier data, line validity, reputation signals, and cryptographic receipts.
Does the DNC signal replace official government registries?
No, it strictly reflects suppression requests submitted directly by number owners to Numbers Online. It acts as an extra safety signal rather than legal proof of compliance.
