Orbit CPaaS — MCP Server

Stdio-based Model Context Protocol server that exposes the Orbit CPaaS API as first-class tools for any MCP client (Claude Desktop, Claude Code, Cursor, VS Code extensions, custom agent harnesses, …).

Docs: https://docs.orbit.devotel.io/guides/mcp-claude-cursor

Install

Most MCP clients launch the server on demand with npx, so no separate install step is needed — the per-client config blocks below do it for you. To install it explicitly:

npm install -g @devotel-orbit/mcp-server

The package installs a single orbit-mcp-server binary.

Quick start

ORBIT_API_KEY=dv_live_sk_xxxxxxxxxxxxxxxx npx @devotel-orbit/mcp-server

The process speaks JSON-RPC framing on stdio per the MCP spec. All logs go to stderr — never write to stdout from this server (it would corrupt MCP framing).

---

Claude Desktop setup

Add an entry to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

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

Restart Claude Desktop. The Orbit tools appear in the toolbox on the next conversation. Verify with: "List my Orbit campaigns."

Sandbox mode (no charges)

Use a test key (dv_test_sk_*) to exercise every tool against the sandbox without incurring real charges. Sandbox calls are logged in the Orbit dashboard under Settings → API Logs → sandbox.

---

Cursor setup

Click the badge above to install with one click (Cursor prompts you to confirm, then fill in your real ORBIT_API_KEY), or set it up manually. Open Cursor Settings → Features → MCP → Add new MCP server and set:

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

Alternatively, add to .cursor/mcp.json in your project root:

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

Cursor automatically reloads MCP config on file save. Test with @orbit in any Cursor chat: "Using orbit, send an SMS to +14155551234 saying hello."

---

Claude Code (CLI)

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

Or add the block below to your project's .claude/settings.json / .mcp.json:

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

---

VS Code (GitHub Copilot Chat / MCP extension)

Add to .vscode/mcp.json in your workspace (or User Settings → mcp.servers for a global install):

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

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

---

Windsurf

Open **Windsurf Settings → Cascade → MCP S