Connect AI agents to the Telnyx MCP server

1. Install the SDK

   Node.js

   npm install @scalekit-sdk/node dotenv

   Python

   pip install scalekit-sdk-python python-dotenv

   Full SDK reference: Node.js | Python

2. Set your credentials

   Add your Scalekit credentials to your .env file. Find values in app.scalekit.com > Developers > API Credentials.

   .env

   SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
   SCALEKIT_CLIENT_ID=<your-client-id>
   SCALEKIT_CLIENT_SECRET=<your-client-secret>

3. Authorize and make your first call

   Node.js

   quickstart.mts

   import { ScalekitClient } from '@scalekit-sdk/node'
   import 'dotenv/config'
   import { createInterface } from 'node:readline/promises'
   
   const scalekit = new ScalekitClient(
     process.env.SCALEKIT_ENVIRONMENT_URL,
     process.env.SCALEKIT_CLIENT_ID,
     process.env.SCALEKIT_CLIENT_SECRET,
   )
   const actions = scalekit.actions
   
   const connector = 'telnyxmcp'
   const identifier = 'user_123'
   
   // Generate an authorization link for the user
   const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
   console.log('Authorize Telnyx MCP:', link)
   const rl = createInterface({ input: process.stdin, output: process.stdout })
   await rl.question('Press Enter after authorizing...')
   rl.close()
   
   // Make your first call
   const result = await actions.executeTool({
     connector,
     identifier,
     toolName: 'telnyxmcp_list_api_endpoints',
     toolInput: {},
   })
   console.log(result)

   npx tsx quickstart.mts

   Python

   quickstart.py

   import os
   from scalekit import ScalekitClient
   from dotenv import load_dotenv
   load_dotenv()
   
   scalekit_client = ScalekitClient(
       env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),
       client_id=os.getenv("SCALEKIT_CLIENT_ID"),
       client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
   )
   actions = scalekit_client.actions
   
   connection_name = "telnyxmcp"
   identifier = "user_123"
   
   # Generate an authorization link for the user
   link_response = actions.get_authorization_link(
       connection_name=connection_name,
       identifier=identifier,
   )
   print("Authorize Telnyx MCP:", link_response.link)
   input("Press Enter after authorizing...")
   
   # Make your first call
   result = actions.execute_tool(
       tool_input={},
       tool_name="telnyxmcp_list_api_endpoints",
       connection_name=connection_name,
       identifier=identifier,
   )
   print(result)

   python quickstart.py

What you can do

Connect this agent connector to let your agent:

• Monitor open voice — Open the Telnyx Voice Monitor MCP App for observing and troubleshooting voice traffic
• Explorer open usage cost — Open the Telnyx Usage & Cost Explorer MCP App for usage and cost analysis
• Intelligence open number — Open the Telnyx Number Intelligence MCP App for phone number lookup, validation, and enrichment workflows
• List api endpoints — List or search all endpoints in the Telnyx API
• Endpoint invoke api — Invoke any Telnyx API endpoint by name
• Get api endpoint schema — Get the JSON schema for a named Telnyx API endpoint

Tool list

Use the exact tool names from the Tool list below when you call execute_tool. If you’re not sure which name to use, list the tools available for the current user first.

telnyxmcp_get_api_endpoint_schema#Get the JSON schema for a named Telnyx API endpoint. Call this after finding an endpoint with list_api_endpoints; the returned schema tells you which arguments invoke_api_endpoint expects.1 param▾

Get the JSON schema for a named Telnyx API endpoint. Call this after finding an endpoint with list_api_endpoints; the returned schema tells you which arguments invoke_api_endpoint expects.

NameTypeRequiredDescription

endpointstringrequiredThe name of the endpoint to get the schema for, as returned by list_api_endpoints.

telnyxmcp_invoke_api_endpoint#Invoke any Telnyx API endpoint by name. This is a generic executor that dispatches to the underlying Telnyx REST API: first find the endpoint with list_api_endpoints, fetch its argument schema with get_api_endpoint_schema, then call this tool with the endpoint name and matching args. Can perform writes (create, update, delete), so use with care.2 params▾

Invoke any Telnyx API endpoint by name. This is a generic executor that dispatches to the underlying Telnyx REST API: first find the endpoint with list_api_endpoints, fetch its argument schema with get_api_endpoint_schema, then call this tool with the endpoint name and matching args. Can perform writes (create, update, delete), so use with care.

NameTypeRequiredDescription

argsobjectrequiredArguments for the endpoint, matching the schema returned by get_api_endpoint_schema. Pass as a JSON object of parameter names to values.

endpoint_namestringrequiredThe name of the Telnyx API endpoint to invoke, as returned by list_api_endpoints.

telnyxmcp_list_api_endpoints#List or search all endpoints in the Telnyx API. Use this to discover available endpoints by name, resource, operation, or tag before fetching an endpoint's schema with get_api_endpoint_schema and invoking it with invoke_api_endpoint.1 param▾

List or search all endpoints in the Telnyx API. Use this to discover available endpoints by name, resource, operation, or tag before fetching an endpoint's schema with get_api_endpoint_schema and invoking it with invoke_api_endpoint.

NameTypeRequiredDescription

search_querystringoptionalOptional search query to filter endpoints. Provide a partial name, resource, operation, or tag (e.g. 'messages', 'phone numbers', 'create call').

telnyxmcp_open_number_intelligence#Open the Telnyx Number Intelligence MCP App for phone number lookup, validation, and enrichment workflows.1 param▾

Open the Telnyx Number Intelligence MCP App for phone number lookup, validation, and enrichment workflows.

NameTypeRequiredDescription

actionstringoptionalOptional no-op app opener action; omit to open the app.

telnyxmcp_open_usage_cost_explorer#Open the Telnyx Usage & Cost Explorer MCP App for usage and cost analysis.1 param▾

Open the Telnyx Usage & Cost Explorer MCP App for usage and cost analysis.

NameTypeRequiredDescription

actionstringoptionalOptional no-op app opener action; omit to open the app.

telnyxmcp_open_voice_monitor#Open the Telnyx Voice Monitor MCP App for observing and troubleshooting voice traffic.1 param▾

Open the Telnyx Voice Monitor MCP App for observing and troubleshooting voice traffic.

NameTypeRequiredDescription

actionstringoptionalOptional no-op app opener action; omit to open the app.