Lookup

com.verirouteintelPublished by verirouteintel.comOfficial publisherv1.2.3Updated Oct 24, 2026

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

VerifiedStreamable HTTPWeb executableCommunication & CollaborationSecurity & MonitoringBusiness & Commerce

Overview

AI-generated overview

A hosted phone-number intelligence server that lets an assistant check live carrier, line type, spam reputation and SMS deliverability for North American (US/CA

What you can do
Look up one North American number for live carrier of record, line type, LRN routing, porting date, and optional caller-ID name, spam reputation and messaging provider, with a fresh read each time rather than cached data. Check spam, scam and robocall reputation with an explainable risk verdict, confidence band and reasons. Get an SMS deliverability verdict covering line type, VoIP flag, spam reputation and the recipient's approximate local time with an 8am–9pm calling-window flag. Run bulk lookups of up to 100 numbers in one call, or submit an async job of up to 10,000 numbers and poll its status and stored results. Check account balance, connection limits and allowed products, and get a no
When to use it
Useful when an agent needs to clean calling lists before dialing, detect dead, ported or VoIP numbers, verify line type before sending SMS, check your own outbound caller IDs for spam labeling, or enrich CRM records with live carrier data inside a workflow.
Requirements
A remote Streamable HTTP endpoint or the npm stdio shim run with npx, which needs Node.js. A VeriRoute Intel API key is required for tool calls, sent as an Authorization bearer header or the VRI_API_KEY environment variable; free sandbox test keys return sample data. Discovery works without a key. Live keys draw on a prepaid balance.
Before you install
Live lookups spend money from a prepaid balance; bulk calls and async jobs can charge again if repeated, so reuse a stable request_id with identical arguments, and async jobs reserve balance up front. The API key is a secret sent in the Authorization header or VRI_API_KEY. Phone numbers queried are sent to a third-party service. SMS deliverability is a signal, not a delivery test or guarantee, and unknown reputation never clears a number to message.

Installation

In SourceWeft

  1. Open Lookup in the dashboard and add it to a workspace.
  2. Connect Authorization token credentials. They are stored privately and never shown on public pages.
  3. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/com.verirouteintel%2Flookup/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "lookup": {
      "type": "http",
      "url": "https://verirouteintel.com/api/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_TOKEN>"
      }
    }
  }
}

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)

bash
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)

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:

bash
VRI_API_KEY=YOUR_API_KEY npx veriroute-intel-mcp

Or in an mcp.json-style client config:

json
{  "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.

Source: README.md at commit 6ef7ab5

Tools

10

vri_number_lookup

Number Lookup

Live intelligence for ONE North American phone number: current carrier of record, line type, LRN routing data, porting activation date, and optionally caller-ID name (cnam), spam reputation, and messaging provider. Always a fresh read of live numbering infrastructure — never cached carrier data. Live customer keys spend balance. Repeating a call can charge again; reuse a stable request_id with identical arguments for a safe retry. Use max_cost to cap the quote. Use a test key for integration tests.

Parametersmax_costproductsrequest_idphone_numberrequiredinclude_sms_assessment

vri_spam_check

Spam Check

Spam/scam/robocall reputation for one North American phone number, with an explainable `risk` block: the verdict, a confidence band, and the individual reasons behind it (complaint volume and recency, complaint category, community reports, line type, recent porting). Live customer keys spend balance. Repeating a call can charge again; reuse a stable request_id with identical arguments for a safe retry. Use max_cost to cap the quote. Use a test key for integration tests.

Parametersmax_costrequest_idphone_numberrequired

vri_bulk_status

Bulk Job Status

Status and progress of a VRI bulk lookup job by job id.

Parametersjob_idrequired

vri_bulk_lookup

Bulk Lookup

Live lookup for up to 100 North American phone numbers in one call (carrier, line type, routing; optional cnam/spam/messaging). Each number is a fresh paid read — spend scope required. Live customer keys spend balance. Repeating a call can charge again; reuse a stable request_id with identical arguments for a safe retry. Use max_cost to cap the quote. Use a test key for integration tests.

Parametersmax_costproductsrequest_idphone_numbersrequired

vri_sms_deliverability

SMS Deliverability Check

Line-type-based SMS capability and reputation signals for a North American number. Not an actual delivery test or guarantee. Unknown reputation never clears a number to message. Returns sms_capable (live line-type read), VoIP flag, spam reputation, the recipient's approximate local time with an 8am-9pm calling-window flag, and plain-language reasons. Deliverability and reputation signals only — not a legal compliance determination (no DNC/reassigned-number/litigator data). Performs its own LRN and spam lookup; avoid calling after number_lookup for the same data. Live customer keys spend balance. Repeating a call can charge again; reuse a stable request_id with identical arguments for a safe retry. Use max_cost to cap the quote. Use a test key for integration tests.

Parametersmax_costrequest_idphone_numberrequired

vri_submit_job

Submit Async Job

Submit an ASYNC bulk lookup job for up to 10000 North American phone numbers. Balance is reserved up front and the job runs in the background; check progress with vri_bulk_status. Requires a customer API key (jobs bill the account that owns the key). Live customer keys spend balance. Repeating a call can charge again; reuse a stable request_id with identical arguments for a safe retry. Use max_cost to cap the quote. Use a test key for integration tests.

Parametersmax_costproductsrequest_idphone_numbersrequired

vri_account_info

Account and connection budget

Free: available balance, connection limits and allowed products.

Takes no parameters.

vri_quote

Estimate lookup cost

Free estimate using account pricing and deduplicated valid numbers; no lookup.

Parametersproductsphone_numbersrequiredinclude_sms_assessment

vri_job_results

Read job results

Free, owner-scoped stored results. Follow next_cursor until null; never re-submit a completed job.

Parameterslimitcursorjob_idrequired

vri_operation_status

Check request receipt

Free: check an operation after an interrupted call; pending work must not be resubmitted with a new ID.

Parametersoperation_idrequired

Version history

1
  1. v1.2.3LatestSep 16, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts