# telnyx

Lets your AI assistant reach the Telnyx API: browse endpoints, fire test requests and wire the SDK into your app.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 198
- Author: team-telnyx
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/team-telnyx/telnyx-node
- Updated: 2026-10-22
- HTML: https://affpapa.org/en/nevibecode/mcp/telnyx

## What it 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.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `TELNYX_API_KEY` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add telnyx -e TELNYX_API_KEY=<TELNYX_API_KEY> -- npx -y telnyx
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add telnyx --env TELNYX_API_KEY=<TELNYX_API_KEY> -- npx -y telnyx
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "telnyx": {
            "command": "npx",
            "args": [
                "-y",
                "telnyx"
            ],
            "env": {
                "TELNYX_API_KEY": "<TELNYX_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "telnyx": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "telnyx"
            ],
            "env": {
                "TELNYX_API_KEY": "<TELNYX_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e TELNYX_API_KEY=<TELNYX_API_KEY> telnyx npx -y telnyx
```
Replace <…> with your own values

## When to use it
- 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
- List the Telnyx endpoints for sending messages
- Make a test request to search available numbers in country US
- How do I wire `telnyx` into my Node project for calls?

## Similar
- [MCP Toolbox for Databases](https://affpapa.org/en/nevibecode/mcp/googleapis-mcp-toolbox-for-databases.md) — MCP server · ★ 16717
- [PostHog MCP Server](https://affpapa.org/en/nevibecode/mcp/posthog-mcp-server.md) — MCP server · ★ 40409
- [OpenWork MCP Gateway](https://affpapa.org/en/nevibecode/mcp/openwork-mcp-gateway.md) — MCP server · ★ 24242
- [Keploy](https://affpapa.org/en/nevibecode/mcp/keploy.md) — MCP server · ★ 18727
- [Nhost](https://affpapa.org/en/nevibecode/mcp/nhost.md) — MCP server · ★ 9366
- [basebalance.cloud — x402 RPC & MCP gateway](https://affpapa.org/en/nevibecode/mcp/basebalancecloud-x402-rpc-mcp-gateway.md) — MCP server · ★ 7506

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md