# Numbers Online — phone intelligence

Hosted MCP server that delivers phone intelligence for voice AI agents. Checks line types and spam risk before an agent dials.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: numbers-online
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/numbers-online/numbers-online-mcp
- Updated: 2026-06-16
- HTML: https://affpapa.org/en/nevibecode/mcp/numbers-online-phone-intelligence

## What it 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.

## Requirements
- Remote server: `https://numbers.online/api/v1/mcp`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http numbers-online https://numbers.online/api/v1/mcp
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add numbers-online-phone-intelligence --url https://numbers.online/api/v1/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "numbers-online-phone-intelligence": {
            "url": "https://numbers.online/api/v1/mcp"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "numbers-online-phone-intelligence": {
            "type": "http",
            "url": "https://numbers.online/api/v1/mcp"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http numbers-online-phone-intelligence https://numbers.online/api/v1/mcp
```

## When to use it
- 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
- Check line type and carrier for `+14155552671` using `line_type`.
- Run `caller_risk` on inbound number `+14155552671` to assess spam likelihood.
- Perform a full `phone_lookup` on `+14155552671` before placing the outbound call.

## Similar
- [ElevenLabs Agents](https://affpapa.org/en/nevibecode/mcp/elevenlabs-agents.md) — MCP server · ★ 13
- [create-phone-number](https://affpapa.org/en/nevibecode/skills/create-phone-number.md) — skill · 947 installs
- [phone-calls](https://affpapa.org/en/nevibecode/skills/phone-calls.md) — skill · 380 installs
- [Deyaho Phone Calls MCP](https://affpapa.org/en/nevibecode/mcp/deyaho-phone-calls-mcp.md) — MCP server
- [twilio-lookup-phone-intelligence](https://affpapa.org/en/nevibecode/skills/twilio-lookup-phone-intelligence.md) — skill · ★ 7624
- [aiconfig-online-evals](https://affpapa.org/en/nevibecode/skills/aiconfig-online-evals.md) — skill · 2700 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md