com.verirouteintel/lookup

Is this number safe to call or text right now? Live carrier, CNAM, spam and SMS checks for agents.

AI & MLJavaScriptv1.2.3

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.

Installation

Source-derived launch command. Check the maintainer’s required arguments and credentials before running:

bash
npx -y veriroute-intel-mcp

Set up in your AI client

Merge this template into ~/Library/Application Support/Claude/claude_desktop_config.json. Keep existing servers. Add any arguments, credentials, and permissions required by the maintainer; this template has not been install-tested.

json
{
  "mcpServers": {
    "com-verirouteintel-lookup": {
      "command": "npx",
      "args": [
        "-y",
        "veriroute-intel-mcp"
      ]
    }
  }
}

Restart Claude Desktop completely for changes to take effect. Confirm the server appears connected in the client’s tool list, then try a read-only example from its documentation.

Claude Desktop setup reference

Package

veriroute-intel-mcpnpm

Compatible MCP Clients

com.verirouteintel/lookup works with any MCP-compatible client. Copy the config snippet from the Configuration section above and add it to the file shown for your client, then restart the application.

  • Claude Desktop~/Library/Application Support/Claude/claude_desktop_config.jsonRestart Claude Desktop completely for changes to take effect.
  • Cursor~/.cursor/mcp.jsonRestart Cursor for changes to take effect.
  • VS Code.vscode/mcp.jsonReload VS Code window for changes to take effect.
  • Windsurf~/.codeium/windsurf/mcp_config.jsonRestart Windsurf for changes to take effect.
  • Claude Code.mcp.jsonSave at the project root, then start Claude Code in that project and review the MCP server approval prompt. Keep real credentials out of shared files.

Learn More