# Segmetrics — how to use (mcp.ai)

Connect your Segmetrics account and use 3 tools for analytics straight from your AI agent. Connect with your own API key. SegMetrics is a marketing analytics platform that provides detailed insights into customer journeys, helping businesses optimize their marketing strategies.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_segmetrics?ms=1787291400000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `segmetrics_create_product`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/segmetrics`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/segmetrics/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/segmetrics/create/product` — Tool to create a new product in SegMetrics. Use after confirming product details.
  - body: { id: string, name: string, type?: string, price?: number, account_id: string, description?: string, external_id?: string, integration_id: string }
- `POST https://api.mcp.ai/api/segmetrics/delete/contact` — Tool to permanently delete a specific contact by ID or email from SegMetrics. Use after confirming the contact exists. This action is irreversible. Note: Associated invoices and purchases remain in th
  - body: { account_id: string, integration_id: string, contact_id_or_email: string }
- `POST https://api.mcp.ai/api/segmetrics/v1/add/or/update/contact` — Tool to add or update a contact in SegMetrics. Use when you need to upsert the contact record during data import.
  - body: { email: string, status?: string, utm_term?: string, last_name?: string, account_id: string, contact_id?: string, first_name?: string, utm_medium?: string, utm_source?: string, utm_content?: string, date_created?: string, last_updated?: string, utm_campaign?: string, integration_id: string }

## Example prompts
- "What can I do in Segmetrics?"
- "Show me a summary of my Segmetrics account"

## More
- Page: https://mcp.ai/segmetrics
- Agent spec (llms.txt): https://mcp.ai/segmetrics/llms.txt
- Postman collection: https://mcp.ai/segmetrics/postman.json