@iterable/mcp 1.3.1 → 1.3.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1,13 +1,22 @@
1
1
  # Iterable MCP Server
2
2
 
3
- ![Iterable MCP Server Setup](images/iterable-mcp-setup.png)
3
+ [![npm version](https://img.shields.io/npm/v/@iterable/mcp.svg)](https://www.npmjs.com/package/@iterable/mcp)
4
4
 
5
+ ![Iterable MCP Server](images/iterable-mcp-server.png)
5
6
 
6
- With the new Iterable MCP server, you can now connect Iterable to your favorite AI tools like Cursor, Claude Desktop, Claude Code, Windsurf, Gemini CLI, and Antigravity!
7
+ Talk to your Iterable data using natural language. Ask questions or give instructions like *"How many campaigns did we send last week?"*, *"Show me my most recent templates"*, or *"Build me a beautiful email template that does the following..."* and get instant answers without writing code or navigating dashboards.
8
+
9
+ **Supported AI clients:**
10
+ - [Cursor](https://cursor.com/)
11
+ - [Claude Desktop](https://www.claude.com/download)
12
+ - [Claude Code](https://github.com/anthropics/claude-code)
13
+ - [Gemini CLI](https://github.com/google-gemini/gemini-cli)
14
+ - [Windsurf](https://windsurf.com/)
15
+ - [Antigravity by Google](https://antigravity.google/)
7
16
 
8
17
  ## What is MCP?
9
18
 
10
- MCP stands for Model Context Protocol. It's a new, open standard that lets AI tools (like Cursor or Claude Desktop) connect to external tools and APIs in a secure, structured way. MCP acts as a "bridge" between your AI app and platforms like Iterable, so you can ask questions or perform actions in plain English, and the AI translates those into safe API calls behind the scenes.
19
+ [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) is an open standard that lets AI assistants securely connect to external tools and APIs. This server acts as a bridge between your AI client and Iterable, translating natural language requests into safe API calls.
11
20
 
12
21
  ## Installation
13
22
 
@@ -19,6 +28,9 @@ MCP stands for Model Context Protocol. It's a new, open standard that lets AI to
19
28
  npx @iterable/mcp setup
20
29
  ```
21
30
 
31
+ ![Iterable MCP Server Setup](images/iterable-mcp-server-setup.gif)
32
+
33
+
22
34
  To always use the latest version (auto-update on each restart), add `--auto-update`:
23
35
 
24
36
  ```bash
@@ -1 +1 @@
1
- {"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../src/tools/templates.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAiBpD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAoH/D,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI,EAAE,CA4BlE"}
1
+ {"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../src/tools/templates.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAiBpD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AA4G/D,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI,EAAE,CA4BlE"}
@@ -14,7 +14,6 @@ const TEMPLATE_TYPES = [
14
14
  updateMethodName: "updateEmailTemplate",
15
15
  proofMethodName: "sendEmailTemplateProof",
16
16
  previewMethodName: "previewEmailTemplate",
17
- getParamsTransform: (params) => params.templateId, // Email uses just templateId
18
17
  },
19
18
  {
20
19
  type: "sms",
@@ -54,12 +53,7 @@ function createTemplateToolsForType(config, client) {
54
53
  name: `get_${config.type}_template`,
55
54
  description: `Get details for specific ${config.displayName} template by ID`,
56
55
  schema: GetTemplateParamsSchema,
57
- execute: (params) => {
58
- const methodParams = config.getParamsTransform
59
- ? config.getParamsTransform(params)
60
- : params;
61
- return client[config.getMethodName](methodParams);
62
- },
56
+ execute: (params) => client[config.getMethodName](params),
63
57
  }),
64
58
  createTool({
65
59
  name: `upsert_${config.type}_template`,
@@ -1 +1 @@
1
- {"version":3,"file":"templates.js","sourceRoot":"","sources":["../../src/tools/templates.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"templates.js","sourceRoot":"","sources":["../../src/tools/templates.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EACL,+BAA+B,EAC/B,iCAAiC,EACjC,uBAAuB,EACvB,wBAAwB,EACxB,2BAA2B,EAC3B,6BAA6B,EAC7B,+BAA+B,EAC/B,+BAA+B,EAC/B,8BAA8B,EAC9B,6BAA6B,EAC7B,+BAA+B,EAC/B,+BAA+B,EAC/B,8BAA8B,EAC9B,6BAA6B,GAC9B,MAAM,eAAe,CAAC;AAIvB,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAehD,MAAM,cAAc,GAAyB;IAC3C;QACE,IAAI,EAAE,OAAO;QACb,WAAW,EAAE,OAAO;QACpB,YAAY,EAAE,+BAA+B;QAC7C,YAAY,EAAE,+BAA+B;QAC7C,aAAa,EAAE,kBAAkB;QACjC,gBAAgB,EAAE,qBAAqB;QACvC,gBAAgB,EAAE,qBAAqB;QACvC,eAAe,EAAE,wBAAwB;QACzC,iBAAiB,EAAE,sBAAsB;KAC1C;IACD;QACE,IAAI,EAAE,KAAK;QACX,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,6BAA6B;QAC3C,YAAY,EAAE,6BAA6B;QAC3C,aAAa,EAAE,gBAAgB;QAC/B,gBAAgB,EAAE,mBAAmB;QACrC,gBAAgB,EAAE,mBAAmB;QACrC,eAAe,EAAE,sBAAsB;KACxC;IACD;QACE,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,mBAAmB;QAChC,YAAY,EAAE,8BAA8B;QAC5C,YAAY,EAAE,8BAA8B;QAC5C,aAAa,EAAE,iBAAiB;QAChC,gBAAgB,EAAE,oBAAoB;QACtC,gBAAgB,EAAE,oBAAoB;QACtC,eAAe,EAAE,uBAAuB;KACzC;IACD;QACE,IAAI,EAAE,OAAO;QACb,WAAW,EAAE,gBAAgB;QAC7B,YAAY,EAAE,+BAA+B;QAC7C,YAAY,EAAE,+BAA+B;QAC7C,aAAa,EAAE,kBAAkB;QACjC,gBAAgB,EAAE,qBAAqB;QACvC,gBAAgB,EAAE,qBAAqB;QACvC,eAAe,EAAE,wBAAwB;QACzC,iBAAiB,EAAE,sBAAsB;KAC1C;CACF,CAAC;AAEF,SAAS,0BAA0B,CACjC,MAA0B,EAC1B,MAAsB;IAEtB,MAAM,KAAK,GAAG;QACZ,UAAU,CAAC;YACT,IAAI,EAAE,OAAO,MAAM,CAAC,IAAI,WAAW;YACnC,WAAW,EAAE,4BAA4B,MAAM,CAAC,WAAW,iBAAiB;YAC5E,MAAM,EAAE,uBAAuB;YAC/B,OAAO,EAAE,CAAC,MAAM,EAAE,EAAE,CAAE,MAAc,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,MAAM,CAAC;SACnE,CAAC;QACF,UAAU,CAAC;YACT,IAAI,EAAE,UAAU,MAAM,CAAC,IAAI,WAAW;YACtC,WAAW,EAAE,oBAAoB,MAAM,CAAC,WAAW,qIAAqI;YACxL,MAAM,EAAE,MAAM,CAAC,YAAY;YAC3B,OAAO,EAAE,CAAC,MAAM,EAAE,EAAE,CAAE,MAAc,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC,MAAM,CAAC;SACtE,CAAC;QACF,UAAU,CAAC;YACT,IAAI,EAAE,UAAU,MAAM,CAAC,IAAI,WAAW;YACtC,WAAW,EAAE,mBAAmB,MAAM,CAAC,WAAW,yBAAyB;YAC3E,MAAM,EAAE,MAAM,CAAC,YAAY;YAC3B,OAAO,EAAE,CAAC,MAAM,EAAE,EAAE,CAAE,MAAc,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC,MAAM,CAAC;SACtE,CAAC;QACF,UAAU,CAAC;YACT,IAAI,EAAE,QAAQ,MAAM,CAAC,IAAI,iBAAiB;YAC1C,WAAW,EAAE,qBAAqB,MAAM,CAAC,WAAW,8BAA8B;YAClF,MAAM,EAAE,6BAA6B;YACrC,OAAO,EAAE,CAAC,MAAM,EAAE,EAAE,CAAE,MAAc,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,MAAM,CAAC;SACrE,CAAC;KACH,CAAC;IAEF,IAAI,MAAM,CAAC,iBAAiB,EAAE,CAAC;QAC7B,KAAK,CAAC,IAAI,CACR,UAAU,CAAC;YACT,IAAI,EAAE,WAAW,MAAM,CAAC,IAAI,WAAW;YACvC,WAAW,EAAE,WAAW,MAAM,CAAC,WAAW,8GAA8G;YACxJ,MAAM,EAAE,2BAA2B;YACnC,OAAO,EAAE,CAAC,MAAM,EAAE,EAAE,CAAE,MAAc,CAAC,MAAM,CAAC,iBAAkB,CAAC,CAAC,MAAM,CAAC;SACxE,CAAC,CACH,CAAC;IACJ,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,MAAsB;IACxD,OAAO;QACL,yBAAyB;QACzB,UAAU,CAAC;YACT,IAAI,EAAE,eAAe;YACrB,WAAW,EAAE,oBAAoB;YACjC,MAAM,EAAE,wBAAwB;YAChC,OAAO,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC;SACjD,CAAC;QACF,UAAU,CAAC;YACT,IAAI,EAAE,2BAA2B;YACjC,WAAW,EAAE,oCAAoC;YACjD,MAAM,EAAE,iCAAiC;YACzC,OAAO,EAAE,CAAC,MAAM,EAAE,EAAE,CAClB,MAAM,CAAC,qBAAqB,CAAC,MAAM,CAAC,gBAAgB,CAAC;SACxD,CAAC;QACF,UAAU,CAAC;YACT,IAAI,EAAE,kBAAkB;YACxB,WAAW,EAAE,oCAAoC;YACjD,MAAM,EAAE,+BAA+B;YACvC,OAAO,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,eAAe,CAAC,MAAM,CAAC,GAAG,CAAC;SACxD,CAAC;QAEF,4EAA4E;QAC5E,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE,CACnC,0BAA0B,CAAC,MAAM,EAAE,MAAM,CAAC,CAC3C;KACF,CAAC;AACJ,CAAC"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@iterable/mcp",
3
- "version": "1.3.1",
3
+ "version": "1.3.2",
4
4
  "description": "Model Context Protocol server for Iterable API",
5
5
  "keywords": [
6
6
  "mcp",