{"article":{"id":42936800222612,"url":"https://iterable.zendesk.com/api/v2/help_center/en-us/articles/42936800222612.json","html_url":"https://support.iterable.com/hc/en-us/articles/42936800222612-Overview-of-Iterable-s-MCP-Server","author_id":1901239909927,"comments_disabled":true,"draft":false,"promoted":false,"position":0,"vote_sum":0,"vote_count":0,"upvote_count":0,"downvote_count":0,"section_id":42199521022228,"created_at":"2025-11-03T23:55:49Z","updated_at":"2026-11-18T20:17:38Z","name":"Overview of Iterable's MCP Server\n","title":"Overview of Iterable's MCP Server\n","source_locale":"en-us","locale":"en-us","outdated":false,"outdated_locales":[],"edited_at":"2026-11-18T20:17:38Z","user_segment_id":null,"permission_group_id":149406,"content_tag_ids":[],"label_names":[],"body":"<main class=\"page\"> <div class=\"theme-default-content content__default\"> <p>This article provides an overview of MCP servers and information that will help\nyou use Iterable's MCP Server. You can find additional details in\n<a href=\"https://support.iterable.com/hc/articles/42936790497812\">Setting up Iterable's MCP Server</a>.</p> <div class=\"custom-block tip\">\n<p class=\"custom-block-title\">BETA FEATURE</p> <p>Iterable's MCP Server is currently in beta. MCP functionality may change, be\nsuspended, or be discontinued at any time without notice. This software is\nprovided \"as is\" and is open source and ready for you to experiment with. For\nmore information, refer to <a href=\"https://iterable.com/legal/beta-terms/\" target=\"_blank\" rel=\"noopener noreferrer\">Iterable Beta Terms</a>.</p> <p>See the <a href=\"https://iterable.github.io/mcp-server\" target=\"_blank\" rel=\"noopener noreferrer\">MCP server documentation</a>\nfor all the details about this feature, including the latest requirements and updates.</p>\n</div> <h2 id=\"in-this-article\">\n<a href=\"#in-this-article\" class=\"header-anchor\">#</a> In this article</h2> \n<div class=\"table-of-contents\"><ul>\n\n<li><a href=\"#what-is-mcp\">What is MCP?</a></li>\n<li><a href=\"#what-s-special-about-iterable-s-mcp-server\">What's special about Iterable's MCP Server?</a></li>\n<li><a href=\"#things-you-should-consider\">Things you should consider</a></li>\n<li><a href=\"#best-practices\">Best practices</a></li>\n<li><a href=\"#what-s-supported\">What's supported</a></li>\n<li><a href=\"#example-uses-and-helpful-tips\">Example uses and helpful tips</a></li>\n</ul></div>\n <h2 id=\"what-is-mcp\">\n<a href=\"#what-is-mcp\" class=\"header-anchor\">#</a> What is MCP?</h2> <p>Model Context Protocol (MCP) is an open standard that helps AI assistants (like\nCursor or Claude Desktop) connect safely to external tools and their APIs. Think\nof MCP as a \"bridge\" that lets your AI app talk to platforms like Iterable.</p> <p>You control the data and actions that are available to the AI agent by configuring\nthe MCP server, and then the server enforces the rules that you set.</p> <p>While Iterable's MCP Server is intended for technical users who understand how to\nconfigure and test connectors safely, you don’t need to know how to code or use\nAPIs to use an MCP server. Once you've configured it, you can ask questions or\nperform actions in plain English, and the MCP server translates them for you\ninto safe API calls.</p> <h2 id=\"what-s-special-about-iterable-s-mcp-server\">\n<a href=\"#what-s-special-about-iterable-s-mcp-server\" class=\"header-anchor\">#</a> What's special about Iterable's MCP Server?</h2> <p>Iterable's MCP Server enables your AI assistant (LLM) to perform specific\nactions or queries directly in Iterable. The LLM can access nearly all of\nIterable's existing API endpoints, so whatever you can do with our API, you can\ndo by talking to your AI assistant, once Iterable's MCP Server is enabled.</p> <div class=\"custom-block tip\">\n<p class=\"custom-block-title\">TIP</p> <p>As with any LLM, results can vary depending on the quality of the LLM's\nunderstanding of the question and the context you provide, so if you don't get\nthe results you want the first time, try again with a different prompt.</p>\n</div> <h2 id=\"things-you-should-consider\">\n<a href=\"#things-you-should-consider\" class=\"header-anchor\">#</a> Things you should consider</h2> <p>Keep these things in mind when using Iterable's MCP Server.</p> <ul>\n<li><p>Make sure that you're using AI tools that are approved by your organization\nand that you're accessing Iterable data in a way that aligns with your\norganization's policies. It's up to you to monitor for risks that are\nassociated with the integrity and security of your Iterable environment.</p></li> <li><p>API endpoints called by Iterable's MCP Server use the same rate limits as all\nother API consumers. When using endpoints that are rate-limited either per\nproject or per organization, usage is aggregated with other API consumers.\nThis means that using your MCP server may compete for API resources. When API\nrequests exceed rate limits, the MCP server receives a 429 response\nand does not automatically retry.</p></li> <li><p>Project data related to the queries you make doesn't persist on Iterable's MCP\nServer; responses are available only for your current AI session.</p></li>\n</ul> <h2 id=\"best-practices\">\n<a href=\"#best-practices\" class=\"header-anchor\">#</a> Best practices</h2> <p>In addition to general best practices for using AI assistants, keep these\nin mind when using Iterable's MCP Server:</p> <ul>\n<li>\n<p>Iterable's MCP Server provides <strong>read capabilities</strong>, by default. You can\nselectively enable <strong>writes</strong> (create, update, and delete resources) and\n<strong>sends</strong> (send messages, trigger campaigns and journeys, schedule campaigns,\nand track events) by using the <code>--advanced</code> flag during setup. For more\ninformation, see the <a href=\"https://iterable.github.io/mcp-server\" target=\"_blank\" rel=\"noopener noreferrer\">MCP server documentation</a>\nand <a href=\"https://iterable.github.io/mcp-server/#/TOOLS\" target=\"_blank\" rel=\"noopener noreferrer\">list of available tools</a>.</p> <div class=\"custom-block warning\">\n<p class=\"custom-block-title\">IMPORTANT</p> <p>Enabling writes and sends allows the AI agent to take real actions that may be\ndifficult or impossible to reverse, including sending messages to real users\nand deleting data. If you do not have the technical knowledge to\nproperly review the agent's tool calls before they are executed, you should\navoid enabling these flags, especially in production environments. It is\nentirely your choice to accept this risk. If you enable these capabilities,\nit's your responsibility to carefully review each action before allowing the\nagent to proceed.</p> <p>Note that creating a blast campaign will schedule it for delivery, matching\nthe behavior of the underlying Iterable API — there is no way to create a\ndraft blast campaign. If you only need to draft content, you can do so with\nsends disabled by working with templates instead.</p>\n</div>\n</li> <li><p>Iterable strongly recommends that you test write and send capabilities in a sandbox\nenvironment before trying them in production. You can use per-key permission\nsettings to enable different permissions for different projects (for example,\nonly enable writes and sends for a sandbox project and keep them disabled in\nproduction).</p></li> <li><p>Always review the agent's tool calls before allowing them to proceed,\nespecially when writes or sends are enabled. The AI agent may decide to call\ntools that you did not explicitly request.</p></li> <li><p>Your API key permissions govern access. Use the least-privileged key you can.\nFor more information, refer to <a href=\"https://support.iterable.com/hc/articles/360043464871\">API Keys</a>.</p></li>\n</ul> <h2 id=\"what-s-supported\">\n<a href=\"#what-s-supported\" class=\"header-anchor\">#</a> What's supported</h2> <ul>\n<li><p>View <a href=\"https://iterable.github.io/mcp-server/#/TOOLS\" target=\"_blank\" rel=\"noopener noreferrer\">available MCP tools</a>.</p></li> <li><p>Experiment metrics are currently supported for email only, matching the\nunderlying Iterable API's capabilities.</p></li> <li><p>Tool behavior (along with supported permissions) mirrors the underlying\nIterable API.</p></li>\n</ul> <h2 id=\"example-uses-and-helpful-tips\">\n<a href=\"#example-uses-and-helpful-tips\" class=\"header-anchor\">#</a> Example uses and helpful tips</h2> <p>With Iterable's MCP Server, you can ask your AI assistant to look up a user,\nlist campaigns, create a template, or send email. It's up to the LLM to figure\nout which tools to use to address your question. For example, you might ask your\nAI assistant to:</p> <ul>\n<li>\"Summarize active campaigns right now.\"</li> <li>\"Show email performance (opens/clicks) for the last seven days.\"</li> <li>\"Show list memberships for <code>user@example.com</code>.\"</li> <li>\"Create a new campaign from template <em>template_id</em> and schedule it to send to\na sandbox tomorrow at 9:00 a.m.\"</li> <li>\"List product catalogs and show 10 items from <em>demo-catalog</em>.\"</li> <li>\"Enable debug logs and retrieve journeys filtered by state <code>Running</code>.\"</li>\n</ul> <p>General prompting best practices apply here, as they do with any AI assistant.</p>\n</div>   </main>","user_segment_ids":[]}}