For developers wiring phone checks into AI agents

Give your AI agents a live phone-network reader, already built

One MCP endpoint reads carrier, spam, and deliverability live — no hand-rolled checks, no sales call, integrate in an afternoon.

No card, no spam. Just a working test key.

https://verirouteintel.com/api/mcp
A developer at a bright workspace checking a number on his phone
3B+
lookups handled by the network behind VeriRoute
52.8B
robocalls placed in 2024 (YouMail)
$12.5B
in FTC-reported fraud tied to phone abuse

How it works

1

Connect the endpoint

Point Claude Code, Cursor, or n8n at https://verirouteintel.com/api/mcp. Setup docs are at /api-docs/mcp.

2

Test for free tonight

Sign up free, no card; /dashboard/sandbox issues your test key, and your agent runs against deterministic sample data on the documented magic numbers — the whole integration built at $0.

3

Fund the wallet when ready

Pay-as-you-go: LRN $0.0005, messaging provider $0.0009, CNAM $0.006, spam $0.007 per lookup. No subscription, no minimum, no contract.

4

Read the network live

Your agent checks carrier, spam reputation, and deliverability at the moment it acts. Carrier and caller-ID data is read live, never served from a stale database; spam reputation refreshes hourly.

A developer between build sessions at a bright desk

Phone intelligence for AI agents

Real-time phone-number intelligence API: send a US number, get who actually services it right now — real voice carrier, real messaging provider, caller-ID name, line type, spam reputation — one call, live reads typically well under a second.

Carrier & line type

Resolve the real voice carrier (LRN) and whether a number is mobile, landline, or VoIP — read live, not from a cached directory.

Caller-ID name (CNAM)

Pull the real name tied to a number so your agent knows who it's about to reach.

Spam reputation

Check spam/scam risk before your agent dials or texts, so it doesn't burn a contact that's already flagged.

SMS deliverability

The vri_sms_deliverability MCP tool tells your agent whether a number can actually receive a text before it sends one.

TCPA calling-window flag

Get the recipient's local time with an 8am–9pm calling-window flag, so your agent knows when it's appropriate to reach out.

Bulk jobs over CSV

Run a fresh dip per row on a whole list at once — every number checked live, not appended from an old cache.

A phone-data answer is only worth the moment it was read

Agents act instantly on whatever they're told. A cached carrier lookup handed to an AI agent isn't a shortcut. It's a wrong answer executed at machine speed. We built the endpoint so your agent never acts on the past: carrier and caller-ID data is read live on every call, and spam reputation refreshes hourly.

An engineering lead walking through a sunlit office

Get your free sandbox key and test tonight

Free test key, deterministic sample data, build the whole integration at $0 — then swap in a live key.

Get a free sandbox key

Step 1 of 2 — get your $0 test key, no card required

Frequently Asked Questions

What is the VeriRoute Intel MCP server?

It's a live MCP server at https://verirouteintel.com/api/mcp that gives an AI agent direct phone intelligence: carrier and line type, CNAM caller-ID name, spam reputation, and SMS deliverability, plus bulk lookups. The 10 tools on the endpoint: vri_number_lookup, vri_spam_check, vri_sms_deliverability, vri_bulk_lookup, vri_bulk_status, and vri_submit_job. Carrier and caller-ID data is read live at the moment your agent asks, never served from a stale database; spam reputation refreshes hourly.

How do I connect it in Claude Code, Cursor, or n8n?

All three connect to the same MCP endpoint. The setup differs only in where you paste the URL. Full step-by-step instructions for Claude Code, Cursor, and n8n are at /api-docs/mcp. Once connected, your agent has all 10 tools available immediately.

What does the sandbox cost?

The sandbox is free — $0. Sign up for a free account, no card, and /dashboard/sandbox issues one test key per account (prefix mpl_test_pk_, shown once, regenerate any time). The key works identically on REST and MCP. Sandbox calls return deterministic sample data, cost nothing, and dip no provider — build the whole integration at $0, then swap in a live key.

What's a magic number?

A magic number is a documented test number in the 555-01xx range that always returns the same sample data — there's a clean number, a SCAM one, a ROBOCALL one, a business line, and a recently-activated one, plus 19995550000, which returns a 404 so you can build your error handling. Any other number gets a helpful 422. Nothing real is looked up and nothing is charged.

What does a lookup cost once I'm in production?

You pay per lookup from a wallet: LRN (carrier) is $0.0005, messaging provider is $0.0009, CNAM (caller-ID name) is $0.006, and spam reputation is $0.007. You only pay for the specific checks your agent actually calls.

Are there minimums or contracts?

No. It's pay-as-you-go — no subscription, no minimum spend, no contract, no sales call. Fund the wallet, use what you use, top up when you need to.

What data comes back on a single lookup, and is it fresh?

Depending on which tools your agent calls, you get carrier and line type, CNAM caller-ID name, spam reputation, and SMS deliverability — including recipient-local time with the 8am–9pm TCPA calling-window flag. Carrier and caller-ID data is read live at the moment of the call, never served from a stale database; spam reputation refreshes hourly. A phone-data answer is only worth the moment it was read.

Can an agent run bulk jobs instead of one number at a time?

Yes. You can submit a CSV for a bulk job, and each row still gets a fresh dip at the time it's processed — it isn't pulled from a batch cache. Same freshness rule, just at volume.

What does VRI NOT do?

VRI does not check the DNC registry, does not detect reassigned numbers, and does not screen against litigator lists. It checks whether a number is real, reachable, and currently safe to contact from a deliverability standpoint — not the legal compliance status of contacting it.

Sandbox results are deterministic sample data on documented magic numbers — zero charges, zero provider dips, nothing real. Production lookups are billed per dip once you fund a wallet — no subscription, no minimum, no contract.