charlieai.co › docs › mcp

Charlie MCP

Charlie's Model Context Protocol server lets any LLM client — Claude, ChatGPT, Gemini, or a custom agent — operate your Charlie workspace through a typed, versioned API. Read your templates, send campaigns, manage contacts, activate flows. No SDK. One endpoint.

Endpoint: https://charlieai.co/mcp
Transport: Streamable HTTP (March 2025 MCP spec)
Auth: OAuth 2.1 (with PKCE) or X-Charlie-API-Key header

Connect in 30 seconds

Claude (custom connector)

Open Claude → Settings → Connectors → Add custom connector.
Paste https://charlieai.co/mcp.
Claude walks you through OAuth: you'll be asked which .myshopify.com workspace to authorize. Allow.
Charlie's 13 tools appear in the connector list. Done.

ChatGPT / Gemini / any MCP client

Same endpoint, same OAuth flow. The discovery endpoints follow standards:

/.well-known/oauth-authorization-server (RFC 8414)
/.well-known/oauth-protected-resource (RFC 9728)

API key (testing / custom integrations)

Request a long-lived API key from hello@charlieai.co. Pass it as a header on every request — no OAuth dance:

curl https://charlieai.co/mcp \
  -X POST \
  -H 'X-Charlie-API-Key: <your-key>' \
  -H 'content-type: application/json' \
  -H 'accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Tools

Tool	Type	What it does
`list-templates`	read	Search & filter 448 production email templates.
`get-template`	read	Full HTML body + metadata for one template.
`list-flows`	read	Summaries of the four e-commerce flow blueprints.
`get-flow-blueprint`	read	Full specification of one flow.
`get-workspace-status`	read	Subscribers, deliverability score, IP pool, warmup, active flows.
`get-deliverability`	read	Bounce / complaint rates, score history, pool migrations.
`list-contacts`	read	Paginated, filterable contact list with consent provenance.
`get-campaign-history`	read	Sent campaigns with recipient counts and delivery outcomes.
`send-campaign`	write	Queue a campaign for sending. Subject to warmup & pool tier.
`create-contact`	write	Upsert one contact. Idempotent.
`import-contacts`	write	Bulk upsert (≤1000 per call). Idempotent.
`activate-flow`	write	Enable welcome / abandoned-cart / post-purchase / winback.
`pause-flow`	write	Disable a flow. In-flight instances continue.

What Charlie does not do

No open or click tracking. Charlie strips tracking pixels. ePrivacy compliance is built into the product, not a setting. Performance metrics are delivery, bounces, complaints, revenue — not opens.
No HTML generation. The LLM uses Charlie's 448 templates (via list-templates / get-template) or supplies its own HTML.
No bypass of warmup or pool tier protections. Even with the right scopes, send-campaign respects today's warmup cap. Calls exceeding it return a warmup_cap error.

Scopes

Scope	Grants
`mcp:read`	Any tool with `readOnlyHint: true`.
`mcp:write`	The five write tools above.

Auditability

Every write call lands in audit_log with the actor token, the action, and the target. Charlie's ops console at ops.charlieai.co surfaces these as searchable rows — required for EU AI Act Section 11 compliance, useful for everyone.

Privacy: /privacy · Terms: /terms · Status: /mcp/health