# lookup

A hosted MCP server that answers whether a number is worth dialing or texting right now: carrier, line type, spam reputation, SMS deliverability.

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

## What it does

The server lives at `https://verirouteintel.com/api/mcp` and speaks Streamable HTTP with JSON-RPC 2.0; requests carry `Authorization: Bearer <key>`. There is nothing to run locally — your client talks to the remote endpoint. For CI or clients that cannot do remote MCP, an npm shim called `veriroute-intel-mcp` forwards calls to the same host.

Six tools ship with it. `vri_number_lookup` covers a single number: carrier of record, line type, LRN routing, porting date, plus optional CNAM and reputation. `vri_spam_check` reports spam and robocall complaints. `vri_sms_deliverability` returns one verdict for outreach: will the number take an SMS, and is the timing reasonable. Bulk work goes through `vri_bulk_lookup` (up to 100 numbers per call), `vri_submit_job` (async job up to 10,000 numbers) and `vri_bulk_status` for progress.

A key is required before any tool call — discovery alone works without one. Sandbox test keys return sample data and cost nothing, while live keys draw on a prepaid balance at REST API rates. Failed lookups are not billed, and a call that would overrun the balance is refused up front.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://verirouteintel.com/api/mcp`
- Environment variables: `VRI_API_KEY` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

1. **Platform CLI**
```bash
claude mcp add lookup -e VRI_API_KEY=<VRI_API_KEY> -- npx -y veriroute-intel-mcp
```
Replace <…> with your own values

2. **Platform CLI: remote server**
```bash
claude mcp add --transport http lookup https://verirouteintel.com/api/mcp
```

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add lookup --url https://verirouteintel.com/api/mcp
```

2. **Platform CLI**
```bash
codex mcp add lookup --env VRI_API_KEY=<VRI_API_KEY> -- npx -y veriroute-intel-mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "lookup": {
            "url": "https://verirouteintel.com/api/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "lookup": {
            "command": "npx",
            "args": [
                "-y",
                "veriroute-intel-mcp"
            ],
            "env": {
                "VRI_API_KEY": "<VRI_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "lookup": {
            "type": "http",
            "url": "https://verirouteintel.com/api/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "lookup": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "veriroute-intel-mcp"
            ],
            "env": {
                "VRI_API_KEY": "<VRI_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http lookup https://verirouteintel.com/api/mcp
```

2. **Platform CLI**
```bash
gemini mcp add -e VRI_API_KEY=<VRI_API_KEY> lookup npx -y veriroute-intel-mcp
```
Replace <…> with your own values

## When to use it
- scrub a dialing list and drop dead or VoIP lines
- find out whether your outbound caller ID is tagged as spam
- confirm a number accepts SMS before starting a campaign
- refresh CRM records with current carrier and line type
- run a 10,000-number batch as a background job

## Example prompts
- Check +1 555 010 0199 — carrier, line type and any spam complaints
- Is it a good time to text this number?
- Start a bulk lookup on `leads.csv` and show me the progress

## Similar
- [twilio-lookup-phone-intelligence](https://affpapa.org/en/nevibecode/skills/twilio-lookup-phone-intelligence.md) — skill · ★ 7604
- [rcs-agent-onboarding](https://affpapa.org/en/nevibecode/skills/rcs-agent-onboarding.md) — skill · 2900 installs
- [telnyx](https://affpapa.org/en/nevibecode/mcp/telnyx.md) — MCP server · ★ 198
- [database-lookup](https://affpapa.org/en/nevibecode/skills/database-lookup.md) — skill · 2100 installs
- [sms-10dlc-registration](https://affpapa.org/en/nevibecode/skills/sms-10dlc-registration.md) — skill · 2900 installs
- [klaviyo](https://affpapa.org/en/nevibecode/skills/klaviyo.md) — skill · 517 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