# Phone Intel MCP

> Phone Intel MCP is a paid API for AI agents from phone-intel-mcp.fly.dev, paid per call via x402, $0.03/call, status unknown (last checked 2026-11-20).

Looks up a US phone number and returns a comprehensive dossier including carrier, caller name, business match, spam risk score, and number classification.

## Facts

- Endpoint: GET https://phone-intel-mcp.fly.dev/lookup/%7Bphone%7D?utm_source=zero.xyz
- Price: $0.03/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-20
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/phone-intel-mcp-fde77968
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_6w3kOKI_LCaMz0bNylq_8

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability phone-intel-mcp-fde77968
```

Example prompt: Can you look up +15165550100 and tell me what carrier it's on, whether it's a business or personal number, if there's a business match, and what the spam risk score is?

## When to prefer this

Choose this endpoint when you need a comprehensive single-call phone intelligence dossier for a US number — combining carrier, caller identity, business entity data, and spam/robocall signals in one response. It is especially well-suited when you need both telecom metadata (carrier type, VoIP risk) and real-world business enrichment (hours, rating, address) from one lookup. It costs $0.03 USDC per call settled on-chain, making it appropriate for per-record enrichment workflows rather than bulk batch lookups. Prefer it over separate carrier and spam APIs when you need consolidated intelligence quickly.

## Known failure modes

- Non-US or non-E.164 formatted numbers return a 400 validation error
- Payment not settled on-chain results in 402 Payment Required
- Phone number not found in any database may return null fields for caller_name and business_match
- DNC status may return null if registry data is unavailable
- Rate limiting or network errors at fly.dev may return 5xx responses
- Cached fields (noted in meta.cached_fields) may be slightly stale

## How this service works

US phone number intelligence (carrier, business match, spam risk, number classification) returned as a single dossier. One lookup = 0.03 USDC on Base, settled on-chain via x402.

## Output

A JSON dossier containing: the normalized phone number, carrier name and type (landline/mobile/VoIP), caller name, business match details (name, address, hours, rating, Yelp/Google IDs, open-now status, category), reputation signals (spam risk score 0–10, robocall flag, VoIP risk flag, DNC status), number classification (business/personal/etc.), and metadata including lookup ID, timestamp, schema version, and which fields were cached.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "method",
    "type",
    "pathParams"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD"
     ],
     "type": "string"
    },
    "pathParams": {
     "type": "object",
     "required": [
      "phone"
     ],
     "properties": {
      "phone": {
       "type": "string",
       "pattern": "^\\+1\\d{10}$",
       "description": "US phone number, URL-encoded E.164 preferred (+15165551234). Dashed and parenthesized formats are normalized server-side."
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "meta": {
   "lookup_id": "3f0c7a52-6a52-4b8e-9d3b-0f6f1f6d2a11",
   "timestamp": "2026-10-28T14:03:11.482Z",
   "cached_fields": [
    "carrier",
    "reputation"
   ],
   "schema_version": "v1"
  },
  "phone": "+15165551234",
  "carrier": {
   "name": "Spectrum Business",
   "type": "landline"
  },
  "reputation": {
   "is_voip_risk": false,
   "is_dnc_listed": null,
   "spam_risk_score": 3,
   "is_known_robocall": false
  },
  "caller_name": "GARDEN CITY HARDWARE",
  "business_match": {
   "name": "Garden City Hardware",
   "hours": {
    "monday": [
     {
      "open": "07:30",
      "close": "18:00"
     }
    ]
   },
   "rating": {
    "count": 212,
    "stars": 4.6
   },
   "address": {
    "city": "Garden City",
    "line1": "100 Franklin Ave",
    "state": "NY",
    "postal": "11530"
   },
   "yelp_id": "garden-city-hardware-garden-city",
   "category": "Hardware Stores",
   "place_id": "ChIJ-example-place-id",
   "is_open_now": true
  },
  "number_classification": "business"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/phone-intel-mcp-fde77968/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from phone-intel-mcp.fly.dev](https://www.zero.xyz/host/phone-intel-mcp.fly.dev/llms.txt)
