segment-mcp
A read-only MCP server for Twilio Segment that helps agents audit event routing, trace events to destinations, identify stale sources, check delivery health, and find ungoverned sources. It is designed to answer complex data governance questions without exposing write or deletion capabilities.
Package and access
Local package with source-attributed installation metadata. Koskamo does not execute packages during review.
What you can do with it
- Audit which destinations receive specific events
- Trace event routing and governance status
- Identify stale or dead data sources
- Check destination delivery health
Source and maintenance
- Maintenance checked
Packages and installation
Source-provided package data. Koskamo has not executed or live-probed this package.
segment-mcp 0.1.2
{
"version": "0.1.2",
"transport": "stdio",
"identifier": "segment-mcp",
"runtimeHint": "uvx",
"registryType": "pypi",
"registryBaseUrl": "https://pypi.org",
"environmentVariables": [
{
"name": "SEGMENT_API_TOKEN",
"isRequired": true,
"description": "Segment Public API token. Only a Workspace Owner can mint one — Segment App -> Workspace Settings -> Access Management -> Tokens -> Create Token -> Public API."
},
{
"name": "SEGMENT_REGION",
"isRequired": true,
"description": "Workspace region: 'us' or 'eu'. No default — must be set explicitly, or the server refuses to start."
},
{
"name": "SEGMENT_MCP_MODE",
"default": "read",
"description": "read (default) | write | admin. Every tool in v0.1 is read-only regardless of this setting."
},
{
"name": "SEGMENT_PROFILE_TOKEN",
"description": "Separate credential for the Profile API (not yet wired to a tool in this version). Leave unset."
},
{
"name": "SEGMENT_PROFILE_SPACE_ID",
"description": "Unify Space ID for the Profile API (not yet wired to a tool in this version). Leave unset."
}
]
}Tools
Reported by the attributed source; not independently observed by Koskamo.
Connect from your client
Each snippet configures the same source-provided package; replace placeholders before use.
Cursor
{
"mcpServers": {
"segment-mcp-mcp": {
"command": "uvx",
"args": [
"segment-mcp==0.1.2"
],
"env": {
"SEGMENT_API_TOKEN": "<YOUR_SEGMENT_API_TOKEN>",
"SEGMENT_REGION": "<YOUR_SEGMENT_REGION>",
"SEGMENT_MCP_MODE": "<YOUR_SEGMENT_MCP_MODE>",
"SEGMENT_PROFILE_TOKEN": "<YOUR_SEGMENT_PROFILE_TOKEN>",
"SEGMENT_PROFILE_SPACE_ID": "<YOUR_SEGMENT_PROFILE_SPACE_ID>"
}
}
}
}Cline
{
"mcpServers": {
"segment-mcp-mcp": {
"command": "uvx",
"args": [
"segment-mcp==0.1.2"
],
"env": {
"SEGMENT_API_TOKEN": "<YOUR_SEGMENT_API_TOKEN>",
"SEGMENT_REGION": "<YOUR_SEGMENT_REGION>",
"SEGMENT_MCP_MODE": "<YOUR_SEGMENT_MCP_MODE>",
"SEGMENT_PROFILE_TOKEN": "<YOUR_SEGMENT_PROFILE_TOKEN>",
"SEGMENT_PROFILE_SPACE_ID": "<YOUR_SEGMENT_PROFILE_SPACE_ID>"
}
}
}
}VS Code
{
"servers": {
"segment-mcp-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"segment-mcp==0.1.2"
],
"env": {
"SEGMENT_API_TOKEN": "<YOUR_SEGMENT_API_TOKEN>",
"SEGMENT_REGION": "<YOUR_SEGMENT_REGION>",
"SEGMENT_MCP_MODE": "<YOUR_SEGMENT_MCP_MODE>",
"SEGMENT_PROFILE_TOKEN": "<YOUR_SEGMENT_PROFILE_TOKEN>",
"SEGMENT_PROFILE_SPACE_ID": "<YOUR_SEGMENT_PROFILE_SPACE_ID>"
}
}
}
}Claude Desktop
{
"mcpServers": {
"segment-mcp-mcp": {
"command": "uvx",
"args": [
"segment-mcp==0.1.2"
],
"env": {
"SEGMENT_API_TOKEN": "<YOUR_SEGMENT_API_TOKEN>",
"SEGMENT_REGION": "<YOUR_SEGMENT_REGION>",
"SEGMENT_MCP_MODE": "<YOUR_SEGMENT_MCP_MODE>",
"SEGMENT_PROFILE_TOKEN": "<YOUR_SEGMENT_PROFILE_TOKEN>",
"SEGMENT_PROFILE_SPACE_ID": "<YOUR_SEGMENT_PROFILE_SPACE_ID>"
}
}
}
}Let your agent find its tools
Find servers like segment-mcp from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.