📞 Phone Lookup MCP — x402 Powered

Reverse phone number lookup for AI agents. Single Vercel deployment. Agents pay per call in USDC on Base — no API keys, no subscriptions.

Live MCP Endpoint

https://phone-lookup-mcp.vercel.app/api/mcp

Connect to Claude Desktop

{
  "mcpServers": {
    "phone-lookup": {
      "url": "https://phone-lookup-mcp.vercel.app/api/mcp"
    }
  }
}

Connect to Cursor / Windsurf / Codex

Add the URL https://phone-lookup-mcp.vercel.app/api/mcp as a remote MCP server in settings.

Tools

| Tool | Returns | Price | |------|---------|-------| | phone_lookup_basic | Valid flag, country, carrier, line type | $0.002 USDC | | phone_lookup_standard | + Registered caller name (CNAM) | $0.015 USDC | | phone_lookup_premium | + Identity match, address, DOB | $0.120 USDC |

Payment Flow

1. Agent calls a tool
2. Server returns HTTP 402 with your Base wallet + price
3. Agent signs USDC transfer on Base mainnet
4. Server verifies → runs lookup → returns data
5. USDC settles to your wallet instantly

Deploy Your Own

1. Fork this repo

2. Set Vercel environment variables

WALLET_ADDRESS       = 0xYourBaseWalletAddress
VERIPHONE_API_KEY    = your_key
TWILIO_ACCOUNT_SID   = ACxxxxxxxx
TWILIO_AUTH_TOKEN    = your_token

3. Connect GitHub → Vercel

Import repo at vercel.com/new — deploy fires automatically.

4. Add GitHub Secrets for CI/CD

VERCEL_TOKEN
VERCEL_ORG_ID
VERCEL_PROJECT_ID

Margins

| Tier | Charge | Cost | Margin | |------|--------|------|--------| | Basic | $0.002 | ~$0.00058 | ~71% | | Standard | $0.015 | ~$0.010 | ~33% | | Premium | $0.120 | ~$0.100 | ~17% |

Publish

• mcp.so/submit
• mcpmarket.com/submit
• x402 Bazaar (auto-indexed via middleware)