Segment MCP Server — Hosted Api Connectors Integration
MCP Server language Hosted language PublicSend track, identify, group, and page events to Segment — unify your customer data pipeline with AI.
Use with AI AssistantsMCP
Connect Claude, Cursor, or any MCP-compatible client — then call tools directly
① Add This MCP Server
Paste into your AI client config — then all its tools are available instantly.
{
"mcpServers": {
"segment": {
"url": "https://mcp.aerostack.dev/s/aerostack/mcp-segment",
"headers": {
"Authorization": "Bearer YOUR_AEROSTACK_TOKEN"
}
}
}
}Replace YOUR_AEROSTACK_TOKEN with your API token from the dashboard.
② Call a Tool
Ask your AI assistant to call a specific tool, or send raw JSON-RPC:
Natural Language Prompt
“Use the _ping tool to verify segment credentials by calling a lightweight read endpoint. used internally by aerostack to validate credentials”
Using a Workspace?
Add this MCP to your Workspace — your team shares one token, secrets are stored securely, and every AI agent in the workspace can call it without per-user setup.
description Overview
mcp-segment — Segment MCP Server
Track events, identify users, and send data to all your downstream tools via Segment.
Segment is the customer data platform that sits between your product and every analytics, marketing, and data warehouse tool you use. Every event sent through this MCP flows to all your connected Segment destinations — Amplitude, Mixpanel, Salesforce, BigQuery, and more — making it the highest-leverage place to send behavioral data from agent workflows.
Live endpoint: https://mcp.aerostack.dev/s/aerostack/mcp-segment
What You Can Do
- Send backend events into Segment from server-side automation workflows, reaching all downstream destinations simultaneously
- Identify users and set traits (email, plan, company) that sync to your CRM, email platform, and analytics tools
- Associate users with accounts or organizations using group calls for B2B analytics and segmentation
- Use batch_track to send up to 500 events in a single request for high-throughput import scenarios
Available Tools
| Tool | Description |
|---|---|
track_event |
Track a user action or event (e.g. "Button Clicked", "Order Completed") |
identify_user |
Identify a user and associate traits (email, name, plan, etc.) |
group_user |
Associate a user with a group or account and set group traits |
page_view |
Record a page view for web analytics |
screen_view |
Record a mobile screen view |
alias_user |
Alias two user identities (merge anonymous to identified) |
batch_track |
Send up to 500 events in a single request |
Configuration
| Variable | Required | Description | How to Get |
|---|---|---|---|
SEGMENT_WRITE_KEY |
Yes | Source write key for event ingestion | app.segment.com → Connections → Sources → your source → Settings → copy Write Key |
Quick Start
Add to Aerostack Workspace
- Go to aerostack.dev → Your Project → MCPs
- Search for "Segment" and click Add to Workspace
- Add your
SEGMENT_WRITE_KEYunder Project → Secrets
Once added, every AI agent in your workspace can call Segment tools automatically — no per-user setup needed.
Example Prompts
"Track a subscription_started event for user u_12345 with properties plan: pro and amount: 99"
"Identify user john@example.com with traits name: John Smith and company: Acme Corp"
"Send a group call associating user u_12345 with account org_678 with trait plan: enterprise"
Direct API Call
curl -X POST https://mcp.aerostack.dev/s/aerostack/mcp-segment \
-H 'Content-Type: application/json' \
-H 'X-Mcp-Secret-SEGMENT-WRITE-KEY: your-write-key' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"track_event","arguments":{"userId":"u_12345","event":"Order Completed","properties":{"revenue":49.99}}}}'
License
MIT
terminal Tools (8)
Available tools on this MCP server. Each tool can be called directly from any AI agent.
_ping #1 Verify Segment credentials by calling a lightweight read endpoint. Used internally by Aerostack to validate credentials.
track_event #2 Track a user action or event in Segment (e.g. "Button Clicked", "Order Completed")
identify_user #3 Identify a user and associate traits (email, name, plan, etc.) with their profile
group_user #4 Associate a user with a group/account and set group traits (company name, industry, etc.)
page_view #5 Record a page view in Segment (web analytics)
screen_view #6 Record a mobile screen view in Segment
alias_user #7 Alias (merge) two user identities — typically used when an anonymous user signs up
batch_track #8 Send multiple events in a single request (up to 500). Each event can be track, identify, or page type.
Details
language Live Endpoint
https://mcp.aerostack.dev/s/aerostack/mcp-segment
Sub-50ms globally · Zero cold start
Publisher
Pre-built functions for the most common MCP tool patterns. Clone, extend, and deploy.
More in API Connectors
Browse API Connectors MCPs →Aerostack Registry
by @aerostack
Discover and invoke any MCP, Function, or Skill published to the Aerostack marketplace — the universal AI capability hub.
Algolia
by @aerostack
Search indexes, manage records, browse data, and configure ranking in Algolia — AI-native instant search access.
Arangodb
by @aerostack
Query documents, run AQL, traverse graphs, and manage collections in your ArangoDB database — AI-native multi-model database access.
Ayrshare
by @aerostack
Post, schedule, and analyze social media across 13 platforms — Facebook, Instagram, X, LinkedIn, TikTok, Bluesky, Threads, Reddit, Pinterest, YouTube, Telegram, Snapchat, Google Business.
Basecamp
by @aerostack
Manage projects, to-dos, messages, schedules, and campfire chats in Basecamp — AI-native project management.
Bigquery
by @aerostack
Run SQL queries, list datasets and tables, inspect schemas, and export results from Google BigQuery — AI-native data warehouse access.
Frequently asked questions
What is the Segment MCP server and what can it do? +
The Segment MCP server is hosted on Aerostack and exposes these tools to your AI agent: `_ping`, `track_event`, `identify_user`, `group_user`, `page_view`. You get one hosted URL — no self-hosting — that works from Claude, Cursor, ChatGPT, Gemini, VS Code, or any MCP-compatible client, and you can share it with your team or combine it with other MCP servers in a workspace.
Is the Segment MCP server hosted, or do I have to run it myself? +
It's hosted on Aerostack's edge infrastructure — you don't deploy or maintain anything. Add it to a workspace and you get one authenticated URL, with secrets encrypted, that any AI agent or editor can connect to. Use it solo or share the same URL across your whole team.
Which AI agents and editors can use the Segment MCP server? +
Any MCP client: Claude and Claude Code, Cursor, ChatGPT, Gemini, Windsurf, Cline, VS Code, and custom agents. Because it's one hosted URL, the same Segment MCP server works everywhere — and you can compose it with other MCP servers, skills, and functions behind a single workspace URL.
How do I install the Segment MCP server in Claude Desktop? +
Add the following to your Claude Desktop config (`claude_desktop_config.json`): ```json { "mcpServers": { "@aerostack/mcp-segment": { "command": "npx", "args": ["-y", "@aerostack/@aerostack/mcp-segment"] } } } ``` Then restart Claude Desktop and the tools will appear automatically.
How do I use the Segment MCP server in Cursor? +
In Cursor, open **Settings → MCP** and add: ```json { "name": "@aerostack/mcp-segment", "command": "npx", "args": ["-y", "@aerostack/@aerostack/mcp-segment"] } ``` Save and reload Cursor. The MCP tools will be available in Agent mode.
Does Segment MCP require authentication? +
Yes. Segment requires authentication. Check the MCP's documentation for the required credentials.