{"uid":"cap_6w3kOKI_LCaMz0bNylq_8","slug":"phone-intel-mcp-fde77968","name":"Phone Intel MCP","description":"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.","url":"https://phone-intel-mcp.fly.dev/lookup/%7Bphone%7D?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"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"}}}}},"responseSchema":{"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"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.03","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.03/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_LX_bxHKLKAbF6XkzFGi-9","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.03","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Looks up a US phone number and returns a comprehensive dossier including carrier, caller name, business match, spam risk score, and number classification.","exampleAgentPrompt":"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?","exampleUseCases":[{"title":"Spam call triage before callback","prompt":"Before I call back this missed call from +17185559823, can you check if it's a known robocall, what its spam risk score is, and whether it's associated with a real business?"},{"title":"Lead verification for sales CRM","prompt":"I've got a new lead with phone number +16465551047 — can you tell me if it's a real business number, what company it belongs to, what carrier it's on, and whether it's VoIP?"},{"title":"Identify unknown caller for customer support","prompt":"A customer called in from +15165554321 and didn't leave a name — can you pull up the caller name, business match, and address associated with that number so I can follow up?"}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-20T12:33:13.016Z","isFirstParty":false,"canonicalSlug":"phone-intel-mcp-fde77968"}