Numbers Online — phone intelligence
Description
Read-only phone intelligence for AI agents: validity, line type, range carrier, country, caller name (CNAM), STIR/SHAKEN verstat, a labeled spam signal, and a first-party do-not-contact (DNC) signal, with Ed25519-signed receipts. Every field is a supplementary, low-confidence signal; the calling agent keeps every routing and dialing decision.
Skills
Phone number intelligence
phone_lookupReturn a supplementary, low-confidence intelligence bundle for a phone number: validity, formatting, line type, range carrier, country, caller name (CNAM where available), STIR/SHAKEN verstat, a labeled spam signal, and a first-party do-not-contact (DNC) signal — a suppression preference registered by the number's own owner, never a copy of any government registry. Advisory only.
Line type
line_typeReturn only the deterministic fields for a number — validity, line type (mobile / fixed line / VoIP / …), range carrier, country, and formatting. Free, fast classification; no paid dip.
Caller risk signal
caller_riskReturn a labeled, low-confidence risk read for an inbound caller: a spam signal (0–100, higher = riskier), verstat passthrough, and a first-party do-not-contact (DNC) signal — without a name dip. A supplementary input to the agent's own policy, never a verdict on whether to accept or reject a call.
Do-not-contact supplementary signal
dnc_checkReturn a first-party do-not-contact signal (suppress / no_match / unknown) for a number, sourced ONLY from suppression preferences registered and verified by the number's own owner inside Numbers Online — never a copy of any government or licensed do-not-call registry. Comes with a signed receipt recording the status "as of T". Advisory only.
System Capabilities
Input Modes
Output Modes
Streaming
✗ Not supportedCategory
General / GeneralOpenAPI/Endpoint URL
https://numbers.online/api/v1/a2aAgent Card Schema
This manifest contains structural definitions, parameters, and metadata endpoints.
{
"display_name": "Numbers Online — phone intelligence",
"description": "Read-only phone intelligence for AI agents: validity, line type, range carrier, country, caller name (CNAM), STIR/SHAKEN verstat, a labeled spam signal, and a first-party do-not-contact (DNC) signal, with Ed25519-signed receipts. Every field is a supplementary, low-confidence signal; the calling agent keeps every routing and dialing decision.",
"manifest_url": "https://numbers.online/.well-known/agent-card.json",
"openapi_url": "https://numbers.online/api/v1/a2a",
"version": "1.0.0",
"category": "General",
"target_audience": "General",
"capabilities": {
"streaming": false,
"pushNotifications": false,
"stateTransitionHistory": false
},
"skills": [
{
"id": "phone_lookup",
"name": "Phone number intelligence",
"description": "Return a supplementary, low-confidence intelligence bundle for a phone number: validity, formatting, line type, range carrier, country, caller name (CNAM where available), STIR/SHAKEN verstat, a labeled spam signal, and a first-party do-not-contact (DNC) signal — a suppression preference registered by the number's own owner, never a copy of any government registry. Advisory only.",
"tags": [
"phone",
"telephony",
"caller-id",
"cnam",
"line-type",
"spam",
"dnc",
"e164"
],
"examples": [
"Look up +14155552671",
"What do you know about +442071838750?"
],
"inputModes": [
"text/plain"
],
"outputModes": [
"application/json",
"text/plain"
]
},
{
"id": "line_type",
"name": "Line type",
"description": "Return only the deterministic fields for a number — validity, line type (mobile / fixed line / VoIP / …), range carrier, country, and formatting. Free, fast classification; no paid dip.",
"tags": [
"phone",
"line-type",
"carrier",
"e164"
],
"examples": [
"Is +14155552671 a mobile or landline?"
],
"inputModes": [
"text/plain"
],
"outputModes": [
"application/json",
"text/plain"
]
},
{
"id": "caller_risk",
"name": "Caller risk signal",
"description": "Return a labeled, low-confidence risk read for an inbound caller: a spam signal (0–100, higher = riskier), verstat passthrough, and a first-party do-not-contact (DNC) signal — without a name dip. A supplementary input to the agent's own policy, never a verdict on whether to accept or reject a call.",
"tags": [
"phone",
"spam",
"risk",
"stir-shaken",
"dnc"
],
"examples": [
"How risky is an inbound call from +14155552671?"
],
"inputModes": [
"text/plain"
],
"outputModes": [
"application/json",
"text/plain"
]
},
{
"id": "dnc_check",
"name": "Do-not-contact supplementary signal",
"description": "Return a first-party do-not-contact signal (suppress / no_match / unknown) for a number, sourced ONLY from suppression preferences registered and verified by the number's own owner inside Numbers Online — never a copy of any government or licensed do-not-call registry. Comes with a signed receipt recording the status \"as of T\". Advisory only.",
"tags": [
"phone",
"dnc",
"tcpa",
"suppression",
"consent"
],
"examples": [
"Has +14155552671 registered a do-not-contact preference?"
],
"inputModes": [
"text/plain"
],
"outputModes": [
"application/json",
"text/plain"
]
}
],
"default_input_modes": [
"text/plain"
],
"default_output_modes": [
"application/json",
"text/plain"
],
"extra": {
"protocolVersion": "0.3.0",
"preferredTransport": "JSONRPC",
"documentationUrl": "https://numbers.online/docs",
"iconUrl": "https://numbers.online/android-chrome-512x512.png",
"provider": {
"organization": "Numbers Online",
"url": "https://numbers.online"
},
"securitySchemes": {
"apiKey": {
"type": "http",
"scheme": "bearer",
"description": "A Numbers Online API key with the agent (mcp) use case. Get one at numbers.online."
}
},
"security": [
{
"apiKey": []
}
]
},
"found": true,
"strategy": "manifest-a2a",
"protocol_std": "a2a"
}Actions
The **Agent Card** is a standardized JSON metadata schema containing the agent's capabilities, default inputs/outputs, and OpenAPI endpoints. Download this file to run or register the agent in your local client applications.