Connect Veriphone to Claude, ChatGPT, Cursor, Claude Code, Codex, Gemini, GitHub Copilot and any other MCP client, for your whole team. Metorial adds security, governance, and tracing, and gives everyone one Magic MCP URL to connect.
Ask your agent in plain language. Each of these maps to a real tool on the server.
Use the verify phone number tool in Veriphone
Use the generate example phone number tool in Veriphone
Use the get account and credits tool in Veriphone
Use the get current carrier coverage tool in Veriphone
Use the look up current carrier tool in Veriphone
Use the delete bulk csv file tool in Veriphone
Supported Tools
verify_phone
Verify Phone Number
Validates a phone number and returns detailed metadata including validity status, phone type (mobile, landline, toll-free, etc.), carrier, country, region, and formatted number variants (international, local, E.164).
Useful for verifying customer phone numbers, enriching contact data with carrier and location information, and ensuring numbers are properly formatted.
generate_example_phone
Generate Example Phone Number
Generates a dummy phone number for a given country and phone type combination. Returns the number in multiple formats (international, local, E.164).
Useful for testing, development, and generating placeholder phone numbers for specific countries and line types.
get_credits
Get Account and Credits
Identify the account associated with your API key and check its active state, plan, monthly usage, pay-as-you-go balance, and usage by lookup mode. This request does not spend verification credits.
get_current_coverage
Get Current Carrier Coverage
List the countries where current carrier lookups are supported. Check this before lookup_current_carrier. Coverage describes availability, not whether an individual lookup will resolve. This request does not spend verification credits.
lookup_current_carrier
Look Up Current Carrier
Validate a phone number and look up the carrier and line type currently serving it, including ported numbers. Returns the original assignment alongside current lookup details when available. Costs 10 credits when resolved, or 1 credit when only static validation is available; errors are not charged. Call get_current_coverage to check country coverage. This does not test whether a device is reachable or switched on.
delete_bulk_file
Delete Bulk CSV File
Permanently delete an uploaded CSV and its verification results. Use list_bulk_files to discover upload IDs. This cannot be undone.
download_bulk_file
Download Bulk CSV
Prepare a downloadable CSV for an existing upload. The provider returns verified results when available, or the original uploaded CSV otherwise. Check get_bulk_status for completed before expecting verification results. No new verification is started.
get_bulk_file
Get Bulk CSV File
Retrieve metadata, processing progress, and available result counts for a CSV upload. Returns an empty object when the upload does not exist or belongs to another account. Use list_bulk_files to discover upload IDs.
list_bulk_files
List Bulk CSV Files
List all non-deleted CSV uploads for the connected account, newest first, with their IDs, processing state, and available progress and result counts. The API returns the full list without pagination.
upload_bulk_file
Upload Bulk CSV
Upload CSV content for bulk phone verification. Specify the zero-based phone column and first data row. The provider accepts up to 100 MB and one million rows. Uploading does not start verification; inspect the returned samples, then call start_bulk_verification with the upload ID.
get_bulk_status
Get Bulk Verification Status
Poll the processing state of a CSV upload. An empty status means the upload does not exist or is not owned by this account. When status is completed, use download_bulk_file for the results.
start_bulk_verification
Start Bulk Verification
Start a background verification job for an existing CSV upload. Static mode costs 1 credit per billable number. Current mode costs 10 credits when resolved and 1 when current carrier resolution is unavailable; invalid rows are not charged. The account must have enough credits for every row at the full mode rate to start. Poll get_bulk_status, then use download_bulk_file to retrieve results.
Enable Veriphone in Metorial. In your Metorial portal, enable the Veriphone MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add a custom connector. Open Customize, then Connectors. Select Add, then Custom, then Web.
Paste your Metorial MCP URL. Name it Metorial, paste your Magic MCP URL (<your-magic-mcp-url>) and continue.
Sign in. Select Add and sign in to load Veriphone tools.
Enable Veriphone in Metorial. In your Metorial portal, enable the Veriphone MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add a custom MCP server. On ChatGPT web, open Plugins, select +, then Add custom MCP server.
Paste your Metorial MCP URL. Name it Metorial, paste your Magic MCP URL (<your-magic-mcp-url>), choose OAuth and accept the risk notice.
Create and install the plugin. Select Create as a plugin, install it and sign in to load Veriphone tools.
Enable Veriphone in Metorial. In your Metorial portal, enable the Veriphone MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add Metorial to your MCP config. Use ~/.cursor/mcp.json for every project, or .cursor/mcp.json for one.
Sign in. Open Customize in the sidebar, find Metorial and sign in to load Veriphone tools.
{
"mcpServers":{
"metorial":{
"url":"<your-magic-mcp-url>"
}
}
}
Enable Veriphone in Metorial. In your Metorial portal, enable the Veriphone MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add the server over HTTP. Add --scope user to use it in every project.
Sign in. Run /mcp, select Metorial and sign in to load Veriphone tools.
claude mcp add --transport http metorial <your-magic-mcp-url>
Enable Veriphone in Metorial. In your Metorial portal, enable the Veriphone MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
Add the server and sign in. The Codex CLI, IDE extension and ChatGPT desktop app share this config.
Check the connection. Type /mcp in Codex to see Metorial and its Veriphone tools.
codex mcp add metorial --url <your-magic-mcp-url>
codex mcp login metorial
Run Veriphone through the Metorial gateway
One governed layer for every app your agents reach, not a separate connector per tool.
Give Veriphone and every other app to your whole team through one MCP gateway, behind your SSO.
Scope which teams and agents can use Veriphone tools with role-based access control, and trace every call.
Prefer to run it yourself? Metorial is open source and self-hostable.
Validate and format phone numbers, retrieve original or current carrier information, generate example numbers, check account credits and carrier coverage, and verify CSV lists with downloadable results.
Frequently asked questions
Common questions about connecting Veriphone to AI agents with Metorial.
How many tools does the Veriphone MCP server have?
The Veriphone MCP server exposes 12 tools, including Verify Phone Number, Generate Example Phone Number, Get Account and Credits. Each one is governed and traced through Metorial.
Does the Veriphone MCP server support triggers?
Veriphone exposes tools your agents call on demand; it does not publish event triggers yet. Everything still runs through one governed MCP URL.
Which AI clients can use the Veriphone MCP server?
Any MCP client, including VS Code, Windsurf, Zed, OpenCode and Grok. Each one reaches the Veriphone MCP server through the same Metorial URL.
How do I give only some teams access to Veriphone?
Use role-based access control to decide which teams, users, and agents can use Veriphone and which of its tools they can call.
Can I self-host the Veriphone MCP server?
Yes. Metorial is open source, so you can run the Veriphone MCP server yourself or use the hosted gateway.
Connect Veriphone to production AI agents
See how Metorial gives your team governed access to Veriphone, with tracing and security controls built in.