Skip to main content
MCP Apps are app-specific Model Context Protocol (MCP) surfaces for focused Telnyx workflows. Each app exposes a Streamable HTTP MCP endpoint with a narrower tool set than the canonical Telnyx API MCP server. Use MCP Apps when an MCP client or scanner needs to discover focused, app-specific Telnyx tools. Use the canonical Telnyx API MCP endpoint when you need the broader Telnyx API action MCP surface at https://api.telnyx.com/v2/mcp.
MCP Apps are experimental app-specific MCP surfaces. Discover available apps from the catalog before connecting to an app endpoint.

​
Catalog endpoint

Discover the available MCP Apps from the catalog: 
GET https://api.telnyx.com/v2/mcp/apps
Authorization: Bearer <TELNYX_API_KEY>
The catalog requires a Telnyx API key in the Authorization header using Bearer authentication.

​
App MCP endpoints

Each catalog entry has a slug. Connect MCP clients to an app-specific Streamable HTTP MCP endpoint with this URL pattern: 
https://api.telnyx.com/v2/mcp/apps/{slug}/mcp
For example, the voice-monitor app endpoint is: 
https://api.telnyx.com/v2/mcp/apps/voice-monitor/mcp

​
Available apps

The current catalog includes:
  • number-intelligence — Number Intelligence: Phone-number analysis using Telnyx Number Lookup and read-first readiness signals.
  • usage-cost-explorer — Usage & Cost Explorer: Balance, usage reports, billing groups, and guarded billing controls.
  • voice-monitor — Voice Monitor: Read-only active-call monitoring, call timelines, call status, and recording discovery.

​
Safety notes

  • MCP Apps are app-specific. The available tools and side-effect risk depend on the selected app and tool.
  • Current apps are designed around read-first workflows where possible.
  • Billing controls are guarded, but review tool descriptions and requested actions before approving any MCP tool call that can change account or billing state.
  • These app-specific endpoints are distinct from the canonical all-API MCP endpoint at https://api.telnyx.com/v2/mcp.