Skip to main content

​
Telnyx AI Connector

The Telnyx AI Connector is a remote MCP server for AI providers and assistants. Any AI assistant that supports remote MCP servers can use it. Without signing in, it lets the assistant search the public Telnyx API reference and help you write code. After you sign in with your Telnyx account, it can also read your Voice AI assistants and their conversations, your phone numbers and applications, your calls and recordings, and your account balance. It is read-only. It cannot place a call, send a message, buy a number, or change anything on your account.

​
Which Telnyx MCP endpoint to use

Telnyx exposes more than one MCP endpoint, so pick the one that matches what you need:
  • https://api.telnyx.com/v2/ai/mcp is this connector. It is read-only: anonymous API reference search, plus authenticated read access to your own account over OAuth.
  • https://api.telnyx.com/v2/mcp is the Telnyx Remote MCP server. It executes Telnyx API actions and authenticates with an API key.
  • https://developers.telnyx.com/mcp is the documentation search server for these docs.

​
Add the connector

Add it as a custom or remote MCP connector in your AI assistant’s settings, using this server URL:
  • Transport: Streamable HTTP.
  • Authentication: OAuth. Leave any client ID and secret fields empty; Telnyx registers the client automatically.
  • Sign-in: the documentation tools work right away. When you first ask for account data, your assistant asks you to sign in with Telnyx, and then retries your request.
For assistants configured from a file or command line, add a remote MCP server named telnyx with the same URL, then run that tool’s login or authenticate command when you want to read account data.

​
What you can ask

Searching the API reference needs no sign-in. Everything else does.
  • “Which Telnyx endpoint sends an SMS, and what does it take?”
  • “List my voice AI assistants and the model each one uses.”
  • “What changed between the last two versions of my reception assistant?”
  • “Show my latest conversations for that assistant, and the summary of the most recent one.”
  • “Did my assistant tests pass?”
  • “Which phone numbers are on my account, and which app is each one assigned to?”
  • “What happened during call session <id>, and was it recorded?”
  • “How much credit do I have left?”

​
Tools

There are 24 read-only tools. There is no general-purpose “call any endpoint” tool, and documenting an endpoint never makes it executable here.

​
API reference (no sign-in)

  • list_api_endpoints: search the public Telnyx API reference, which covers 1,336 documented operations.
  • get_api_endpoint_schema: return the full schema for one endpoint, and the tool that can read it here, if any.

​
Voice AI assistants (sign-in)

  • list_assistants: your assistants with name, model, current version and tags.
  • get_assistant: one assistant’s configuration, including instructions, greeting, model, voice, transcription and telephony settings.
  • list_assistant_versions: the saved versions of one assistant.
  • get_assistant_version: one saved version, with the same fields as get_assistant.
  • list_assistant_tests: the automated tests defined for your assistants.
  • list_assistant_test_runs: the runs of one test, with status and timing.

​
Conversations (sign-in)

  • list_conversations: recent conversations, newest first, optionally for one assistant or since a date.
  • get_conversation: one conversation’s times, channel, assistant, and the agent and end-user addresses.
  • get_conversation_timeline: who spoke and when, and which tools the assistant called.
  • get_conversation_insights: the summary, sentiment or outcome generated by your insight templates.
  • list_insight_templates: the insight templates on your account.

​
Assistant resources (sign-in)

  • list_agent_tools: shared tools your assistants can use, such as webhooks or transfers.
  • list_mcp_servers: MCP servers registered for your assistants.
  • list_knowledge_bases: the names of the knowledge bases your assistants can search.
  • list_integrations: third-party integrations and whether each is connected.

​
Numbers, apps and calls (sign-in)

  • list_phone_numbers: your numbers with status, type, country, tags and assignment.
  • list_call_control_apps: your Call Control applications.
  • list_texml_apps: your TeXML applications.
  • get_call_status: the status of one call.
  • list_call_events: the event timeline for a call leg or session.
  • search_recordings: recording details such as duration, channels and timestamps.

​
Account (sign-in)

  • get_account_balance: current balance, pending charges, credit limit and available credit.

​
Authentication and privacy

  • Documentation is anonymous. Searching the API reference and reading schemas use no account and touch no account data.
  • Account access is per-user and short-lived. Signing in authorizes the connector for your account only. Each request uses a Telnyx credential that expires within minutes and is never stored, and the connector keeps no long-lived end-user credential.
  • Read-only and minimal. Each tool returns only an allowlisted set of fields. Anything not on the list is dropped.
  • Withheld from every result: conversation message text and full transcripts (only generated summaries and insights are returned), recording audio, recording and media links, tool arguments, webhook and callback URLs, credential and API key references, port-out PINs, and payment and billing details. Values that look like secrets are masked.
  • Data handling. The connector calls Telnyx’s own first-party API. No conversation data is collected by the connector. Logs contain only a request id, a route template, and a status class, with no request bodies, headers, credentials, or account identifiers.

​
Support