# KlickTipp MCP Tools 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-plugins` repository on GitHub](https://github.com/klicktipp/agent-plugins). 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. --- ## MCP Server 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. --- ## Getting Started A rough guide to connecting any MCP-capable client: 1. **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/mcp ``` 2. **Complete 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. 3. **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](https://developers.klicktipp.com/guides/mcp-server). > 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. --- ## Tool Catalog 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. --- ## Security Behaviour 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 `approval` field in the request**, so a calling client can prompt a human before those effects happen. --- ## Error Handling 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. --- ## Plugin & Further Use Cases 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](https://developers.klicktipp.com/guides/mcp-server-plugins). Version: 1.0.0 ## Download OpenAPI description - [KlickTipp MCP Tools](https://developers.klicktipp.com/_bundle/mcp.yaml) ## Contact Tagging - [Assign Manual Tag](https://developers.klicktipp.com/mcp/contact-tagging/tag-contact.md): MCP Tool: tag-contact - [Remove Manual Tag](https://developers.klicktipp.com/mcp/contact-tagging/untag-contact.md): MCP Tool: untag-contact ## Contacts - [Get Contact](https://developers.klicktipp.com/mcp/contacts/get-contact.md): MCP Tool: get-contact - [Get Subscription Redirect URL](https://developers.klicktipp.com/mcp/contacts/get-opt-in-process-redirect-url.md): MCP Tool: get-opt-in-process-redirect-url - [Search Contacts](https://developers.klicktipp.com/mcp/contacts/search-contacts.md): MCP Tool: search-contacts - [Subscribe Contact](https://developers.klicktipp.com/mcp/contacts/subscribe-contact-via-opt-in-process.md): MCP Tool: subscribe-contact-via-opt-in-process - [Unsubscribe Contact](https://developers.klicktipp.com/mcp/contacts/unsubscribe-contact.md): MCP Tool: unsubscribe-contact - [Update Contact](https://developers.klicktipp.com/mcp/contacts/update-contact-values.md): MCP Tool: update-contact-values - [Create Contact](https://developers.klicktipp.com/mcp/contacts/upsert-subscribed-contact.md): MCP Tool: upsert-subscribed-contact ## Data Fields - [Create Custom Field](https://developers.klicktipp.com/mcp/data-fields/create-custom-field.md): MCP Tool: create-custom-field - [Delete Custom Field](https://developers.klicktipp.com/mcp/data-fields/delete-custom-field.md): MCP Tool: delete-custom-field - [Get Custom Field](https://developers.klicktipp.com/mcp/data-fields/get-custom-field.md): MCP Tool: get-custom-field - [Search Custom Fields](https://developers.klicktipp.com/mcp/data-fields/search-custom-fields.md): MCP Tool: search-custom-fields - [Update Custom Field](https://developers.klicktipp.com/mcp/data-fields/update-custom-field.md): MCP Tool: update-custom-field ## Email Editor - [Add Email Button](https://developers.klicktipp.com/mcp/email-editor/add-email-editor-button.md): MCP Tool: add-email-editor-button - [Add Email Divider](https://developers.klicktipp.com/mcp/email-editor/add-email-editor-divider.md): MCP Tool: add-email-editor-divider - [Add Email Heading](https://developers.klicktipp.com/mcp/email-editor/add-email-editor-heading.md): MCP Tool: add-email-editor-heading - [Add Email Custom HTML](https://developers.klicktipp.com/mcp/email-editor/add-email-editor-html.md): MCP Tool: add-email-editor-html - [Add Email Icons](https://developers.klicktipp.com/mcp/email-editor/add-email-editor-icons.md): MCP Tool: add-email-editor-icons - [Add Email Image](https://developers.klicktipp.com/mcp/email-editor/add-email-editor-image-block.md): MCP Tool: add-email-editor-image-block - [Add Email List](https://developers.klicktipp.com/mcp/email-editor/add-email-editor-list.md): MCP Tool: add-email-editor-list - [Add Email Menu](https://developers.klicktipp.com/mcp/email-editor/add-email-editor-menu.md): MCP Tool: add-email-editor-menu - [Add Email Paragraph](https://developers.klicktipp.com/mcp/email-editor/add-email-editor-paragraph.md): MCP Tool: add-email-editor-paragraph - [Add Email Row](https://developers.klicktipp.com/mcp/email-editor/add-email-editor-row.md): MCP Tool: add-email-editor-row - [Add Email Social Links](https://developers.klicktipp.com/mcp/email-editor/add-email-editor-social-links.md): MCP Tool: add-email-editor-social-links - [Add Email Spacer](https://developers.klicktipp.com/mcp/email-editor/add-email-editor-spacer.md): MCP Tool: add-email-editor-spacer - [Add Email Table](https://developers.klicktipp.com/mcp/email-editor/add-email-editor-table.md): MCP Tool: add-email-editor-table - [Add Email Text](https://developers.klicktipp.com/mcp/email-editor/add-email-editor-text.md): MCP Tool: add-email-editor-text - [Add Email Video](https://developers.klicktipp.com/mcp/email-editor/add-email-editor-video.md): MCP Tool: add-email-editor-video - [Bind Row To Display Condition](https://developers.klicktipp.com/mcp/email-editor/configure-email-editor-row-display-condition.md): MCP Tool: configure-email-editor-row-display-condition - [Get Email](https://developers.klicktipp.com/mcp/email-editor/get-email-editor-content.md): MCP Tool: get-email-editor-content - [Read Display Condition Capabilities](https://developers.klicktipp.com/mcp/email-editor/get-email-editor-display-condition-capabilities.md): MCP Tool: get-email-editor-display-condition-capabilities - [Read Display Conditions](https://developers.klicktipp.com/mcp/email-editor/list-email-editor-display-conditions.md): MCP Tool: list-email-editor-display-conditions - [Search Email Social Icons](https://developers.klicktipp.com/mcp/email-editor/list-email-editor-social-icons.md): MCP Tool: list-email-editor-social-icons - [Move Email Block](https://developers.klicktipp.com/mcp/email-editor/move-email-editor-block.md): MCP Tool: move-email-editor-block - [Preview Email](https://developers.klicktipp.com/mcp/email-editor/preview-email-editor.md): MCP Tool: preview-email-editor - [Preview Email Template](https://developers.klicktipp.com/mcp/email-editor/preview-email-editor-template.md): MCP Tool: preview-email-editor-template - [Publish Email Content](https://developers.klicktipp.com/mcp/email-editor/publish-newsletter-email-content.md): MCP Tool: publish-newsletter-email-content - [Remove Email Block](https://developers.klicktipp.com/mcp/email-editor/remove-email-editor-block.md): MCP Tool: remove-email-editor-block - [Import Email Content From A Document](https://developers.klicktipp.com/mcp/email-editor/replace-email-editor-content-from-document.md): MCP Tool: replace-email-editor-content-from-document - [Copy Email Content](https://developers.klicktipp.com/mcp/email-editor/replace-email-editor-content-from-email.md): MCP Tool: replace-email-editor-content-from-email - [Import Email Content From HTML](https://developers.klicktipp.com/mcp/email-editor/replace-email-editor-content-from-html.md): MCP Tool: replace-email-editor-content-from-html - [Apply Design To Email](https://developers.klicktipp.com/mcp/email-editor/replace-email-editor-content-from-template.md): MCP Tool: replace-email-editor-content-from-template - [Search Email Templates](https://developers.klicktipp.com/mcp/email-editor/search-email-editor-templates.md): MCP Tool: search-email-editor-templates - [Write Email Block Style](https://developers.klicktipp.com/mcp/email-editor/update-email-editor-block-style.md): MCP Tool: update-email-editor-block-style - [Write Email Button](https://developers.klicktipp.com/mcp/email-editor/update-email-editor-button.md): MCP Tool: update-email-editor-button - [Write Email Button Look](https://developers.klicktipp.com/mcp/email-editor/update-email-editor-button-style.md): MCP Tool: update-email-editor-button-style - [Write Email Column Style](https://developers.klicktipp.com/mcp/email-editor/update-email-editor-column-style.md): MCP Tool: update-email-editor-column-style - [Write Display Condition](https://developers.klicktipp.com/mcp/email-editor/update-email-editor-display-condition.md): MCP Tool: update-email-editor-display-condition - [Write Email Divider Line](https://developers.klicktipp.com/mcp/email-editor/update-email-editor-divider-style.md): MCP Tool: update-email-editor-divider-style - [Write Email Icons](https://developers.klicktipp.com/mcp/email-editor/update-email-editor-icons.md): MCP Tool: update-email-editor-icons - [Write Email Image](https://developers.klicktipp.com/mcp/email-editor/update-email-editor-image-block.md): MCP Tool: update-email-editor-image-block - [Write Email Menu](https://developers.klicktipp.com/mcp/email-editor/update-email-editor-menu.md): MCP Tool: update-email-editor-menu - [Write Email Page Style](https://developers.klicktipp.com/mcp/email-editor/update-email-editor-page-style.md): MCP Tool: update-email-editor-page-style - [Write Email Row Style](https://developers.klicktipp.com/mcp/email-editor/update-email-editor-row-style.md): MCP Tool: update-email-editor-row-style - [Write Email Social Links](https://developers.klicktipp.com/mcp/email-editor/update-email-editor-social-links.md): MCP Tool: update-email-editor-social-links - [Write Email Spacer Height](https://developers.klicktipp.com/mcp/email-editor/update-email-editor-spacer-style.md): MCP Tool: update-email-editor-spacer-style - [Write Email Table](https://developers.klicktipp.com/mcp/email-editor/update-email-editor-table.md): MCP Tool: update-email-editor-table - [Write Email Text](https://developers.klicktipp.com/mcp/email-editor/update-email-editor-text.md): MCP Tool: update-email-editor-text - [Write Email Video](https://developers.klicktipp.com/mcp/email-editor/update-email-editor-video.md): MCP Tool: update-email-editor-video - [Check Email Content](https://developers.klicktipp.com/mcp/email-editor/validate-email-editor-content.md): MCP Tool: validate-email-editor-content ## Email Images - [Create Image Folder](https://developers.klicktipp.com/mcp/email-images/create-email-editor-image-folder.md): MCP Tool: create-email-editor-image-folder - [Remove Empty Image Folder](https://developers.klicktipp.com/mcp/email-images/delete-email-editor-image-folder.md): MCP Tool: delete-email-editor-image-folder - [List Image Folders](https://developers.klicktipp.com/mcp/email-images/list-email-editor-image-folders.md): MCP Tool: list-email-editor-image-folders - [Search Images](https://developers.klicktipp.com/mcp/email-images/list-email-editor-images.md): MCP Tool: list-email-editor-images - [Upload Image](https://developers.klicktipp.com/mcp/email-images/open-email-editor-image-upload.md): MCP Tool: open-email-editor-image-upload - [Preview Image](https://developers.klicktipp.com/mcp/email-images/preview-email-editor-image.md): MCP Tool: preview-email-editor-image - [Search Stock Images](https://developers.klicktipp.com/mcp/email-images/search-email-editor-stock-images.md): MCP Tool: search-email-editor-stock-images - [Store Picked Image File](https://developers.klicktipp.com/mcp/email-images/upload-email-editor-image-file.md): MCP Tool: upload-email-editor-image-file - [Add Image From URL](https://developers.klicktipp.com/mcp/email-images/upload-email-editor-image-from-url.md): MCP Tool: upload-email-editor-image-from-url ## Newsletter Splittest - [Add Split Test Variant](https://developers.klicktipp.com/mcp/newsletter-splittest/add-newsletter-split-test-variant.md): MCP Tool: add-newsletter-split-test-variant - [Configure Split Test](https://developers.klicktipp.com/mcp/newsletter-splittest/configure-newsletter-split-test.md): MCP Tool: configure-newsletter-split-test - [Read Split Test](https://developers.klicktipp.com/mcp/newsletter-splittest/get-newsletter-split-test.md): MCP Tool: get-newsletter-split-test - [Remove Split Test Variant](https://developers.klicktipp.com/mcp/newsletter-splittest/remove-newsletter-split-test-variant.md): MCP Tool: remove-newsletter-split-test-variant - [Write Split Test Variant](https://developers.klicktipp.com/mcp/newsletter-splittest/update-newsletter-split-test-variant.md): MCP Tool: update-newsletter-split-test-variant ## Newsletters - [Cancel A Newsletter Dispatch](https://developers.klicktipp.com/mcp/newsletters/cancel-newsletter-dispatch.md): MCP Tool: cancel-newsletter-dispatch - [Configure Newsletter Delivery](https://developers.klicktipp.com/mcp/newsletters/configure-newsletter-delivery.md): MCP Tool: configure-newsletter-delivery - [Create Newsletter Draft](https://developers.klicktipp.com/mcp/newsletters/create-newsletter-draft.md): MCP Tool: create-newsletter-draft - [Delete Newsletter Draft](https://developers.klicktipp.com/mcp/newsletters/delete-newsletter-draft.md): MCP Tool: delete-newsletter-draft - [Get Newsletter](https://developers.klicktipp.com/mcp/newsletters/get-newsletter.md): MCP Tool: get-newsletter - [Activate Newsletter](https://developers.klicktipp.com/mcp/newsletters/prepare-newsletter-dispatch.md): MCP Tool: prepare-newsletter-dispatch - [Search Newsletters](https://developers.klicktipp.com/mcp/newsletters/search-newsletters.md): MCP Tool: search-newsletters - [Send Newsletter Test](https://developers.klicktipp.com/mcp/newsletters/send-newsletter-test.md): MCP Tool: send-newsletter-test - [Update Newsletter Draft](https://developers.klicktipp.com/mcp/newsletters/update-newsletter-draft.md): MCP Tool: update-newsletter-draft ## Opt-In Processes - [Create Opt-In Process](https://developers.klicktipp.com/mcp/opt-in-processes/create-opt-in-process.md): MCP Tool: create-opt-in-process - [Delete Opt-In Process](https://developers.klicktipp.com/mcp/opt-in-processes/delete-opt-in-process.md): MCP Tool: delete-opt-in-process - [Get Opt-In Confirmation Email](https://developers.klicktipp.com/mcp/opt-in-processes/get-opt-in-confirmation-email.md): MCP Tool: get-opt-in-confirmation-email - [Get Opt-In Confirmation Email Content](https://developers.klicktipp.com/mcp/opt-in-processes/get-opt-in-confirmation-email-content.md): MCP Tool: get-opt-in-confirmation-email-content - [Get Opt-In Process](https://developers.klicktipp.com/mcp/opt-in-processes/get-opt-in-process.md): MCP Tool: get-opt-in-process - [Preview Opt-In Confirmation Email](https://developers.klicktipp.com/mcp/opt-in-processes/preview-opt-in-confirmation-email.md): MCP Tool: preview-opt-in-confirmation-email - [Search Opt-In Processes](https://developers.klicktipp.com/mcp/opt-in-processes/search-opt-in-processes.md): MCP Tool: search-opt-in-processes - [Send Opt-In Confirmation Email Test](https://developers.klicktipp.com/mcp/opt-in-processes/send-opt-in-confirmation-email-test.md): MCP Tool: send-opt-in-confirmation-email-test - [Update Opt-In Confirmation Email](https://developers.klicktipp.com/mcp/opt-in-processes/update-opt-in-confirmation-email.md): MCP Tool: update-opt-in-confirmation-email - [Update Opt-In Confirmation Email Content](https://developers.klicktipp.com/mcp/opt-in-processes/update-opt-in-confirmation-email-content.md): MCP Tool: update-opt-in-confirmation-email-content - [Update Opt-In Process](https://developers.klicktipp.com/mcp/opt-in-processes/update-opt-in-process.md): MCP Tool: update-opt-in-process ## Tags - [Create Manual Tag](https://developers.klicktipp.com/mcp/tags/create-manual-tag.md): MCP Tool: create-manual-tag - [Delete Manual Tag](https://developers.klicktipp.com/mcp/tags/delete-manual-tag.md): MCP Tool: delete-manual-tag - [Get Tag](https://developers.klicktipp.com/mcp/tags/get-tag.md): MCP Tool: get-tag - [Search Tags](https://developers.klicktipp.com/mcp/tags/search-tags.md): MCP Tool: search-tags - [Update Manual Tag](https://developers.klicktipp.com/mcp/tags/update-manual-tag.md): MCP Tool: update-manual-tag