About lookup
lookup is a hosted MCP server for agents that need current phone-number intelligence in the U.S. and Canada. It provides network, caller ID, spam, and SMS checks, including bulk and asynchronous jobs.
Key features
- 01Look up carrier and line details
- 02Check spam and scam reputation
- 03Assess SMS deliverability and timing
- 04Query up to 100 numbers in bulk
- 05Submit and track large async jobs
Use cases
- 01Clean call lists before dialing
- 02Check outbound caller ID spam labeling
- 03Verify line type before SMS outreach
- 04Enrich CRM records with carrier data
MCP support
The hosted MCP server exposes phone-number lookup, spam, SMS deliverability, bulk lookup, and asynchronous job tools. Clients connect over Streamable HTTP using a bearer API key; a local stdio shim is also available.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://verirouteintel.com/api/mcpclaude mcp add --transport http com-verirouteintel-lookup https://verirouteintel.com/api/mcp{"mcpServers":{"com-verirouteintel-lookup":{"type":"http","url":"https://verirouteintel.com/api/mcp"}}}Open in Cursor{"servers":{"com-verirouteintel-lookup":{"type":"http","url":"https://verirouteintel.com/api/mcp"}}}Open in VS Code{"mcpServers":{"com-verirouteintel-lookup":{"type":"http","url":"https://verirouteintel.com/api/mcp"}}}{"mcpServers":{"com-verirouteintel-lookup":{"serverUrl":"https://verirouteintel.com/api/mcp"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
https://verirouteintel.com/api/mcpAuth requiredTools
10| Parameter | Type | Required | Description |
|---|---|---|---|
| max_cost | number | No | Maximum quoted cost in USD; rejected before lookup if exceeded. |
| products | array | No | Data sets to include. Default ['lrn'] (carrier/line-type/routing). |
| request_id | string | No | Stable unique ID for this operation. Reuse with identical arguments to retrieve its receipt without another charge. |
| phone_number | string | Yes | US/Canada number, any common format |
| include_sms_assessment | boolean | No | Include SMS assessment from this same lookup. Adds LRN/spam if absent; no second lookup. |
Details
From the project READMEVeriRoute Intel MCP Server
Tells your agent whether a number is safe to call or text right now. Live reads of the U.S. and Canadian phone networks — carrier of record, line type, LRN, CNAM caller ID, spam/scam reputation, SMS deliverability, and a TCPA 8 a.m.–9 p.m. calling-window verdict — plus bulk lookups. Every query gets a fresh dip, never stale cached data. Free sandbox key, no card required. Pay per lookup with no minimums.
This is a hosted (remote) MCP server — nothing to install or run.
- Endpoint:
https://verirouteintel.com/api/mcp(Streamable HTTP, JSON-RPC 2.0) - Auth:
Authorization: Bearer <your VeriRoute Intel API key> - Docs: https://verirouteintel.com/api-docs/mcp
- Get a key: https://verirouteintel.com/dashboard/api-keys — free sandbox test keys return deterministic sample data with zero charges, perfect for wiring an agent up before funding.
Connect
Claude Code (CLI)
claude mcp add --transport http vri https://verirouteintel.com/api/mcp \
--header "Authorization: Bearer YOUR_API_KEY"
Claude.ai / Claude Desktop
Add a custom connector with URL https://verirouteintel.com/api/mcp and header
Authorization: Bearer YOUR_API_KEY.
Cursor and other MCP clients (mcp.json)
{
"mcpServers": {
"vri": {
"url": "https://verirouteintel.com/api/mcp",
"headers": { "Authorization": "Bearer YOUR_API_KEY" }
}
}
}
Tools
| Tool | What it does |
|---|---|
vri_number_lookup | Live intelligence for one number: carrier, line type, LRN routing, porting date; optional CNAM, spam reputation, messaging provider |
vri_spam_check | Spam / scam / robocall reputation for one number |
vri_sms_deliverability | One verdict for outreach agents: can this number receive SMS, and is now a reasonable time to send? Line type, VoIP flag, spam reputation, and the recipient's approximate local time with an 8am–9pm calling-window flag |
vri_bulk_lookup | Up to 100 numbers in one call |
vri_submit_job | Submit an async bulk job (up to 10,000 numbers); balance reserved up front |
vri_bulk_status | Progress of one of your bulk jobs |
Billing
Live keys pay the same per-lookup rates as the REST API from a prepaid balance. Every result reports what it cost; failed lookups are never charged, and a call that would exceed your available balance is refused up front.
Use cases
- Clean calling lists before dialing (dead/ported/VoIP detection)
- Check your own outbound caller IDs for "Spam Likely" labeling
- Verify line type before sending SMS
- Enrich CRM records with live carrier data — from inside an agent workflow
© First Light Holdings, LLC, DBA VeriRoute Intel · Terms · Privacy
Directories
Published in the Official MCP Registry as com.verirouteintel/lookup · Smithery · MCP.so
Local stdio (CI, offline, or clients without remote MCP)
A zero-dependency Node shim, published to npm, forwards to the hosted server:
VRI_API_KEY=YOUR_API_KEY npx veriroute-intel-mcp
Or in an mcp.json-style client config:
{
"mcpServers": {
"vri": {
"command": "npx",
"args": ["-y", "veriroute-intel-mcp"],
"env": { "VRI_API_KEY": "YOUR_API_KEY" }
}
}
}
Discovery works without a key; tool calls need one (free sandbox test keys return sample data with zero charges). Prefer the hosted endpoint whenever your client supports remote MCP.
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.