@convertcom/mcp-server 0.0.1-beta.10

package/.assets/logo-dark.svg

@@ -0,0 +1,20 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 153 33">
+    <g fill="#FFFFFF">
+        <path
+            d="M17.94 24.823h4.699c-.69 2.634-2.007 4.64-3.947 6.018C16.748 32.283 14.308 33 11.365 33c-3.57 0-6.355-1.157-8.36-3.475C1 27.27 0 24.04 0 19.837c0-4.009.968-7.142 2.912-9.397 2-2.319 4.79-3.482 8.36-3.482 3.76 0 6.668 1.13 8.736 3.385 1.127 1.38 1.94 2.978 2.444 4.794h-6.578c-.314-.624-.626-1.092-.936-1.409-.82-.878-1.976-1.317-3.476-1.317-1.382 0-2.508.44-3.383 1.317-1.127 1.254-1.691 3.327-1.691 6.21 0 2.88.564 4.915 1.69 6.107.81 1.002 2.03 1.503 3.664 1.503 1.065 0 1.968-.217 2.724-.657.188-.061.358-.173.514-.329.158-.16.329-.33.52-.517.122-.19.374-.438.748-.752.381-.31.942-.47 1.692-.47"></path>
+        <path fill-rule="evenodd" clip-rule="evenodd"
+            d="M24.314 25.72c.561 1.912 1.505 3.43 2.818 4.557 1.252 1.127 2.931 1.928 5.029 2.394 2.095.474 4.18.43 6.246-.138 2.314-.502 4.225-1.788 5.735-3.855.681-1.002 1.25-2.222 1.688-3.663.436-1.442.655-3.166.655-5.178 0-2.756-.535-5.165-1.6-7.236-1.124-2.316-2.876-3.95-5.255-4.888-2.066-.756-4.384-.955-6.953-.613-2.569.346-4.667 1.46-6.294 3.34-1.007 1.124-1.74 2.539-2.214 4.232a19.12 19.12 0 00-.7 5.078c0 2.06.28 4.056.845 5.97zm5.549-5.55c-.129-2.853.464-4.998 1.779-6.442.438-.436 1.13-.798 2.068-1.081a4.58 4.58 0 012.815.048c.942.316 1.775 1.033 2.491 2.164.724 1.127 1.081 2.82 1.081 5.078-.06 2.503-.467 4.321-1.22 5.449-.751 1.127-1.617 1.832-2.585 2.117a4.47 4.47 0 01-2.867-.097c-.935-.342-1.594-.763-1.968-1.267-.942-1.124-1.475-3.113-1.594-5.97z"></path>
+        <path
+            d="M69.311 32.534h-3.285c-.94 0-1.708-.3-2.302-.895-.597-.598-.89-1.362-.89-2.302V16.552c0-1.505-.458-2.604-1.366-3.295a4.928 4.928 0 00-3.054-1.034 4.73 4.73 0 00-3.004 1.034c-.878.69-1.317 1.79-1.317 3.295v15.982h-6.572V17.867c0-4.26 1.107-7.113 3.334-8.558 2.221-1.44 4.677-2.222 7.373-2.351 2.756 0 5.29.723 7.61 2.164 2.318 1.44 3.473 4.358 3.473 8.745v14.667z"></path>
+        <path fill-rule="evenodd" clip-rule="evenodd"
+            d="M118.667 24.823h-4.698c-.747 0-1.333.159-1.735.47-.408.314-.647.562-.704.752l-.148.147-.372.37a1.33 1.33 0 01-.517.33c-.751.44-1.659.656-2.722.656-1.629 0-2.855-.501-3.666-1.503-.877-.94-1.346-2.383-1.406-4.326h16.249c.064-.123.095-.341.095-.658v-1.034c0-4.134-.999-7.362-3.003-9.684-2.071-2.255-4.982-3.385-8.742-3.385-3.563 0-6.355 1.163-8.357 3.482-1.942 2.255-2.917 5.388-2.917 9.397 0 4.203 1.003 7.433 3.008 9.688 2.004 2.318 4.794 3.475 8.362 3.475 2.945 0 5.388-.718 7.331-2.16 1.936-1.378 3.254-3.384 3.942-6.017zm-6.389-7.335h-9.579c.06-1.628.529-2.88 1.407-3.76.878-.878 2.003-1.317 3.38-1.317 1.504 0 2.662.44 3.48 1.317.751.814 1.186 2.067 1.312 3.76z"></path>
+        <path
+            d="M120.077 32.533V20.402c0-2.442.362-4.494 1.08-6.157.721-1.66 1.705-2.991 2.96-3.992 1.19-.944 2.583-1.632 4.182-2.07a18.552 18.552 0 014.928-.66H134.168V14.2h-2.158c-1.818 0-3.168.44-4.04 1.311-.879.882-1.318 2.262-1.318 4.142v12.88h-6.575zM145.907 32.533c-2.062.121-4.304.093-6.713-.095-2.414-.188-3.614-1.723-3.614-4.606V.187h3.381c.81 0 1.533.317 2.158.943.627.627.941 1.38.941 2.258v4.229h3.846v1.317c0 .937-.31 1.706-.933 2.304a3.163 3.163 0 01-2.257.894h-.655v13.913c0 1.063.621 1.598 1.878 1.598h1.967v4.89h.001z"></path>
+        <path opacity=".5" d="M71.839 8.985l-1.47 3.61 3.073 6.95 3.341-8.689-4.944-1.871z"
+            fill="inherit"></path>
+        <path opacity=".75" d="M80.39 8.316l-5.478 14.438 3.073 7.085 7.617-19.517-5.211-2.006z"
+            fill="inherit"></path>
+        <path
+            d="M96.025 10.322L94.42 1.098l-7.35 5.614 2.005.802-9.754 25.266h5.612L94.02 9.52l2.005.802zM149.906 3.124c-1.492 0-2.7 1.226-2.7 2.715 0 1.5 1.208 2.714 2.7 2.714a2.715 2.715 0 000-5.43zm0 4.904a2.176 2.176 0 01-2.178-2.19c0-1.204.969-2.189 2.178-2.189a2.19 2.19 0 010 4.379zm1.198-.887c-.577-1.062-.544-1.007-.577-1.05.261-.154.425-.46.425-.81 0-.57-.327-.931-1.1-.931h-.861a.132.132 0 00-.13.131v2.715c0 .077.054.131.13.131h.425a.133.133 0 00.131-.131v-.909h.348l.512.975c.022.043.076.065.12.065h.457c.109 0 .164-.098.12-.186zm-1.198-1.478h-.359v-.7h.294c.348 0 .424.131.424.35 0 .23-.13.35-.359.35z"></path>
+    </g>
+</svg>

package/.assets/logo-light.svg

@@ -0,0 +1,20 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 153 33">
+    <g fill="#24292F">
+        <path
+            d="M17.94 24.823h4.699c-.69 2.634-2.007 4.64-3.947 6.018C16.748 32.283 14.308 33 11.365 33c-3.57 0-6.355-1.157-8.36-3.475C1 27.27 0 24.04 0 19.837c0-4.009.968-7.142 2.912-9.397 2-2.319 4.79-3.482 8.36-3.482 3.76 0 6.668 1.13 8.736 3.385 1.127 1.38 1.94 2.978 2.444 4.794h-6.578c-.314-.624-.626-1.092-.936-1.409-.82-.878-1.976-1.317-3.476-1.317-1.382 0-2.508.44-3.383 1.317-1.127 1.254-1.691 3.327-1.691 6.21 0 2.88.564 4.915 1.69 6.107.81 1.002 2.03 1.503 3.664 1.503 1.065 0 1.968-.217 2.724-.657.188-.061.358-.173.514-.329.158-.16.329-.33.52-.517.122-.19.374-.438.748-.752.381-.31.942-.47 1.692-.47"></path>
+        <path fill-rule="evenodd" clip-rule="evenodd"
+            d="M24.314 25.72c.561 1.912 1.505 3.43 2.818 4.557 1.252 1.127 2.931 1.928 5.029 2.394 2.095.474 4.18.43 6.246-.138 2.314-.502 4.225-1.788 5.735-3.855.681-1.002 1.25-2.222 1.688-3.663.436-1.442.655-3.166.655-5.178 0-2.756-.535-5.165-1.6-7.236-1.124-2.316-2.876-3.95-5.255-4.888-2.066-.756-4.384-.955-6.953-.613-2.569.346-4.667 1.46-6.294 3.34-1.007 1.124-1.74 2.539-2.214 4.232a19.12 19.12 0 00-.7 5.078c0 2.06.28 4.056.845 5.97zm5.549-5.55c-.129-2.853.464-4.998 1.779-6.442.438-.436 1.13-.798 2.068-1.081a4.58 4.58 0 012.815.048c.942.316 1.775 1.033 2.491 2.164.724 1.127 1.081 2.82 1.081 5.078-.06 2.503-.467 4.321-1.22 5.449-.751 1.127-1.617 1.832-2.585 2.117a4.47 4.47 0 01-2.867-.097c-.935-.342-1.594-.763-1.968-1.267-.942-1.124-1.475-3.113-1.594-5.97z"></path>
+        <path
+            d="M69.311 32.534h-3.285c-.94 0-1.708-.3-2.302-.895-.597-.598-.89-1.362-.89-2.302V16.552c0-1.505-.458-2.604-1.366-3.295a4.928 4.928 0 00-3.054-1.034 4.73 4.73 0 00-3.004 1.034c-.878.69-1.317 1.79-1.317 3.295v15.982h-6.572V17.867c0-4.26 1.107-7.113 3.334-8.558 2.221-1.44 4.677-2.222 7.373-2.351 2.756 0 5.29.723 7.61 2.164 2.318 1.44 3.473 4.358 3.473 8.745v14.667z"></path>
+        <path fill-rule="evenodd" clip-rule="evenodd"
+            d="M118.667 24.823h-4.698c-.747 0-1.333.159-1.735.47-.408.314-.647.562-.704.752l-.148.147-.372.37a1.33 1.33 0 01-.517.33c-.751.44-1.659.656-2.722.656-1.629 0-2.855-.501-3.666-1.503-.877-.94-1.346-2.383-1.406-4.326h16.249c.064-.123.095-.341.095-.658v-1.034c0-4.134-.999-7.362-3.003-9.684-2.071-2.255-4.982-3.385-8.742-3.385-3.563 0-6.355 1.163-8.357 3.482-1.942 2.255-2.917 5.388-2.917 9.397 0 4.203 1.003 7.433 3.008 9.688 2.004 2.318 4.794 3.475 8.362 3.475 2.945 0 5.388-.718 7.331-2.16 1.936-1.378 3.254-3.384 3.942-6.017zm-6.389-7.335h-9.579c.06-1.628.529-2.88 1.407-3.76.878-.878 2.003-1.317 3.38-1.317 1.504 0 2.662.44 3.48 1.317.751.814 1.186 2.067 1.312 3.76z"></path>
+        <path
+            d="M120.077 32.533V20.402c0-2.442.362-4.494 1.08-6.157.721-1.66 1.705-2.991 2.96-3.992 1.19-.944 2.583-1.632 4.182-2.07a18.552 18.552 0 014.928-.66H134.168V14.2h-2.158c-1.818 0-3.168.44-4.04 1.311-.879.882-1.318 2.262-1.318 4.142v12.88h-6.575zM145.907 32.533c-2.062.121-4.304.093-6.713-.095-2.414-.188-3.614-1.723-3.614-4.606V.187h3.381c.81 0 1.533.317 2.158.943.627.627.941 1.38.941 2.258v4.229h3.846v1.317c0 .937-.31 1.706-.933 2.304a3.163 3.163 0 01-2.257.894h-.655v13.913c0 1.063.621 1.598 1.878 1.598h1.967v4.89h.001z"></path>
+        <path opacity=".5" d="M71.839 8.985l-1.47 3.61 3.073 6.95 3.341-8.689-4.944-1.871z"
+            fill="inherit"></path>
+        <path opacity=".75" d="M80.39 8.316l-5.478 14.438 3.073 7.085 7.617-19.517-5.211-2.006z"
+            fill="inherit"></path>
+        <path
+            d="M96.025 10.322L94.42 1.098l-7.35 5.614 2.005.802-9.754 25.266h5.612L94.02 9.52l2.005.802zM149.906 3.124c-1.492 0-2.7 1.226-2.7 2.715 0 1.5 1.208 2.714 2.7 2.714a2.715 2.715 0 000-5.43zm0 4.904a2.176 2.176 0 01-2.178-2.19c0-1.204.969-2.189 2.178-2.189a2.19 2.19 0 010 4.379zm1.198-.887c-.577-1.062-.544-1.007-.577-1.05.261-.154.425-.46.425-.81 0-.57-.327-.931-1.1-.931h-.861a.132.132 0 00-.13.131v2.715c0 .077.054.131.13.131h.425a.133.133 0 00.131-.131v-.909h.348l.512.975c.022.043.076.065.12.065h.457c.109 0 .164-.098.12-.186zm-1.198-1.478h-.359v-.7h.294c.348 0 .424.131.424.35 0 .23-.13.35-.359.35z"></path>
+    </g>
+</svg>

package/README.md

@@ -0,0 +1,277 @@
+# Convert MCP Server
+
+[![npm](https://img.shields.io/npm/v/@convertcom/mcp-server.svg)](https://www.npmjs.com/package/@convertcom/mcp-server)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.0-blue.svg)](https://www.typescriptlang.org/)
+[![Node.js](https://img.shields.io/badge/Node.js-20%2B-green.svg)](https://nodejs.org/)
+[![MCP](https://img.shields.io/badge/MCP-Protocol-purple.svg)](https://modelcontextprotocol.io)
+
+**Connect Claude, Cursor, and other AI assistants to your Convert account**
+
+---
+
+## 🌟 Overview
+
+The Convert MCP server lets AI assistants explore your Convert account without custom integrations. Once connected, the assistant can answer questions, surface insights, and (if you permit) manage entities such as experiences, audiences, and goals.
+
+**What is MCP?**
+
+MCP (Model Context Protocol) is an open standard that allows AI models to interact with applications through a consistent interface. It acts as a bridge, letting AI assistants access your Convert data without needing to understand specific API protocols.
+
+**Key Benefits:**
+- 🔌 **Zero-config integration** – Works with Claude Desktop, Cursor, and any MCP-compatible client
+- 🔍 **Full API access** – Comprehensive coverage of Convert's [REST API v2](https://api.convert.com/doc/v2.0.0/)
+- 📚 **Built-in knowledge** – 5,776 indexed chunks across 500 Convert support article URLs
+- 🛡️ **Configurable permissions** – Three access levels from reporting-only to full read/write
+- 🧩 **Namespaced tools** – Clean interface with 13 generated API namespaces plus one computed `operator` namespace
+- 🧠 **MCP prompts** – 19 curated Convert experimentation prompts exposed through `prompts/list` and `prompts/get`
+
+---
+
+## 📚 Table of Contents
+
+- [🚀 Quick Start](#-quick-start)
+- [🔗 Client Integration](#-client-integration)
+- [🛠 What You Can Do](#-what-you-can-do)
+- [📊 Example Prompts](#-example-prompts)
+- [🔐 Security](#-security)
+- [❓ Troubleshooting](#-troubleshooting)
+
+---
+
+## 🚀 Quick Start
+
+### What you need
+
+1. **Convert API credentials** – In Convert, go to **Settings → Integrations → API** and copy your Application ID and Secret Key.
+2. **Node.js 20+** – Only required if you run the server from source.
+3. **Access level** – Set `TOOLS_FOR_CLIENT` to control what the assistant can do:
+   - `reporting` (default) – basic analytics and read-only summaries
+   - `readOnly` – detailed configuration data without modifying anything
+   - `all` – read/write access (only use when you explicitly want the assistant to make changes)
+
+---
+
+## 🔗 Client Integration
+
+The server implements the [Model Context Protocol](https://modelcontextprotocol.io) and works with Claude Desktop, Cursor, and any MCP-compatible client.
+
+### Recommended Models
+
+For the best experience, use models with strong agentic capabilities:
+- **Claude Sonnet 4.5** or newer
+- **GPT-5** or newer
+- Other frontier models with multi-step reasoning abilities
+
+**Enable extended thinking** – Extended thinking is a special reasoning mode that significantly improves MCP tool calling, multi-step workflows, and complex API interactions. Enable it in your client settings if available.
+
+### Configuration
+
+Add this configuration to your MCP settings file:
+
+```json
+{
+  "mcpServers": {
+    "convert": {
+      "command": "npx",
+      "args": ["-y", "@convertcom/mcp-server@latest"],
+      "env": {
+        "CONVERT_API_KEY": "your_application_id",
+        "CONVERT_API_SECRET": "your_secret_key",
+        "TOOLS_FOR_CLIENT": "reporting"
+      }
+    }
+  }
+}
+```
+
+**Configuration file locations:**
+- **Claude Desktop**: `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\Claude\claude_desktop_config.json` (Windows)
+- **Cursor**: `.cursor/mcp.json` in your project directory
+- **Other clients**: Refer to your client's documentation for MCP server configuration
+
+Save the file and restart your client to activate the Convert tools.
+
+### Environment Variables
+
+| Variable             | Required | Description                                     | Default     |
+| -------------------- | -------- | ----------------------------------------------- | ----------- |
+| `CONVERT_API_KEY`    | ✅       | Your Convert **Application ID**                 | -           |
+| `CONVERT_API_SECRET` | ✅       | Your Convert **Secret Key**                     | -           |
+| `TOOLS_FOR_CLIENT`   |          | Access level: `reporting`, `readOnly`, or `all` | `reporting` |
+| `CONVERT_ACCOUNT_ID` |          | Optional live-test target account               | -           |
+| `CONVERT_PROJECT_ID` |          | Optional live-test target project               | -           |
+| `CONVERT_HTTP_HEADER_*` |       | Optional extra API headers, e.g. `CONVERT_HTTP_HEADER_X_CONVERT_ENVIRONMENT=staging`; auth/signing headers cannot be overridden | - |
+| `CONVERT_API_MAX_RETRIES` |     | Max bounded retries for 429/503 idempotent requests | `2` |
+
+---
+
+## 🛠 What You Can Do
+
+Once connected, your AI assistant can:
+
+- 📊 **View experiment performance** – Get real-time stats on your A/B tests and experiences
+- 🎯 **Analyze goals and conversions** – See which goals are tracking and how they're performing
+- 👥 **Explore audience segments** – Understand your targeting rules and segmentation
+- 🔍 **Search Convert documentation** – The assistant has instant access to Convert's full support library, including OpenAI-compatible `search`/`fetch` docs tools
+- 🧠 **Use curated MCP prompts** – Portfolio summaries, project audits, QA checks, split URL setup, docs search, and experiment-builder workflows are available via MCP prompts
+- 🧭 **Run operator workflows** – The `operator` namespace performs audits, health checks, defaults inference, and safe verified creation/update flows without adding many tools
+- 📈 **Access account analytics** – Review live data, history, and visitor tracking
+- ⚙️ **Manage experiments** – Create, update, or pause experiences *(requires `TOOLS_FOR_CLIENT=all`)*
+
+The assistant doesn't need to know technical details—just ask questions in plain English.
+
+<details>
+<summary><b>14 Namespace Workflow Tools</b></summary>
+
+| Namespace | Reporting & readOnly actions | Extra actions in `all` |
+| --- | --- | --- |
+| `accounts` | list, get, get_billing_portal, get_live_data, get_history, list_users_accesses, list_api_keys, list_sdk_keys | create_sdk_key |
+| `projects` | list, get, get_live_data, get_history | create, update |
+| `domains` | list, get, get_by_url, check_code | create, update, delete |
+| `experiences` | list, get, get_by_key, get_live_data, get_history, aggregated_report, daily_report, daily_traffic_allocation, get_variation_screenshot, get_heatmap_background, get_heatmap_overlay, get_change | create, clone, update, update_variation, upload_variation_screenshot, convert_variation, update_change |
+| `sections` | list | create, update, update_experience_sections, add_version, update_version |
+| `goals` | list, get, get_by_key | create, update, delete, clone |
+| `tags` | list, get | create, update, delete |
+| `hypotheses` | list, get | create, update, update_status, convert, delete |
+| `knowledgebases` | list, get | create, update, delete |
+| `observations` | list, get | create, update, delete |
+| `locations` | list, get, presets | create, update, delete, clone |
+| `audiences` | list, get, presets | create, update, delete, clone |
+| `features` | list, get, get_by_key | create, update, delete |
+| `operator` | project_audit, experiment_portfolio, experiment_velocity, draft_qa, active_health, implementation_health, failed_test_analysis, hypothesis_quality_audit, audience_segment_comparison, cleanup_candidates, get_defaults | create_custom_code_ab_test, create_split_url_test, enable_split_url_regex, safe_update_variation_code |
+
+</details>
+
+**Access Control**: With `TOOLS_FOR_CLIENT=all`, additional write actions (create/update/delete) become available. Keep permissions as narrow as possible and escalate only when necessary.
+
+---
+
+## 🧪 Experience Authoring Notes
+
+For custom JavaScript or CSS in an A/B test, use `experiences.create` or `experiences.update_variation` with `changes[].type: "customCode"` and `data: { "js": "...", "css": "" }`. `defaultCode` is for Visual Editor payloads and requires Convert's generated fields.
+
+Split URL regex support is an experience-level setting. Use `experiences.update` without `variation_id`:
+
+```json
+{
+  "action": "update",
+  "path": { "account_id": 123, "project_id": 456, "experience_id": 789 },
+  "body": {
+    "settings": {
+      "split_url_settings": { "split_regex_support": true }
+    }
+  }
+}
+```
+
+If a client sends those settings to `experiences.update_variation`, the server returns a structured retry call instead of silently letting the wrong endpoint no-op.
+
+---
+
+## 📊 Example Prompts
+
+Once set up, try these prompts with your AI assistant:
+
+### Get Insights from Your Data
+
+```
+Show me the performance of all active experiments in my account
+```
+
+```
+How many experiences do I have running right now?
+```
+
+```
+Summarize all A/B tests with conversion rates above 5% from the last 30 days
+```
+
+### Analyze Experiment Performance
+
+```
+Get me the latest conversion data for my homepage experiment
+```
+
+```
+Compare the performance of mobile vs desktop experiments this month
+```
+
+```
+Show me which audience segments are performing best across all active tests
+```
+
+### Manage Tests *(Requires `TOOLS_FOR_CLIENT=all`)*
+
+```
+Create a new A/B test for the pricing page targeting returning visitors
+```
+
+```
+Update the traffic split on experience 789 to 50/50
+```
+
+```
+Pause any experiences that have been running for more than 30 days with negative lift
+```
+
+---
+
+## 🔎 Documentation Search Tools
+
+The server exposes two read-only documentation tools using OpenAI's MCP `search`/`fetch` connector format:
+
+| Tool | Best for |
+| ---- | -------- |
+| `search` | Finding Convert docs and returning `results[].id`, `title`, and canonical `url` values. |
+| `fetch` | Full-text retrieval for an ID returned by `search`. |
+
+Search is hybrid. Keyword search is always available; semantic vector search starts from the packaged vector store. At runtime the server opens a temporary copy of the committed index so installed packages are not mutated and docs search stays hybrid instead of falling back to keyword-only mode.
+
+---
+
+## 🔐 Security
+
+The server uses your Convert API credentials to authenticate requests. Your credentials are stored only in environment variables and never exposed in code.
+
+**Best practices:**
+- Start with `TOOLS_FOR_CLIENT=reporting` and escalate only when needed
+- Keep your API credentials secure and never commit them to version control
+
+---
+
+## ❓ Troubleshooting
+
+| Problem | How to fix |
+| ------- | ---------- |
+| Tools not visible after install | Restart the client and confirm the JSON config points to the correct command/env vars. |
+| `401 Unauthorized` | Re-check API key/secret and your account permissions. |
+| Requests blocked or failing | Use a smart model like Claude Sonnet 4.5, GPT-5, or newer with strong agentic capabilities. Enable extended thinking if available. The model needs to handle multi-step API workflows and parse response alerts. |
+| Documentation search feels off | Refine the query with specific terms (product codes, URLs, field names). The package includes the semantic vector index; if needed, restart the MCP client so the runtime copy is rebuilt from the packaged store. |
+
+Need more help? Visit the [Convert Help Center](https://support.convert.com/).
+
+---
+
+## 📦 API Coverage
+
+The server provides comprehensive coverage of Convert's [REST API v2](https://api.convert.com/doc/v2.0.0/):
+
+- **Account Operations**: User management, billing, and settings
+- **Project Management**: Configuration, domains, and collaborators
+- **Experience Control**: A/B tests, MVT, Split URL, and deployments
+- **Analytics & Reporting**: Real-time data, conversion tracking, and statistical analysis
+- **Goal Tracking**: Conversion goals, revenue tracking, and custom events
+- **Audience Management**: Segmentation rules and targeting
+- **Feature Flags**: Feature management and rollout control
+
+---
+
+<div align="center">
+
+**Made with ❤️ by the Convert Team**
+
+© 2026 Convert Insights, Inc. Built for the automation-minded optimizer.
+
+[Website](https://www.convert.com) • [Documentation](https://support.convert.com/) • [API Reference](https://api.convert.com/doc/)
+
+</div>

package/build/api-config.d.ts

@@ -0,0 +1,4 @@
+export declare const API_BASE_URL: string;
+export declare function convertHttpHeadersFromEnv(env?: NodeJS.ProcessEnv): Record<string, string>;
+export declare function shouldRetryApiRequest(method: string | undefined, status: number | undefined, retryUnsafeWrites?: boolean): boolean;
+export declare function signingBody(data: unknown): string;

package/build/api-config.js

@@ -0,0 +1,139 @@
+import axios from 'axios';
+import crypto from 'crypto';
+export const API_BASE_URL = process.env.API_BASE_URL || 'https://api.convert.com/api/v2';
+const CUSTOM_HEADER_PREFIX = 'CONVERT_HTTP_HEADER_';
+const DEFAULT_MAX_RETRIES = 2;
+const RETRYABLE_STATUSES = new Set([429, 503]);
+const BLOCKED_CUSTOM_HEADERS = new Set([
+    'authorization',
+    'convert-application-id',
+    'expires',
+    'content-type',
+]);
+axios.defaults.transformRequest = [
+    function (data) {
+        if (isPassThroughBody(data)) {
+            return data;
+        }
+        if (!data) {
+            data = {};
+        }
+        if (typeof data === 'string') {
+            return data;
+        }
+        return JSON.stringify(data);
+    },
+];
+export function convertHttpHeadersFromEnv(env = process.env) {
+    const headers = {};
+    for (const [key, value] of Object.entries(env)) {
+        if (!key.startsWith(CUSTOM_HEADER_PREFIX) || typeof value !== 'string' || value.length === 0) {
+            continue;
+        }
+        const headerName = headerNameFromEnvKey(key);
+        if (!headerName)
+            continue;
+        if (BLOCKED_CUSTOM_HEADERS.has(headerName.toLowerCase()))
+            continue;
+        headers[headerName] = value;
+    }
+    return headers;
+}
+export function shouldRetryApiRequest(method, status, retryUnsafeWrites = false) {
+    if (!status || !RETRYABLE_STATUSES.has(status))
+        return false;
+    const normalizedMethod = (method || 'get').toLowerCase();
+    if (['get', 'head', 'options'].includes(normalizedMethod))
+        return true;
+    return retryUnsafeWrites;
+}
+axios.interceptors.request.use((config) => {
+    const applicationID = process.env.CONVERT_API_KEY;
+    const applicationSecretKey = process.env.CONVERT_API_SECRET;
+    const expires = 60;
+    const requestURL = config.url;
+    const requestBody = signingBody(config.data);
+    const expiresTimestamp = Date.now() / 1000 + expires;
+    const signString = applicationID + '\n' + expiresTimestamp + '\n' + requestURL + '\n' + requestBody;
+    const hash = crypto.createHmac('sha256', applicationSecretKey).update(signString).digest('hex');
+    const authorization = 'Convert-HMAC-SHA256 Signature=' + hash;
+    for (const [header, value] of Object.entries(convertHttpHeadersFromEnv())) {
+        config.headers[header] = value;
+    }
+    config.headers['Convert-Application-ID'] = applicationID;
+    config.headers['Expires'] = expiresTimestamp;
+    config.headers['Authorization'] = authorization;
+    return config;
+}, (error) => {
+    return Promise.reject(error);
+});
+axios.interceptors.response.use((response) => response, async (error) => {
+    if (!axios.isAxiosError(error) || !error.config) {
+        return Promise.reject(error);
+    }
+    const config = error.config;
+    const retryUnsafeWrites = process.env.CONVERT_RETRY_UNSAFE_WRITES === '1'
+        || process.env.CONVERT_RETRY_UNSAFE_WRITES?.toLowerCase() === 'true';
+    if (!shouldRetryApiRequest(config.method, error.response?.status, retryUnsafeWrites)) {
+        return Promise.reject(error);
+    }
+    const retryCount = config.__convertRetryCount ?? 0;
+    const maxRetries = maxRetriesFromEnv();
+    if (retryCount >= maxRetries) {
+        return Promise.reject(error);
+    }
+    config.__convertRetryCount = retryCount + 1;
+    await sleep(retryDelayMs(retryCount, error.response?.headers?.['retry-after']));
+    return axios(config);
+});
+function headerNameFromEnvKey(key) {
+    const raw = key.slice(CUSTOM_HEADER_PREFIX.length).trim();
+    if (!raw)
+        return null;
+    return raw
+        .split('_')
+        .filter(Boolean)
+        .map((part) => part.charAt(0).toUpperCase() + part.slice(1).toLowerCase())
+        .join('-');
+}
+export function signingBody(data) {
+    if (typeof data === 'undefined' || data === null)
+        return '{}';
+    if (typeof data === 'string')
+        return data || '{}';
+    if (isPassThroughBody(data))
+        return '';
+    return JSON.stringify(data);
+}
+function isPassThroughBody(data) {
+    if (!data)
+        return false;
+    if (typeof FormData !== 'undefined' && data instanceof FormData)
+        return true;
+    if (typeof Blob !== 'undefined' && data instanceof Blob)
+        return true;
+    if (typeof URLSearchParams !== 'undefined' && data instanceof URLSearchParams)
+        return true;
+    if (typeof ArrayBuffer !== 'undefined' && data instanceof ArrayBuffer)
+        return true;
+    if (ArrayBuffer.isView(data))
+        return true;
+    return false;
+}
+function maxRetriesFromEnv() {
+    const parsed = Number(process.env.CONVERT_API_MAX_RETRIES);
+    if (!Number.isSafeInteger(parsed) || parsed < 0)
+        return DEFAULT_MAX_RETRIES;
+    return Math.min(parsed, 5);
+}
+function retryDelayMs(retryCount, retryAfter) {
+    const retryAfterSeconds = Array.isArray(retryAfter) ? Number(retryAfter[0]) : Number(retryAfter);
+    if (Number.isFinite(retryAfterSeconds) && retryAfterSeconds > 0) {
+        return Math.min(retryAfterSeconds * 1000, 10_000);
+    }
+    return Math.min(250 * 2 ** retryCount, 2_000);
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=api-config.js.map

package/build/api-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-config.js","sourceRoot":"","sources":["../src/api-config.ts"],"names":[],"mappings":"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"}

package/build/debug-log.d.ts

@@ -0,0 +1,6 @@
+export declare class DebugLogger {
+    private readonly filePath;
+    private readonly enabled;
+    constructor(enabled: boolean);
+    log(message: string, payload?: unknown): void;
+}

package/build/debug-log.js

@@ -0,0 +1,46 @@
+import { appendFileSync, mkdirSync, writeFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+export class DebugLogger {
+    filePath;
+    enabled;
+    constructor(enabled) {
+        this.enabled = enabled;
+        if (!enabled) {
+            this.filePath = null;
+            return;
+        }
+        try {
+            const baseDir = join(homedir(), '.convert');
+            mkdirSync(baseDir, { recursive: true });
+            this.filePath = join(baseDir, 'convert-mcp-debug.log');
+            writeFileSync(this.filePath, '', { encoding: 'utf8' });
+        }
+        catch (error) {
+            console.error('[DebugLogger] Failed to initialise debug log file:', error);
+            this.filePath = null;
+        }
+    }
+    log(message, payload) {
+        if (!this.enabled || !this.filePath) {
+            return;
+        }
+        try {
+            const time = new Date().toISOString();
+            const serialized = payload === undefined ? '' : `\n${safeSerialize(payload)}\n`;
+            appendFileSync(this.filePath, `[${time}] ${message}${serialized}\n`, { encoding: 'utf8' });
+        }
+        catch (error) {
+            console.error('[DebugLogger] Failed to write debug entry:', error);
+        }
+    }
+}
+function safeSerialize(value) {
+    try {
+        return JSON.stringify(value, null, 2);
+    }
+    catch (error) {
+        return `<<unserializable: ${String(error)}>>`;
+    }
+}
+//# sourceMappingURL=debug-log.js.map

package/build/debug-log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug-log.js","sourceRoot":"","sources":["../src/debug-log.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACnE,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,MAAM,OAAO,WAAW;IACL,QAAQ,CAAgB;IACxB,OAAO,CAAU;IAElC,YAAY,OAAgB;QAC1B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;YACrB,OAAO;QACT,CAAC;QACD,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,UAAU,CAAC,CAAC;YAC5C,SAAS,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACxC,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,OAAO,EAAE,uBAAuB,CAAC,CAAC;YACvD,aAAa,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;QACzD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,oDAAoD,EAAE,KAAK,CAAC,CAAC;YAC3E,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACvB,CAAC;IACH,CAAC;IAED,GAAG,CAAC,OAAe,EAAE,OAAiB;QACpC,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACpC,OAAO;QACT,CAAC;QACD,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;YACtC,MAAM,UAAU,GAAG,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,aAAa,CAAC,OAAO,CAAC,IAAI,CAAC;YAChF,cAAc,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,IAAI,KAAK,OAAO,GAAG,UAAU,IAAI,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;QAC7F,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,4CAA4C,EAAE,KAAK,CAAC,CAAC;QACrE,CAAC;IACH,CAAC;CACF;AAED,SAAS,aAAa,CAAC,KAAc;IACnC,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IACxC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,qBAAqB,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC;IAChD,CAAC;AACH,CAAC"}

package/build/executor.d.ts

@@ -0,0 +1,13 @@
+import { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+import { type AxiosError } from 'axios';
+import { type ErrorObject } from 'ajv/dist/2020.js';
+import { type JsonObject } from './shared.js';
+export declare function executeToolByName(toolName: string, toolArgs: JsonObject): Promise<CallToolResult>;
+export declare function recoverUploadedScreenshot(toolName: string, error: AxiosError, readbackUrl: string | null): Promise<CallToolResult | null>;
+export declare function validateToolArgs(toolName: string, rawSchema: unknown, args: JsonObject): {
+    ok: true;
+} | {
+    ok: false;
+    message: string;
+    errors: ErrorObject[];
+};