mcpField
L
lookup

lookup

Remote
verirouteintel.comCommunication0Updated 7w ago

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

  1. 01Look up carrier and line details
  2. 02Check spam and scam reputation
  3. 03Assess SMS deliverability and timing
  4. 04Query up to 100 numbers in bulk
  5. 05Submit and track large async jobs

Use cases

  1. 01Clean call lists before dialing
  2. 02Check outbound caller ID spam labeling
  3. 03Verify line type before SMS outreach
  4. 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.

Endpointhttps://verirouteintel.com/api/mcp
Copy install command
Claude CodeTerminal
Cursor.cursor/mcp.json
VS Code.vscode/mcp.json
Claude Desktopclaude_desktop_config.json
Windsurf~/.codeium/windsurf/mcp_config.json

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.

All endpoints
Streamable HTTPhttps://verirouteintel.com/api/mcpAuth required
Packages
npmveriroute-intel-mcp1.2.2

Tools

10
ParameterTypeRequiredDescription
max_costnumberNoMaximum quoted cost in USD; rejected before lookup if exceeded.
productsarrayNoData sets to include. Default ['lrn'] (carrier/line-type/routing).
request_idstringNoStable unique ID for this operation. Reuse with identical arguments to retrieve its receipt without another charge.
phone_numberstringYesUS/Canada number, any common format
include_sms_assessmentbooleanNoInclude SMS assessment from this same lookup. Adds LRN/spam if absent; no second lookup.

Details

From the project README

VeriRoute Intel MCP Server

smithery badge MCP Registry

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.

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

ToolWhat it does
vri_number_lookupLive intelligence for one number: carrier, line type, LRN routing, porting date; optional CNAM, spam reputation, messaging provider
vri_spam_checkSpam / scam / robocall reputation for one number
vri_sms_deliverabilityOne 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_lookupUp to 100 numbers in one call
vri_submit_jobSubmit an async bulk job (up to 10,000 numbers); balance reserved up front
vri_bulk_statusProgress 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

Markdown supported

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.