Connect Orbit to your AI coding assistant via MCP

The Orbit MCP server exposes every core CPaaS capability as a tool that any Model Context Protocol client can call. You can send an SMS, initiate a voice call, trigger a campaign, or check delivery analytics with a single natural-language prompt — without leaving your IDE or the Claude chat window. How Orbit’s MCP server compares (Q3 2026): Twilio’s officially hosted MCP server is read-only — it indexes API docs for search and retrieval and does not execute calls, and Twilio’s alternative alpha/Labs server that can execute calls carries no support commitment. Telnyx ships a read-write MCP server plus a large published Agent Skills catalog, but those skills are scaffolding for writing your own integration code against the Telnyx SDKs, not a running agent. Orbit’s built-in MCP tools call directly into the same conversations, campaigns, contacts, and knowledge base your dashboard uses, driven by the same native agent runtime (LangGraph) that powers Orbit’s own AI agents — so a prompt can send, dial, or enrol a journey immediately, with no separate integration to keep in sync.

Prerequisites

An Orbit account at orbit.devotel.io
An API key from Dashboard → Settings → API Keys (live: dv_live_sk_*; sandbox: dv_test_sk_*)
Node.js 18 or later on your local machine (required to run npx)

Claude Desktop

Open or create ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows).
Add the orbit server block:

{
  "mcpServers": {
    "orbit": {
      "command": "npx",
      "args": ["-y", "@devotel/mcp-server"],
      "env": {
        "ORBIT_API_KEY": "dv_live_sk_xxxxxxxxxxxxxxxx"
      }
    }
  }
}

Restart Claude Desktop. The Orbit tools appear in the tool selector on the next conversation.
Verify the connection: type “List my Orbit campaigns” in a new chat. Claude calls list_campaigns and returns your campaign list.

Cursor

Click the badge for a one-click install (Cursor asks you to confirm, then fill in your real ORBIT_API_KEY), or configure it by hand:

Open Cursor Settings → Features → MCP → Add new MCP server and fill in:
Field Value
Name orbit
Type command
Command npx -y @devotel/mcp-server
Env ORBIT_API_KEY=dv_live_sk_xxxxxxxxxxxxxxxx
Alternatively, add .cursor/mcp.json to your project root:

Field	Value
Name	`orbit`
Type	`command`
Command	`npx -y @devotel/mcp-server`
Env	`ORBIT_API_KEY=dv_live_sk_xxxxxxxxxxxxxxxx`

{
  "mcpServers": {
    "orbit": {
      "command": "npx",
      "args": ["-y", "@devotel/mcp-server"],
      "env": {
        "ORBIT_API_KEY": "dv_live_sk_xxxxxxxxxxxxxxxx"
      }
    }
  }
}

Cursor reloads MCP config on file save. Test with @orbit in Cursor AI chat: “Using orbit, send an SMS to +14155551234 saying ‘Hello from Cursor’.”

Claude Code (CLI)

Add to your project’s .claude/settings.json:

{
  "mcpServers": {
    "orbit": {
      "command": "npx",
      "args": ["-y", "@devotel/mcp-server"],
      "env": {
        "ORBIT_API_KEY": "dv_live_sk_xxxxxxxxxxxxxxxx"
      }
    }
  }
}

Or set the env var globally and run the server inline:

export ORBIT_API_KEY=dv_live_sk_xxxxxxxxxxxxxxxx
claude mcp add orbit -- npx -y @devotel/mcp-server

VS Code (GitHub Copilot Chat / MCP extension)

Add a .vscode/mcp.json to your workspace:

{
  "servers": {
    "orbit": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@devotel/mcp-server"],
      "env": {
        "ORBIT_API_KEY": "dv_live_sk_xxxxxxxxxxxxxxxx"
      }
    }
  }
}

Run MCP: List Servers → orbit → Start Server from the command palette, then call Orbit tools from Copilot Chat’s agent mode.

Windsurf

Open Windsurf Settings → Cascade → MCP Servers → View raw config and add:

{
  "mcpServers": {
    "orbit": {
      "command": "npx",
      "args": ["-y", "@devotel/mcp-server"],
      "env": {
        "ORBIT_API_KEY": "dv_live_sk_xxxxxxxxxxxxxxxx"
      }
    }
  }
}

Click Refresh in the MCP panel, then call Orbit tools from Cascade.

Cline

Open Cline → MCP Servers → Configure MCP Servers (edits cline_mcp_settings.json) and add:

{
  "mcpServers": {
    "orbit": {
      "command": "npx",
      "args": ["-y", "@devotel/mcp-server"],
      "env": {
        "ORBIT_API_KEY": "dv_live_sk_xxxxxxxxxxxxxxxx"
      }
    }
  }
}

Cline picks up the new server automatically once the file is saved.

Zed

Add to Zed’s settings.json:

{
  "context_servers": {
    "orbit": {
      "source": "custom",
      "command": {
        "path": "npx",
        "args": ["-y", "@devotel/mcp-server"],
        "env": {
          "ORBIT_API_KEY": "dv_live_sk_xxxxxxxxxxxxxxxx"
        }
      }
    }
  }
}

Orbit tools appear in the Zed Assistant panel’s context-server picker.

Continue

Add to ~/.continue/config.json (or the workspace .continue/config.json):

{
  "mcpServers": {
    "orbit": {
      "command": "npx",
      "args": ["-y", "@devotel/mcp-server"],
      "env": {
        "ORBIT_API_KEY": "dv_live_sk_xxxxxxxxxxxxxxxx"
      }
    }
  }
}

Reload the Continue window (Cmd/Ctrl+Shift+P → Continue: Reload) to pick up the new server.

Sandbox mode

Use a sandbox key (dv_test_sk_*) to exercise every tool without incurring real charges. Sandbox calls are logged in Orbit under Settings → API Logs → sandbox but no SMS is actually sent, no call is dialled, and no number is purchased.

Available tools

Tool	What it does
`send_sms`	Send an SMS on any registered number
`send_whatsapp`	Send a WhatsApp message (template or freeform)
`send_email`	Send a transactional email
`send_template`	Send an approved template on any channel
`voice_call`	Initiate an outbound voice call
`purchase_number`	Buy a phone number (auto-attaches compliance profile)
`search_numbers`	Browse available DIDs by country / type / pattern
`list_campaigns`	List campaigns (filter by status)
`start_campaign`	Kick off a draft or scheduled campaign
`list_journeys`	List published flows (journeys) by status
`start_journey`	Enrol a contact or list into a published flow
`list_agents`	List deployed AI agents
`agent_handoff_to_human`	Escalate an AI conversation to a human agent
`lookup_contact`	Find a contact by phone, email, or free-text
`create_contact`	Create or upsert a contact record
`update_contact`	Update fields on an existing contact (name/email/phone/consent)
`identify_contact`	Upsert a contact by email/phone with traits (CDP identify)
`track_event`	Record a CDP event on a contact’s customer-360 timeline
`cdp_track`	Record a CDP domain event for segment / journey triggers
`cdp_identify`	Set / merge traits on a known contact (CDP identify)
`list_segments`	List contact segments with counts
`create_segment_from_prompt`	Build a segment from a natural-language description
`list_templates`	List approved templates for a channel
`get_message_status`	Check delivery status of a sent message
`analytics_summary`	Aggregated delivery KPIs for a time window
`check_balance`	Current account credit balance
`kb_query`	Semantic search of the tenant’s knowledge base
`analyze_text`	Sentiment / language / intent / PII analysis
`create_support_ticket`	Open a helpdesk ticket (Zendesk / Intercom)
`create_calendar_event`	Schedule a calendar event
`add_memory`	Store a memory item for an agent + contact pair
`search_memory`	Semantic search over stored memories
`list_memories`	List all memories for an agent + contact pair
`delete_memory`	Delete a single memory item
`delete_contact_memories`	Delete all memories for a contact (GDPR Art 17)
`video_create_room`	Create a video room (scheduled or instant) + host token
`video_send_invite`	Issue a guest invite token + .ics email for a video room
`video_end_session`	Force-end an active video room (disconnect all participants)

Example prompts

Send a quick SMS:

“Using Orbit, send an SMS to +44 7700 900 123 saying ‘Your order has shipped.’”

Initiate a test call:

“Using Orbit, call +14155551234 from my primary number and record it.”

Campaign health check:

“Using Orbit, show me the analytics for the last 7 days and list any running campaigns.”

Agent + segment workflow:

“Using Orbit, create a segment called ‘VIP Europe’ for customers in Germany who haven’t ordered in 60 days, then send them the ‘reactivation_v2’ WhatsApp template.”

Security

Read-only mode: set MCP_TOOLS_ALLOW_LIST to only the GET tools to prevent any writes from the LLM session.
Budget cap: set MCP_TOOLS_BUDGET_LIMIT_USD=5 to refuse chargeable calls that would exceed $5 in the session.
Deny specific tools: MCP_TOOLS_DENY_LIST=purchase_number,voice_call to block high-impact tools while keeping all others available.

All chargeable calls emit a JSON-Lines audit entry to stderr — pipe stderr to your log sink to retain a full trace of what the LLM did. When a tool needs a sensitive value (a payment token, an OAuth code, an API key), the server hands you a hosted capture link instead of collecting it in the chat window — see URL-mode elicitation for the flow.

Troubleshooting

Symptom	Fix
`ORBIT_API_KEY rejected by API`	Key is invalid or was generated for a different environment. Regenerate in Dashboard → Settings → API Keys.
Tools not showing in Claude Desktop	Config JSON is invalid (trailing comma, wrong path). Validate with `cat` + `jq`. Restart Claude Desktop after fixing.
`voice_call` returns 403	The API key lacks `voice:write` scope. Re-generate with all scopes enabled.
Double-charges on retry	This should not happen — the MCP server attaches an `Idempotency-Key` on every chargeable POST. File a bug at github.com/dddFEDDDDDd/devotel-cpaas/issues.

WhatsApp

Guides

Messaging Controls

Audience & Support Tools

Connect Orbit to your AI coding assistant via MCP

Connect Orbit to your AI coding assistant via MCP

Prerequisites

Claude Desktop

Cursor

Claude Code (CLI)

VS Code (GitHub Copilot Chat / MCP extension)

Windsurf

Cline

Zed

Continue

Sandbox mode

Available tools

Example prompts

Security

Troubleshooting

​Connect Orbit to your AI coding assistant via MCP

​Prerequisites

​Claude Desktop

​Cursor

​Claude Code (CLI)

​VS Code (GitHub Copilot Chat / MCP extension)

​Windsurf

​Cline

​Zed

​Continue

​Sandbox mode

​Available tools

​Example prompts

​Security

​Troubleshooting

Connect Orbit to your AI coding assistant via MCP

Prerequisites

Claude Desktop

Cursor

Claude Code (CLI)

VS Code (GitHub Copilot Chat / MCP extension)

Windsurf

Cline

Zed

Continue

Sandbox mode

Available tools

Example prompts

Security

Troubleshooting