Skip to main content

Documentation Index

Fetch the complete documentation index at: https://help.xoxo.email/llms.txt

Use this file to discover all available pages before exploring further.

The XOXO MCP server exposes everything in the REST API as tools that AI assistants like Claude and ChatGPT can call directly. Ask your assistant to draft a campaign, import subscribers from a spreadsheet, or build a segment — it picks the right tools and runs them against your account.

​
Server details

Endpoint

https://mcp.xoxo.email

Transport

Streamable HTTP, JSON-RPC 2.0

Protocol version

2025-06-18

Authentication

Bearer token

​
Authentication

The MCP server uses the same bearer tokens as the REST API. Get one in Settings → Apps and pass it in the Authorization header on every request.
A single token has full access to your account — treat it like a password and never embed it in client-side code.

​
Connect a client

1

Open Settings → Connectors

In Claude Desktop, click your profile, then Settings → Connectors.
2

Add a custom connector

Click Add custom connector and fill in:
  • Name: XOXO
  • Server URL: https://mcp.xoxo.email
  • Authentication: Bearer token
  • Token: paste your XOXO API key
3

Enable in a chat

Start a new conversation, click the connector picker, and toggle XOXO on.
Once connected, ask your assistant something like “List my five most recent subscribers in XOXO” — it should call list_subscribers and return real data from your account.

​
Rate limits

Requests are rate limited per API key. When you exceed the limit, the server responds with 429 Too Many Requests. Back off and retry after a short delay.