---
title: "SegMetrics MCP server"
url: "https://martechdb.com/vendors/segmetrics"
markdown_url: "https://martechdb.com/vendors/segmetrics.md"
api_url: "https://martechdb.com/api/v1/vendors/segmetrics.io"
updated: "2026-10-05"
---

# SegMetrics MCP server

Yes. SegMetrics publishes an official MCP server at an address made for your account (https://app.segmetrics.io/mcp/{ACCOUNT\_ID}). It's hosted. It offers 11 tools. MartechDB lists only servers the vendor publishes itself, never community servers.

- Website: [segmetrics.io](https://segmetrics.io)
- API access for agents: Included in plan, plan: Scale, no free access. Limits: No rate limits published; contact endpoints return 1-100 records per page (default 20). Terms say limits may be enforced. ([source](https://segmetrics.io/pricing/), [limits source](https://developers.segmetrics.io/))
- Categories: [Marketing attribution](https://martechdb.com/categories/marketing-attribution.md)

## SegMetrics MCP Server

- Address: https://app.segmetrics.io/mcp/{ACCOUNT_ID}
- Runs: Hosted
- Sign-in: Sign-in: see vendor docs (`unknown`)
- Cost to use: Included in plan, plan: Active SegMetrics account (no specific plan stated). ([source](https://docs.segmetrics.io/article/672-mcp-server))
- Official MCP Registry: not listed
- Documentation: https://docs.segmetrics.io/article/672-mcp-server
- How we know it's official: The vendor's own documentation
- First seen: 2026-10-05
- Last checked: not checked yet

### Tools (11)

The server needs sign-in before it lists its tools, so these are as the vendor's documentation names them ([source](https://docs.segmetrics.io/article/672-mcp-server)), read on 2026-10-07. They may be out of date.

- `get-account-info`: Returns your account context: account name, timezone, currency, attribution model, feature flags, subscription plan, connected integrations, and a data summary. The AI typically calls this first to understand your account before making queries.
- `run-query`: Executes a report query against your SegMetrics data. This is the primary tool for pulling metrics and analyzing performance. It supports 16 report types (including acquisition, ads, revenue, funnel, leads, subscriptions, and more), with filtering, grouping by dimensions, date ranges, time comparisons, and multiple attribution models.
- `get-contacts`: Retrieves individual contact or order records matching filter criteria. Use this to drill down from aggregate numbers to specific people. Supports contact, order, and individual purchase views.
- `get-metrics`: Searches the 370+ available metrics in SegMetrics. The AI uses this to discover which metrics are valid for a given report type before running a query.
- `get-dimensions`: Searches available dimensions (group-by fields) for reports. Includes account-specific custom dimensions pulled from your integration custom fields, such as CRM custom properties.
- `get-filters`: Searches available filters and pruners. Filters narrow which contacts are included in a report (applied before aggregation). Pruners narrow which rows appear in results (applied after aggregation).
- `get-products`: Returns your products with revenue and volume stats. Supports keyword search and date range filtering so the AI can understand what your business sells before analyzing performance.
- `get-tags`: Returns tags with contact counts. Supports keyword search and date range filtering. When a date range is provided, contact counts reflect only contacts tagged within that period.
- `get-lists`: Returns lists with contact counts. Supports keyword search and date range filtering. When a date range is provided, contact counts reflect only contacts added within that period.
- `get-segments`: Returns saved audience segments with their filter definitions. The AI uses this to discover existing segments before filtering reports or analyzing specific audiences.
- `get-traffic-sources`: Returns active traffic sources: channels, UTM sources, mediums, and campaigns with recent data. The AI uses this to discover what traffic sources exist before querying their performance.

### Connect it

Claude Code:

```sh
claude mcp add --transport http segmetrics 'https://app.segmetrics.io/mcp/{ACCOUNT_ID}'
```

- Add to Cursor: <cursor://anysphere.cursor-deeplink/mcp/install?name=segmetrics&config=eyJ1cmwiOiJodHRwczovL2FwcC5zZWdtZXRyaWNzLmlvL21jcC97QUNDT1VOVF9JRH0ifQ%3D%3D>
- Add to VS Code: <vscode:mcp/install?%7B%22name%22%3A%22segmetrics%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fapp.segmetrics.io%2Fmcp%2F%7BACCOUNT_ID%7D%22%7D>
- Claude.ai and Claude Desktop: Customize, Connectors, "+", Add custom connector, then paste https://app.segmetrics.io/mcp/{ACCOUNT_ID}
- ChatGPT: Settings, Apps, Advanced settings, turn on Developer mode, Create, then paste https://app.segmetrics.io/mcp/{ACCOUNT_ID} (this usually works only with servers that use self-serve sign-in or none)

JSON for Cursor, Windsurf and other clients that connect to hosted servers:

```json
{
    "mcpServers": {
        "segmetrics": {
            "type": "http",
            "url": "https://app.segmetrics.io/mcp/{ACCOUNT_ID}"
        }
    }
}
```

## Questions

### Does SegMetrics have an official MCP server?

Yes. SegMetrics publishes its MCP server itself. SegMetrics's own documentation describes it. MartechDB only lists servers a vendor publishes, never community copies.

### What is the SegMetrics MCP server URL?

The address is https://app.segmetrics.io/mcp/{ACCOUNT\_ID}, with the parts in braces filled in for your SegMetrics account.

### How do I connect SegMetrics MCP to Claude, ChatGPT or Cursor?

In Claude, add https://app.segmetrics.io/mcp/{ACCOUNT\_ID} as a custom connector (Customize, Connectors, Add custom connector). In Cursor, use the Add to Cursor link on MartechDB's page, or paste the JSON settings into your mcp.json. In Claude Code, run: claude mcp add --transport http segmetrics 'https://app.segmetrics.io/mcp/{ACCOUNT\_ID}'

### What can the SegMetrics MCP server do?

It offers 11 tools, including get-account-info, run-query, get-contacts, get-metrics and get-dimensions (as its documentation names them, read on 7 Oct 2026).

### Is the SegMetrics MCP server in the official MCP Registry?

No. SegMetrics hasn't published it to the official MCP Registry.

## Change history

- 2026-10-05: SegMetrics MCP Server added
- 2026-10-05: Added to MartechDB

## Alternatives with an official MCP server

In Marketing attribution:

- [Airbridge](https://martechdb.com/vendors/airbridge.md) (airbridge.io)
- [HYROS](https://martechdb.com/vendors/hyros.md) (hyros.com)
- [Roistat](https://martechdb.com/vendors/roistat.md) (roistat.com)
- [Factors.ai](https://martechdb.com/vendors/factorsai.md) (factors.ai)

## Get this data

- API: `curl https://martechdb.com/api/v1/vendors/segmetrics.io`
- MCP: `claude mcp add --transport http martechdb https://martechdb.com/mcp`, then ask about SegMetrics.
- Web page: https://martechdb.com/vendors/segmetrics
