KlickTipp MCP Tools (1.0.0)
This specification describes the KlickTipp MCP Server.
It is intended for developers and integrators who want AI assistants — Claude, ChatGPT, or any other MCP-capable client — to interact with KlickTipp through the Model Context Protocol (MCP) instead of raw HTTP calls: to manage newsletters, contacts, tags, custom fields and opt-in processes.
What this document is for: it is a reference, not a live console — it shows what the KlickTipp MCP server can do, so you can see what's possible before connecting anything. You do not need a KlickTipp account, an OAuth sign-in, or a running MCP client just to browse it. It is a separate documentation area from the classic KlickTipp Management API. This document is meant to show the current functional scope of the server, not a fixed contract: tools, schemas and everything else here are subject to change.
Current tool list & source:
agent-pluginsrepository on GitHub. Tools shown in this document are subject to change — the repository always reflects the current state. Once you are connected, any MCP client can also fetch the same tool list live from the server itself with the standard MCP tools/list call.
The KlickTipp MCP server lets AI assistants — Claude, ChatGPT, or any other MCP-capable client — interact with a KlickTipp account through the Model Context Protocol (MCP), instead of raw HTTP calls. The endpoint for the production environment:
| URL | https://mcp.klicktipp.com/mcp |
| Authentication | Managed OAuth 2.0 (no API key, no local server, no .env file needed) |
| Requirement | A KlickTipp Deluxe or Enterprise subscription with permission to log in to the account in question |
Good to know: this MCP Server uses a KlickTipp managed OAuth 2.0, not the Management API's session cookie or key-based authentication.
A rough guide to connecting any MCP-capable client:
Add the server In your MCP client's connector/integration settings, add a new remote MCP server pointing to this URL:
https://mcp.klicktipp.com/mcpComplete the OAuth sign-in Your client redirects you to sign in with your KlickTipp credentials. Every tool call afterwards is made as that signed-in user, against the account they are permitted to access.
Call tools Once connected, call the tools listed in this document by name.
The exact setup steps differ a little by client. Step-by-step instructions for Claude and for ChatGPT specifically are in the MCP server guide.
Before OAuth sign-in completes, calls are expected to return
401 Unauthorized. That is not a configuration error — it is the normal state before login. If a sign-in was interrupted or not approved, simply repeat the connection process.
The KlickTipp MCP server exposes tools that your MCP client can call to interact with a KlickTipp account — to manage newsletters, contacts, tags, custom fields and opt-in processes. Tools are grouped by category in the sidebar.
The MCP server is deliberately designed so an AI assistant can search and read broadly, while critical and irreversible actions stay with a human:
- Sending a newsletter always needs a separate human confirmation inside KlickTipp. The dispatch tool only validates the newsletter and returns a short-lived, single-use confirmation link; the actual send is always confirmed separately by the logged-in user in the KlickTipp app.
- Some destructive actions are available over MCP — for example, deleting a tag, a custom field or an opt-in process. These are irreversible and affect the account directly: use them deliberately, and confirm with a human before calling them.
- Tools that can start or change campaigns, autoresponders or automations as a side effect (assigning or removing a tag, subscribing or unsubscribing a contact) require an explicit
approvalfield in the request, so a calling client can prompt a human before those effects happen.
A failed tool call is handled by the client and returned as a clear, human-readable error — for example when authentication hasn't completed yet, or an unknown tool is called — rather than a raw HTTP response.
For Claude and Codex, KlickTipp also offers a combined plugin package that bundles the MCP server with matching skills. The skills train the assistant to use the tools documented here effectively, with a focus on the structure of the email editor, reporting, and messaging workflows (newsletters and split tests).
For setup instructions per platform (Claude Desktop, ChatGPT, and other agentic tools), see the MCP server plugins guide.