Kopi MCP Server

Connect Kopi, the email marketing agent, to Claude, Claude Code, Cursor, or any MCP client. Draft on-brand emails, audit Klaviyo performance, and surface what to send next, grounded in your brand's own data.

Server URL

https://www.trykopi.ai/mcp

Remote MCP server · Streamable HTTP transport · OAuth 2.0 authentication

Quick Connect

Claude

Open Settings → Connectors → Add custom connector
Paste the server URL: https://www.trykopi.ai/mcp
Your first tool call opens a browser window to sign in to Kopi (OAuth): free account, no card.

Claude Code

One command in your terminal:

claude mcp add --transport http kopi https://www.trykopi.ai/mcp

Cursor & Others

Any client that supports remote MCP servers over Streamable HTTP can connect with the URL above. OAuth is negotiated automatically via standard discovery.

What You Can Do

Draft On-Brand Emails

One-line prompts become fully designed, production-ready emails rendered from your brand's stored colors, fonts, and style.

Audit Your Program

Campaign and flow performance, audience health, and prioritized recommendations from your Klaviyo data.

Plan What To Send

Ranked campaign ideas, flow updates, newsjacking angles, and trending topics: each with a ready-to-use prompt.

Generate Images & GIFs

Hero banners, product shots, and email-safe animations on demand.

Example Prompts

Set my active brand from mystore.com and tell me what to send next
Audit my brand's email program for the last 90 days
Draft a spring launch email highlighting free shipping
Rewrite this email to be shorter and more urgent
Generate a 16:9 hero banner for the campaign

The Tools

Tool	Type	What it does
`get_context` Brand	Read-only	Get a full briefing for ONE brand: email performance metrics, recent emails, available ideas, and the ids/names of the user's other brands. This provides enough context to answer most questions without additional tool calls, and its otherBrands block is how you discover the right id if you started from the wrong one.
`set_active_brand`	Action	Resolve a brand NAME to a brandId (and optionally create it), then return that brand's full briefing. Despite the name it stores nothing and switches nothing: Kopi keeps no server-side active brand, so the id in the response is what you must pass to every subsequent brand-scoped call.
`list_brands`	Read-only	Return a paginated list of all brands the user can access, with brandId, email counts, and roles. This is the canonical way to get a brandId when you don't have one: every other brand-scoped tool requires it.
`create_email` Email	Action	Generate a new email from a natural-language prompt. Kopi's pipeline plans, art-directs, and renders the email from the brand's stored colors, fonts, and style.
`edit_email`	Action	Surgically edit an existing email in-place. Provide sourceEmailUrl (the emailUrl returned by create_email) plus a prompt describing what to change in plain language (e.g., 'shorten the intro', 'swap the CTA to "Join the waitlist"', 'remove the testimonial').
`view_email`	Read-only	View one email. Provide exactly one identifier: emailId OR emailUrl.
`check_status`	Read-only	Check the status of in-progress work for ONE brand: email generation, brand setup, composed graphics. Shows progress, timestamps, errors, and result URLs.
`get_email_performance` Analysis	Read-only	Get email program performance. Calling with only a brandId returns a 30-day summary.
`refresh_performance_data`	Action	Recompute email performance data (audience, campaigns, flows, lifecycle). This is expensive: it makes many API calls and takes 1-3 minutes.
`get_email_ideas` Ideas	Read-only	Get ideas for what to send next: campaign ideas, flow updates, newsjacking, and trending topics. Each idea includes a priority and a ready-to-use prompt for create_email.
`generate_image` Media	Action	Generate a static image or animated GIF. For images: describe what you want and Kopi generates it using AI.

Resources

The server also exposes MCP resources for deeper reference without extra tool calls:

kopi://getting-started What Kopi does, how OAuth works, and a first-call checklist.
kopi://workflows Tool sequences for auditing a brand, surfacing ideas, drafting/editing emails, and checking status.
kopi://tool-reference One-paragraph-per-tool reference grouped by domain (brand, email, analysis, ideas, media).

Requirements

A free Kopi account, authenticated through OAuth.
Membership in the target brand for brand-scoped tools.
An active Klaviyo integration on the brand for performance and analytics tools: email drafting works without one.

Put an Email Marketing Agent in Your Agent

Create a free Kopi account, connect the MCP server, and ask Claude what your email program should do next.

Questions? rob@trykopi.ai · Privacy policy