Convert MCP Server

What is MCP?

MCP (Model Context Protocol) is an emerging standard that allows AI models to interact with applications through a consistent interface. It acts as an abstraction layer, letting AI agents access your Convert data without needing to understand specific API protocols.

Quick Start

Prerequisites

Get your Convert API credentials:

1. Log into your Convert account
2. Go to Account Settings → API-Keys
   
   
3. Generate or copy your Application ID and Secret Key
   
   
   
4. Note your Account ID (found in account settings)
   

Consider starting with read-only access (TOOLS_FOR_CLIENT=reporting - see configuration below)

Installation & Setup

Option 1: NPX (Recommended)

# No installation needed - run directly

npx @convertcom/mcp-server

Option 2: Global Installation

# Install globally

npm install -g @convertcom/mcp-server


# Run the server

mcp-server-convert

Client Configuration

Claude Desktop

1. Download Claude Desktop from claude.ai
2. Add server configuration to your Claude Desktop config file:
   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "convert": {
      "command": "npx",
      "args": ["-y", "@convertcom/mcp-server"],
      "env": {
        "CONVERT_APPLICATION_ID": "your_convert_application_id",
        "CONVERT_SECRET_KEY": "your_convert_secret_key",
        "TOOLS_FOR_CLIENT": "reporting"
      }
    }
  }
}

Save the file and restart Claude Desktop. You should now see Convert tools available!

Cursor

1. Create a .cursor/mcp.json file in your project:

   mkdir -p .cursor && touch .cursor/mcp.json

2. Add the following configuration:

   {
     "mcpServers": {
       "convert": {
         "command": "npx",
         "args": ["-y", "@convertcom/mcp-server"],
         "env": {
           "CONVERT_APPLICATION_ID": "your_convert_application_id",
           "CONVERT_SECRET_KEY": "your_convert_secret_key",
           "TOOLS_FOR_CLIENT": "reporting"
         }
       }
     }
   }

3. Save the file and restart Cursor. Convert tools will now be available!

Example Usage

Once set up, try these example prompts with your AI assistant:

Get Insights from Your Convert 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"

Create and Manage Tests (Full Access Mode)

• "Create a new A/B test for the pricing page targeting returning visitors with a 70/30 traffic split"
• "Pause any experiences that have been running for more than 30 days with negative lift"
• "Update the traffic allocation for experiment ID 12345 to 50/50"

Configuration

Access Levels

Choose the appropriate access level based on your needs:

reporting (Default - Recommended)

Perfect for analytics and insights

• Account data and project information
• Real-time experiment tracking and performance reports
• Goals, audiences, and conversion analytics
• Live visitor data and traffic allocation

readOnly

All reporting tools plus detailed configuration access

• Everything in reporting mode
• Detailed project and experience configurations
• Historical data and change logs
• Advanced analytics and forecasting data

all (Use with caution)

Complete access including write operations

• Everything in readOnly mode
• Create, edit, and delete experiments
• Manage audiences, goals, and project settings
• Full account administration capabilities

Available Tools

The server provides 44 specialized tools covering the complete Convert REST API. Here's the complete breakdown:

Account Management (7 tools)

Project Management (4 tools)

Experience Management (7 tools)

Feature Management (3 tools)

Goal Management (3 tools)

Audience Management (3 tools)

Location Management (3 tools)

Knowledge Base Tools (6 tools)

Supporting Objects (8 tools)

Security & Authentication

API Security

• HMAC-SHA256 signing: Every request is cryptographically signed
• Automatic expiration: Requests expire after 60 seconds
• No credential exposure: API keys never leave your local environment
• Least privilege: Choose the minimum access level needed for your use case

Best Practices

• Start with reporting access level and escalate only when needed
• Regularly rotate your API credentials
• Monitor API usage in your Convert dashboard
• Keep your credentials secure and never share them

Troubleshooting

Common Issues

Getting Help

1. Check the logs: Development mode provides detailed error information
2. Verify credentials: Ensure your API key and secret are correct and have proper permissions
3. Test connectivity: Confirm you can reach Convert's API endpoints
4. Review permissions: Make sure your Convert account has access to the data you're requesting

Support Resources

• Documentation: Convert API Documentation
• Convert Support: Convert Help Center

What You Can Do

Real-time Analytics

• Monitor live experiment performance
• Track visitor behavior and conversions
• Analyze traffic allocation and statistical significance
• Get instant insights on goal performance

Experiment Management

• Create and configure A/B tests
• Set up multivariate experiments
• Manage audience targeting and segmentation
• Control traffic allocation and experiment lifecycle

Data-Driven Insights

• Historical performance analysis
• Conversion funnel optimization
• Audience behavior patterns
• ROI and revenue impact assessment

AI-Powered Optimization

• Let AI analyze your experiment data
• Get recommendations for test improvements
• Automate routine optimization tasks
• Generate insights from complex data patterns

Multi-Account Support

All tools support working with multiple Convert accounts through a single server instance:

Default Account

If CONVERT_DEFAULT_ACCOUNT_ID is not set, the server will:

• Automatically discover all accounts accessible to your API credentials
• Use the first available account as the default

Specifying an Account

To work with a specific account, include the account_id parameter with any tool:

Account Detection

The server automatically detects all accessible accounts on startup and logs them for reference.

Updates

The MCP server is automatically updated when you restart your AI assistant. For manual updates:

 # Update to latest version
npm update -g @convertcom/mcp-server