# Sequenzy — how to use (mcp.ai)

Connect your Sequenzy account and use 10 tools for marketing automation straight from your AI agent. Connect with your own API key. Sequenzy is an email marketing and automation platform for managing subscribers, campaigns, sequences, transactional email, analytics, and related workspace resources.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_sequenzy?ms=1787291100000`
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. `sequenzy_create_tag`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/sequenzy`
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/sequenzy/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/sequenzy/create/tag` — Create a reusable subscriber tag definition; Sequenzy normalizes its name to lowercase and replaces spaces with hyphens.
  - body: { name: string, color?: string }
- `POST https://api.mcp.ai/api/sequenzy/delete/tag` — Permanently delete a non-system tag definition and remove it from every subscriber. Do not use this on system tags; Sequenzy also rejects tags referenced by sequences.
  - body: { tag_id: string }
- `POST https://api.mcp.ai/api/sequenzy/get/email/metrics` — Return workspace-wide email delivery and engagement totals and rates for a sliding window or custom range, optionally filtered by email type or mailbox provider. Mailbox-provider filtering reports rep
  - body: { end?: string, start?: string, period?: string, email_type?: string, mailbox_provider?: string, include_machine_engagement?: boolean }
- `POST https://api.mcp.ai/api/sequenzy/get/subscriber` — Retrieve one subscriber by email with list memberships, sequence enrollments, notes, engagement totals, and recent activity.
  - body: { email: string, include_machine_engagement?: boolean }
- `POST https://api.mcp.ai/api/sequenzy/list/campaigns` — Discover campaigns in the connected workspace, optionally filtered by delivery status or label, without scheduling or sending them.
  - body: { label?: string, limit?: integer, offset?: integer, status?: string }
- `POST https://api.mcp.ai/api/sequenzy/list/sequences` — Discover automation sequences and inspect whether they accept new enrollments or process existing ones, without activating or enrolling anyone.
  - body: { limit?: integer, labels?: string[], offset?: integer, search?: string, status?: string }
- `POST https://api.mcp.ai/api/sequenzy/list/subscriber/lists` — Return the reusable subscriber lists available for audience filtering and membership workflows.
- `POST https://api.mcp.ai/api/sequenzy/list/subscribers` — Search and filter subscribers in the connected workspace, returning one stable cursor page for audience review or export.
  - body: { limit?: integer, query?: string, status?: string, list_id?: string, tag_names?: string[], segment_id?: string, next_cursor?: string }
- `POST https://api.mcp.ai/api/sequenzy/list/tags` — Return reusable subscriber tag definitions, including which tags are protected system tags.
- `POST https://api.mcp.ai/api/sequenzy/list/templates` — Discover reusable email templates and campaign-backed email bodies by label, returning one page with localization metadata.
  - body: { label?: string, limit?: integer, offset?: integer }

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

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