MCP for AI Agents

The MCP endpoint lets AI agents interact with Trunx using structured tool calls. Streamable HTTP transport, same authentication as REST.

Endpoint

POST https://api.trunx.io/mcp

Authentication: Bearer token in the Authorization header (same API key as REST).

Quick Setup

Claude Desktop / Cursor config:

{
  "mcpServers": {
    "trunx": {
      "url": "https://api.trunx.io/mcp",
      "headers": {
        "Authorization": "Bearer tk_live_your_key_here"
      }
    }
  }
}

80+ Tools

Trunx exposes 80+ MCP tools across 16 domains:

Domain	Tools	Examples
SMS	2	`send_sms`, `get_sms_logs`
Voice	3	`create_call`, `get_call`, `end_call`
AI Agents	5	`create_agent`, `list_agents`, `update_agent`, `delete_agent`, `get_agent`
Agent Calls	5	`create_agent_call`, `list_ai_calls`, `get_call_transcript`, `get_call_recording`, `get_call_analysis`
Voices	4	`list_voices`, `clone_voice`, `preview_voice`, `delete_voice`
Knowledge	5	`create_knowledge`, `add_knowledge_source`, `list_knowledge`, `query_knowledge`, `delete_knowledge`
Agent Tools	6	`create_ultravox_tool`, `list_ultravox_tools`, `update_ultravox_tool`, etc.
DIDs	6	`list_dids`, `search_dids`, `purchase_dids`, `release_dids`, `configure_did`
DID Health	4	`did_health`, `cool_down_did`, `activate_did`, `burn_did`
Campaigns	7	`create_campaign`, `add_prospects`, `start_campaign`, `pause_campaign`, `campaign_stats`, etc.
IVR	4	`create_ivr`, `list_ivrs`, `delete_ivr`, `assign_ivr_to_did`
Audio	1	`generate_audio`
Compliance	2	`add_to_dnc`, `check_dnc`
10DLC	13	`register_brand`, `create_10dlc_campaign`, `assign_campaign_dids`, etc.
Reputation	3	`check_reputation`, `trigger_reputation_audit`, `list_reputation`
Billing	2	`usage_summary`, `billing_portal`
Webhooks	3	`register_webhook`, `list_webhooks`, `delete_webhook`
API Keys	3	`create_api_key`, `list_api_keys`, `revoke_api_key`

For a complete tool reference with parameters, scopes, and example conversations, see the MCP Setup Guide.

Examples

User: Text +14155551234 that their order shipped.

Agent calls: send_sms({ from: "+19499905899", to: "+14155551234", message: "Your order has shipped!" })

User: Call +14155551234 and confirm their appointment tomorrow at 3pm.

Agent calls: create_call({ from: "+19499905899", to: "+14155551234", systemPrompt: "...", voice: "terrence", firstSpeaker: "agent" })

MCP tools execute real actions. Calling send_sms sends a real message, purchase_dids provisions real numbers. Use test keys during development.