Connect Vonage 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 check verification code tool in Vonage
Use the verify user tool in Vonage
Use the send sms tool in Vonage
Use the make call tool in Vonage
Use the number insight tool in Vonage
Use the send message tool in Vonage
Supported Tools
check_verification
Check Verification Code
Check a verification code submitted by a user against an active Vonage Verify v2 request. Also supports cancelling an in-progress verification.
Supports API key/secret or application JWT. Checking consumes attempts; cancellation has provider timing restrictions.
verify_user
Verify User
Start a user verification (2FA) request using the Vonage Verify v2 API. Sends a one-time code to the user via one or more channels (SMS, WhatsApp, voice, email, or silent authentication) with automatic failover.
Supports API key/secret for basic synchronous use and application JWT for application callbacks and advanced features.
send_sms
Send SMS
Send an SMS using the Vonage SMS API (legacy). This is a simpler alternative to the Messages API for sending plain text SMS.
Uses API Key/Secret authentication and does not require a Vonage Application.
make_call
Make Call
Initiate an outbound voice call using the Vonage Voice API. Control call flow with NCCO (Nexmo Call Control Objects) actions or a remote answer URL.
This tool calls one phone number. Acceptance can incur charges and trigger external callbacks.
Requires the **API Key, Secret & Application JWT** auth method.
number_insight
Number Insight
Look up intelligence about a phone number using the Vonage Number Insight API. Returns information about number validity, format, carrier, type, reachability, and roaming status.
Three tiers are available:
- **Basic**: Country, international/national format
- **Standard**: Adds carrier name, type (mobile/landline/VoIP), ported status
- **Advanced**: Adds reachability, roaming status and validity flags. Statuses 43–45 are partial results.
send_message
Send Message
Send a message across multiple channels including SMS, MMS, WhatsApp, Facebook Messenger, Viber, and RCS using the Vonage Messages API.
Supports text, image, audio, video, file, and template message types depending on the channel.
Supports API key/secret or application JWT authentication; application authentication enables application webhook settings.
list_calls
List Calls
Retrieve voice call records from the Vonage Voice API. Filter by status, date range, or conversation.
Use this to monitor call activity, check call statuses, or look up a specific call by UUID.
Requires the **API Key, Secret & Application JWT** auth method.
manage_applications
Manage Applications
Create, list, update, or delete Vonage Applications. Applications are containers for capabilities (Voice, Messages, RTC, VBC) with their own webhook URLs and key pairs.
Uses API key and secret authentication. Creation requires a caller-owned public key; private keys are never returned. Updates preserve omitted native settings without a concurrency guarantee. Deletion is permanent.
manage_call
Manage Call
Control an active voice call: hang up, mute/unmute, earmuff/unearmuff, or transfer to a new NCCO flow. Can also play text-to-speech, stream audio, or send DTMF tones into a call.
Requires the **API Key, Secret & Application JWT** auth method.
get_account_info
Get Account Info
Retrieve Vonage account information including current balance, auto-reload status, and subaccount details.
Can also create subaccounts using a secret you already hold and transfer credit or balance between accounts. Subaccounts require restricted API access; financial writes can incur retained effects.
manage_numbers
Manage Numbers
Search for available virtual phone numbers, list your owned numbers, buy new numbers, cancel (release) numbers, and update number configuration.
Combines number search, purchase, and management in one tool.
Enable Vonage in Metorial. In your Metorial portal, enable the Vonage 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 Vonage tools.
Enable Vonage in Metorial. In your Metorial portal, enable the Vonage 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 Vonage tools.
Enable Vonage in Metorial. In your Metorial portal, enable the Vonage 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 Vonage tools.
{
"mcpServers":{
"metorial":{
"url":"<your-magic-mcp-url>"
}
}
}
Enable Vonage in Metorial. In your Metorial portal, enable the Vonage 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 Vonage tools.
claude mcp add --transport http metorial <your-magic-mcp-url>
Enable Vonage in Metorial. In your Metorial portal, enable the Vonage 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 Vonage tools.
codex mcp add metorial --url <your-magic-mcp-url>
codex mcp login metorial
Run Vonage through the Metorial gateway
One governed layer for every app your agents reach, not a separate connector per tool.
Give Vonage and every other app to your whole team through one MCP gateway, behind your SSO.
Scope which teams and agents can use Vonage tools with role-based access control, and trace every call.
Prefer to run it yourself? Metorial is open source and self-hostable.
Send messages across SMS, MMS, WhatsApp, Messenger, Viber and RCS. Create and control phone calls with NCCO or an answer URL, read call records, start and check verifications, inspect Number Insight results, manage virtual numbers and applications, and read balance or manage subaccounts and account transfers. Product provisioning, regional restrictions and charges apply; accepted requests do not prove delivery. Number Insight is scheduled to sunset February 4, 2027.
Frequently asked questions
Common questions about connecting Vonage to AI agents with Metorial.
How many tools does the Vonage MCP server have?
The Vonage MCP server exposes 11 tools, including Check Verification Code, Verify User, Send SMS. Each one is governed and traced through Metorial.
Does the Vonage MCP server support triggers?
Vonage 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 Vonage MCP server?
Any MCP client, including VS Code, Windsurf, Zed, OpenCode and Grok. Each one reaches the Vonage MCP server through the same Metorial URL.
How do I give only some teams access to Vonage?
Use role-based access control to decide which teams, users, and agents can use Vonage and which of its tools they can call.
Can I self-host the Vonage MCP server?
Yes. Metorial is open source, so you can run the Vonage MCP server yourself or use the hosted gateway.
Connect Vonage to production AI agents
See how Metorial gives your team governed access to Vonage, with tracing and security controls built in.