Skip to content
MCP server

segment-mcp

Read-first MCP server for Twilio Segment: routing, stale sources, delivery health…

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
0.1.2
Listing updated
4 days ago

About segment-mcp

segment-mcp is an open-source MCP server. It runs locally on your machine and is started by your AI client.

Read-first MCP server for Twilio Segment: routing, stale sources, delivery health, governance.

Install

Run in a terminal

claude mcp add segment-mcp --env SEGMENT_API_TOKEN='<SEGMENT_API_TOKEN>' --env SEGMENT_REGION='<SEGMENT_REGION>' -- uvx segment-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "segment-mcp": {
      "command": "uvx",
      "args": [
        "segment-mcp"
      ],
      "env": {
        "SEGMENT_API_TOKEN": "<SEGMENT_API_TOKEN>",
        "SEGMENT_REGION": "<SEGMENT_REGION>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "segment-mcp": {
      "command": "uvx",
      "args": [
        "segment-mcp"
      ],
      "env": {
        "SEGMENT_API_TOKEN": "<SEGMENT_API_TOKEN>",
        "SEGMENT_REGION": "<SEGMENT_REGION>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "segment-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "segment-mcp"
      ],
      "env": {
        "SEGMENT_API_TOKEN": "<SEGMENT_API_TOKEN>",
        "SEGMENT_REGION": "<SEGMENT_REGION>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "segment-mcp": {
      "command": "uvx",
      "args": [
        "segment-mcp"
      ],
      "env": {
        "SEGMENT_API_TOKEN": "<SEGMENT_API_TOKEN>",
        "SEGMENT_REGION": "<SEGMENT_REGION>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "segment-mcp": {
      "command": "uvx",
      "args": [
        "segment-mcp"
      ],
      "env": {
        "SEGMENT_API_TOKEN": "<SEGMENT_API_TOKEN>",
        "SEGMENT_REGION": "<SEGMENT_REGION>"
      }
    }
  }
}

Configuration

  • SEGMENT_API_TOKENSegment Public API token. Only a Workspace Owner can mint one — Segment App -> Workspace Settings -> Access Management -> Tokens -> Create Token -> Public API.Required
  • SEGMENT_REGIONWorkspace region: 'us' or 'eu'. No default — must be set explicitly, or the server refuses to start.Required
  • SEGMENT_MCP_MODEread (default) | write | admin. Every tool in v0.1 is read-only regardless of this setting.
  • SEGMENT_PROFILE_TOKENSeparate credential for the Profile API (not yet wired to a tool in this version). Leave unset.
  • SEGMENT_PROFILE_SPACE_IDUnify Space ID for the Profile API (not yet wired to a tool in this version). Leave unset.

Pricing

Open source

segment-mcp FAQ

Is segment-mcp free?

Yes. segment-mcp is open source, so you can use and self-host it for free.

How do I add segment-mcp to Claude Code?

Run this command in your terminal: claude mcp add segment-mcp --env SEGMENT_API_TOKEN='<SEGMENT_API_TOKEN>' --env SEGMENT_REGION='<SEGMENT_REGION>' -- uvx segment-mcp