Build with AI

Model Context Protocol (MCP)

Connect Claude, Cursor, and other AI tools to Deckle so they can manage your email — send messages, build templates and campaigns, edit automations, and manage contacts — straight from chat.

Deckle ships a remote MCP server. Point any MCP-capable AI tool at it with your secret key and it can drive your project through the same v1 API — with the same auth, validation, scoping, and rate limits.

The server#

POSThttps://app.getdeckle.com/mcp

It speaks JSON-RPC over Streamable HTTP and authenticates with a Deckle secret API key in the Authorization header — exactly like the REST API. Every tool call is scoped to the key’s project and environment.

Your config holds a secret

The key in your MCP config can send email and manage your data. Keep the file private, and use a sk_test_ key while you experiment.

Connect your tool#

Get a key from Developers → API keys, replace YOUR_SECRET_KEY below, and add the config for your client. They all point at the same URL and differ only in file format.

claude mcp add --transport http deckle https://app.getdeckle.com/mcp \
  --header "Authorization: Bearer YOUR_SECRET_KEY"

You can also connect from the dashboard: Developers → Connect AI has a copy-paste recipe for each tool.

No remote-MCP support?

If your client can’t send an Authorization header on a remote server, bridge through the mcp-remote stdio proxy:

bash

npx -y mcp-remote https://app.getdeckle.com/mcp \
  --header "Authorization: Bearer YOUR_SECRET_KEY"

What the AI can do#

The server exposes tools across every core resource:

Area	Tools
Emails	Send transactional email, list sent emails, check a message’s status.
Templates	List, read, create, and edit templates (blocks or raw HTML).
Campaigns	List, read, create, update, and send campaigns.
Automations	List, read, create, update, and delete automations.
Contacts	List, read, upsert, update, and delete contacts.
Events	Record custom events for a contact.
Suppressions	List, add, and remove suppressed addresses.

Test it

After connecting, try asking your assistant: “Using Deckle, create a welcome template and send a test to me@example.com.” It will call the tools for you.

Set it up in three steps#

Create a secret key

In Developers → API keys, create a key (start with Test) and copy it.

Add the server to your tool

Paste the config above for your client, swapping in your key, and restart the tool.

Ask it to do something

Deckle’s tools now appear to your assistant. Ask it to draft a campaign or send an email and confirm the result in the dashboard.