Telnyx

Telnyx on xpay — Communications APIs without the account friction

Telnyx is a carrier-grade communications platform offering SMS, voice calls, phone number management, cloud storage, and AI assistants. Developers typically use Telnyx to add programmable voice and messaging to applications, manage virtual phone numbers, or build AI-powered call handling systems. On xpay, you call Telnyx endpoints directly through MCP without signing up for a Telnyx account—xpay holds the credentials and bills per call.

What's available

• list_api_endpoints — Discover and search all available endpoints in the Telnyx TypeScript API. Useful for exploring what's callable before you invoke it.
• get_api_endpoint_schema — Retrieve the full schema (parameters, response shape, required fields) for any Telnyx endpoint. Use this to understand what arguments an endpoint expects.
• invoke_api_endpoint — Execute any Telnyx endpoint with your chosen arguments. This is the primary tool for sending SMS, initiating calls, managing phone numbers, or accessing other Telnyx capabilities.

When Telnyx is the right tool

• You need to send SMS or MMS messages programmatically at scale.
• You're building a voice application (inbound/outbound calls, IVR, call recording).
• You need to provision, manage, or port virtual phone numbers.
• You want to integrate AI-powered call handling or transcription.
• You're prototyping a communications feature and want to avoid account setup overhead.
• You need a carrier-grade SLA and global routing for voice and messaging.

When to choose something else

• You need email delivery—use SendGrid, Resend, or Mailgun instead.
• You only need basic HTTP webhooks or event streaming—a simpler event bus may suffice.
• You need SMS at extreme scale with custom carrier relationships—consider direct carrier APIs or Twilio's enterprise tier.
• Your use case is one-off testing and you don't need persistent phone numbers—a temporary SMS service like Temp Mail may be faster.
• You need video conferencing—Telnyx does not offer this; use Daily, Twilio Video, or Jitsi.

Pricing snapshot

Note: The $0.01 per-call price on xpay covers the MCP wrapper and xpay infrastructure. Actual Telnyx service costs (SMS, voice minutes, phone number rental) are billed separately by Telnyx and depend on your usage. xpay pricing is transparent and per-call—no subscription, no minimums.

Quickstart

Install the Telnyx MCP in Claude Code:

claude mcp add --transport http telnyx "https://telnyx.mcp.xpay.sh/mcp?key=YOUR_XPAY_KEY"

Replace YOUR_XPAY_KEY with your xpay API key (get one free at https://xpay.tools after email or Google signup).

Once connected, ask Claude to use list_api_endpoints to find what you can call, then get_api_endpoint_schema to see the parameters, then invoke_api_endpoint to execute. For example: "Use list_api_endpoints to find SMS endpoints, then show me the schema for sending an SMS, then send a test message."

Alternative: Connect all xpay providers at once

claude mcp add --transport http xpay "https://mcp.xpay.sh/mcp?key=YOUR_XPAY_KEY"

With the unified endpoint, use xpay_discover("telnyx") to find Telnyx tools, xpay_details("telnyx/invoke_api_endpoint") to inspect them, and xpay_run("telnyx/invoke_api_endpoint", {...}) to call them.

For Cursor, Windsurf, Cline, or VS Code (Copilot):

Add this entry to your mcp.json file:

{
  "mcpServers": {
    "telnyx": {
      "url": "https://telnyx.mcp.xpay.sh/mcp?key=YOUR_XPAY_KEY"
    }
  }
}

Why route Telnyx through xpay?

• No Telnyx signup. xpay holds the credentials; you authenticate once with your xpay key and immediately access Telnyx endpoints.
• Pay per call, not per month. No subscription, no minimum spend. A single exploratory API call costs $0.01; scale up only when you're ready.
• MCP-native integration. Telnyx tools appear as native MCP resources in Claude Code, Cursor, and other MCP clients—no custom wrappers or SDK installation needed.
• Unified billing across providers. If you also use Tavily, Apollo, or other xpay providers, one invoice covers everything.
• Transparent pricing. See exactly what each call costs before you make it. No surprise bills or hidden tiers.

FAQ

See the FAQ section below for common questions about setup, pricing, and use cases.