MCP Setup Guide

import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";

const client = new Client({ name: "my-agent", version: "1.0.0" });

await client.connect(
  new StreamableHTTPClientTransport(
    new URL("https://api.trunx.io/mcp"),
    {
      requestInit: {
        headers: {
          Authorization: "Bearer tk_live_your_key_here",
        },
      },
    }
  )
);

// List available tools
const { tools } = await client.listTools();
console.log(tools.map((t) => t.name));

// Call a tool
const result = await client.callTool({
  name: "list_dids",
  arguments: { limit: 5 },
});
console.log(result);

You: Text +14155551234 that their order has shipped.

Agent calls: send_sms({
  "from": "+19499905899",
  "to": "+14155551234",
  "message": "Your order has shipped! You'll receive tracking info shortly."
})
→ { "id": "sms_abc123", "status": "queued", "messageId": "SM..." }

Agent: Done — I sent the shipping notification to +14155551234.
       Message ID: sms_abc123, status: queued.

You: Call +14155551234 and remind them about their appointment
     tomorrow at 3pm. Be friendly and confirm if they can make it.

Agent calls: create_call({
  "from": "+19499905899",
  "to": "+14155551234",
  "systemPrompt": "You are a friendly receptionist calling to remind
    the customer about their appointment tomorrow at 3:00 PM.
    Confirm whether they can make it or need to reschedule.
    Be warm and professional.",
  "voice": "terrence",
  "firstSpeaker": "agent"
})
→ { "callId": "call_xyz789", "status": "ringing" }

Agent: I'm calling +14155551234 now with an AI agent that will remind
       them about tomorrow's 3 PM appointment and confirm attendance.
       Call ID: call_xyz789.

You: I need to run a calling campaign to 500 leads in the 949 area
     code. Use our "appointment setter" agent and health-based DID
     selection.

Agent calls: list_agents({})
→ { "agents": [{ "id": "agent_apt01", "name": "appointment-setter", ... }] }

Agent calls: create_campaign({
  "name": "949 Appointment Outreach",
  "agentId": "agent_apt01",
  "callerIds": ["949"],
  "callerIdStrategy": "health_score"
})
→ { "id": "camp_abc123", "status": "created" }

Agent calls: add_prospects({
  "campaignId": "camp_abc123",
  "numbers": ["+19491234567", "+19492345678", "..."]
})
→ { "added": 500 }

Agent calls: start_campaign({ "campaignId": "camp_abc123" })
→ { "status": "active" }

Agent: Campaign "949 Appointment Outreach" is now dialing. 500
       prospects loaded, using the appointment-setter agent with
       health-score-based caller ID selection in the 949 area code.