telnyx — Claude Code MCP server: calls, SMS and numbers
Lets your AI assistant reach the Telnyx API: browse endpoints, fire test requests and wire the SDK into your app.
claude mcp add telnyx -e TELNYX_API_KEY=<TELNYX_API_KEY> -- npx -y telnyxWhat telnyx does
The server runs through npx -y telnyx over stdio. It exposes the Telnyx REST API, so the assistant can walk endpoints, make trial calls and pull docs while you integrate the official telnyx TypeScript library into a server-side project.
You need a TELNYX_API_KEY, passed as an environment variable when you add the server. Webhook verification also wants the public key, otherwise the signature will not match. Verify against the raw request body only — parse or re-serialize it before unwrap and the signature is invalid.
The library is generated with Stainless and covers calls, messages, number orders, audio transcription and webhook verification. Connection failures and retryable responses are retried twice by default; change that with maxRetries, either on the client or per request.
What it helps with
- find the right Telnyx endpoint and check its request shape
- send a test SMS through the API
- order a number from the available list
- verify an inbound webhook signature
- add the TypeScript SDK to a server-side project
Example prompts for the agent
- List the Telnyx endpoints for sending messages
- Make a test request to search available numbers in country US
- How do I wire
telnyxinto my Node project for calls?
How to install telnyx
Platform CLI
claude mcp add telnyx -e TELNYX_API_KEY=<TELNYX_API_KEY> -- npx -y telnyxReplace <…> with your own values
Platform CLI
codex mcp add telnyx --env TELNYX_API_KEY=<TELNYX_API_KEY> -- npx -y telnyxReplace <…> with your own values
Config file
{
"mcpServers": {
"telnyx": {
"command": "npx",
"args": [
"-y",
"telnyx"
],
"env": {
"TELNYX_API_KEY": "<TELNYX_API_KEY>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"telnyx": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"telnyx"
],
"env": {
"TELNYX_API_KEY": "<TELNYX_API_KEY>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e TELNYX_API_KEY=<TELNYX_API_KEY> telnyx npx -y telnyxReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about telnyx
How do I install telnyx in Claude Code?
Run claude mcp add telnyx -e TELNYX_API_KEY=<TELNYX_API_KEY> -- npx -y telnyx, replacing the key with your own.
What does telnyx do?
It is an MCP server over the Telnyx REST API. Your assistant can browse endpoints, make test requests and help integrate the official TypeScript SDK.
What do I need before it works?
A TELNYX_API_KEY in the environment. For webhook verification add TELNYX_PUBLIC_KEY and pass the raw body to unwrap.
