MCP

Connect Speko to Claude Code, Codex, OpenCode, Cursor, and other AI coding tools.

Speko MCP gives coding agents authenticated access to Speko operational tools for organizations, agents, sessions, calls, phone numbers, knowledge bases, evals, deployment, and migration helpers.

Install in your tool

For guided setup, run the Speko MCP wizard:

npx @spekoai/mcp@latest init

The hosted endpoint is:

https://mcp.speko.ai/mcp

Authenticate with OAuth when your MCP client supports it, or use a Speko API key from API keys.

Add Speko MCP with OAuth:

claude mcp add --transport http speko https://mcp.speko.ai/mcp

Then run /mcp in Claude Code and complete the browser sign-in.

To use an API key instead:

claude mcp add --transport http speko https://mcp.speko.ai/mcp \
  --header "Authorization: Bearer sk_live_xxx"

Add Speko MCP to ~/.codex/config.toml:

[mcp_servers.speko]
url = "https://mcp.speko.ai/mcp"

Then authenticate:

codex mcp login speko

To use an API key instead:

[mcp_servers.speko]
url = "https://mcp.speko.ai/mcp"
bearer_token_env_var = "SPEKO_API_KEY"

Add Speko MCP to opencode.json:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "speko": {
      "type": "remote",
      "url": "https://mcp.speko.ai/mcp",
      "enabled": true
    }
  }
}

Then authenticate:

opencode mcp auth speko

To use an API key instead:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "speko": {
      "type": "remote",
      "url": "https://mcp.speko.ai/mcp",
      "oauth": false,
      "headers": {
        "Authorization": "Bearer {env:SPEKO_API_KEY}"
      },
      "enabled": true
    }
  }
}

Open Cursor Settings > MCP > Add new global MCP server, then add:

{
  "mcpServers": {
    "speko": {
      "url": "https://mcp.speko.ai/mcp"
    }
  }
}

To use an API key instead:

{
  "mcpServers": {
    "speko": {
      "url": "https://mcp.speko.ai/mcp",
      "headers": {
        "Authorization": "Bearer ${env:SPEKO_API_KEY}"
      }
    }
  }
}

Configure a remote MCP server with Streamable HTTP:

Setting	Value
Name	`speko`
URL	`https://mcp.speko.ai/mcp`
OAuth	Use the client's OAuth flow
API key auth	Send `Authorization: Bearer sk_live_xxx`

What to ask your agent

Once connected, ask your agent to:

inspect organization usage and credit balance;
create, update, deploy, or roll back agents;
create sessions and inspect call transcripts or recordings;
create phone numbers, knowledge bases, and evals;
convert external voice-agent configs with inspect_workspace, parse_external_config, and build_session_config.

Install in your tool

What to ask your agent

On this page