spix-mcp

MCP server for Spix — give any MCP-compatible AI client a phone number, an inbox, and a voice.

spix-mcp is a standalone Model Context Protocol server that exposes Spix's communications infrastructure — phone calls, email, contacts, analytics — as MCP tools and resources.

Connect it to Claude Desktop, Cursor, or any MCP-compatible client and your AI can literally pick up the phone.

Install

# via pip
pip install spix-mcp

# via uvx (no install needed)
uvx spix-mcp

The Spix CLI must also be installed and authenticated:

curl -fsSL https://spix.sh/install.sh | sh
spix auth login

Quick setup: Claude Desktop

The fastest way — use the built-in installer from the Spix CLI:

spix mcp install claude

This writes the correct config to ~/Library/Application Support/Claude/claude_desktop_config.json automatically. Restart Claude Desktop and Spix tools appear immediately.

Or configure manually in claude_desktop_config.json:

{
  "mcpServers": {
    "spix": {
      "command": "uvx",
      "args": ["spix-mcp"],
      "env": {
        "SPIX_API_KEY": "spix_live_sk_your_key_here"
      }
    }
  }
}

Get your API key from app.spix.sh/settings/api-keys.

Quick setup: Cursor

spix mcp install cursor

Or add to your Cursor MCP config manually with the same JSON structure as above.

What your AI can do

Once connected, your AI client has access to 43 tools (safe profile) or 49 tools (full profile) across all Spix capabilities:

Phone calls

Email

SMS

Playbooks

Contacts

Phone numbers

Auth & API keys

Billing & analytics

Webhooks

Resources (readable state)

The MCP server also exposes live-readable resources:

resource://calls/{id}/transcript     — Call transcript
resource://calls/{id}/summary        — Call summary + extraction
resource://sms/{id}/thread           — SMS thread
resource://playbook/{id}             — Playbook details
resource://contact/{id}              — Contact details
resource://contact/{id}/history      — Contact history
resource://phone/{id}/route          — Phone number routing
resource://billing/credits           — Credit balance
resource://billing                   — Billing overview

Tool profiles

For production deployments, safe is recommended. Use full only for trusted clients.

Configuration

All configuration is via environment variables:

Scoped access example

Restrict what your agent can access:

{
  "mcpServers": {
    "spix": {
      "command": "uvx",
      "args": ["spix-mcp"],
      "env": {
        "SPIX_API_KEY": "spix_live_sk_your_key_here",
        "SPIX_DEFAULT_PLAYBOOK": "plb_call_abc123",
        "SPIX_SESSION_NAME": "sales-bot",
        "SPIX_TOOL_PROFILE": "safe"
      }
    }
  }
}

Example: Ask Claude to make a call

Once configured, you can ask Claude (or any connected client) directly:

"Call +19175550123 using the prospect-qualifier playbook and tell me what they said."

Claude will use spix_call_create, monitor the call, then call spix_call_summary to return the result — without you writing any code.

How it works

Your Agent (Claude, Cursor, etc.)
    ↓ MCP tool call
Spix MCP Server (this package)
    ↓ HTTP API call
Spix Backend (api.spix.sh)
    ↓ Carrier APIs
Phone call / Email / SMS

The MCP server is a thin bridge between the MCP protocol and the Spix REST API. All business logic runs server-side.

Voice calls

When your agent calls spix_call_create, Spix:

1. Dials the number via Telnyx/Twilio

2. Uses Deepgram Nova-3 for real-time speech recognition

3. Uses Claude for conversation turn generation

4. Uses Cartesia Sonic-3 for text-to-speech

5. Records the call and generates a transcript + summary

Your agent can then read the transcript and summary via spix_call_transcript and spix_call_summary.

Relationship to spix CLI

spix-mcp is the standalone MCP server package. The full Spix CLI includes the MCP server built in (spix mcp serve) alongside all other Spix commands.

Use spix-mcp if you only need the MCP server (e.g. for Claude Desktop integration without installing the full CLI). Use the full CLI if you want all Spix commands available in your terminal.

Requirements

• Python 3.10+

• Spix account (free Sandbox for email; Agent plan for calls)

• API key from app.spix.sh

Links

• Spix — AI agent communications infrastructure: spix.sh

• Dashboard: app.spix.sh

• Docs — MCP server reference: docs.spix.sh/mcp

• Spix CLI — phone calls, SMS, email from the terminal: Spix-HQ/spix-cli

• PyPI: pypi.org/project/spix-mcp

• Recipes — ready-to-use agent workflows: spix.sh/recipes

• Blog — tutorials and guides: spix.sh/blog

• X/Twitter: @spixhq

License

MIT — see LICENSE