Let an AI assistant validate phone numbers and look up carriers with your Veriphone account. The server is hosted by Veriphone and speaks the Model Context Protocol; you connect it with your API key and nothing to install.
Endpoint: https://mcp.veriphone.io (Streamable HTTP, served at the root of the subdomain). Authentication is your API key from the dashboard, sent as a bearer token. Every call runs against your own credits; the server stores nothing.
claude mcp add --transport http veriphone https://mcp.veriphone.io \ --header "Authorization: Bearer YOUR_API_KEY"
mcp.json{
"mcpServers": {
"veriphone": {
"url": "https://mcp.veriphone.io",
"headers": { "Authorization": "Bearer YOUR_API_KEY" }
}
}
}Some connectors cannot set headers. Put the key on the URL instead, and treat that URL as a secret:
https://mcp.veriphone.io?key=YOUR_API_KEY
Clients that launch servers as a subprocess can run the same tools with npx:
{
"mcpServers": {
"veriphone": {
"command": "npx",
"args": ["-y", "@veriphone/mcp"],
"env": { "VERIPHONE_API_KEY": "YOUR_API_KEY" }
}
}
}| Tool | What it does | Cost |
|---|---|---|
verify_phone | Validity with a reason, line type (mobile, fixed line, VoIP, toll-free…), carrier, country, region, and E.164 / international / local formats. With mode: "current" it also returns the carrier currently serving the number, ported or not. | 1 credit; 10 in current mode (1 if the current carrier cannot be resolved) |
verify_phones | Up to 50 numbers in one call, results in order. For whole lists use CSV upload. | per number, as above |
get_credits | Plan, monthly limit, credits used this period, pay-as-you-go balance, usage by mode. | free |
current_coverage | Countries where current mode is available, or yes/no for one country. | free, no key needed |
example_number | A syntactically valid example number for a country and line type, for testing. | free |
Credits are charged only when the API answers success; errors cost nothing. Every account starts with 1,000 free credits a month — sign up to get a key.
Ask your assistant "Is +1 416 967 0000 a valid number, and who is the carrier?" and it calls verify_phone. The tool returns a one-line summary plus the full JSON from /v3/verify:
+14169670000: valid fixed_line · carrier Bell · Canada, Toronto, ON
The assistant reads the tool descriptions, so it knows a current-mode lookup costs 10 credits and will usually ask before running a list in that mode.
?key= URL can spend your credits. Rotate the key from the dashboard if it leaks.