Connect RightMessage to AI Assistants via MCP

RightMessage's MCP (Model Context Protocol) server lets AI assistants like Claude, ChatGPT, and Cursor manage your personalization setup directly. Your AI can create campaigns, build flows, analyze performance, and export data — all through natural conversation.

You'll need an API token and a few minutes to configure your AI client.

Generate your API token

First, create a token that your AI assistant will use to access your RightMessage account.

1. Go to your Profile (click your avatar, then "Your Profile")

2. Switch to the API Tokens tab

3. Enter a name like "Claude Desktop" or "Cursor IDE"

4. Click Create

5. Copy the token immediately — you won't see it again

Configure your AI client

Each AI assistant stores its MCP configuration in a different location. Find your client below and follow the setup steps.

Claude Desktop

Claude Desktop reads its configuration from a JSON file on your computer.

1. Open Claude Desktop

2. Go to Settings → Developer → Edit Config (this opens the config file in your text editor)

3. Add RightMessage to the mcpServers section:

{
  "mcpServers": {
    "rightmessage": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://api.rightmessage.com/mcp/rightmessage",
        "--header",
        "Authorization: Bearer YOUR_API_TOKEN_HERE"
      ]
    }
  }
}

1. Replace YOUR_API_TOKEN_HERE with the token you copied earlier

2. Save the file

3. Fully quit and restart Claude (right-click the dock icon and select Quit)

You'll see a hammer 🔨 icon in the chat window when RightMessage tools are available. Try asking "Show me my RightMessage projects" to test the connection.

Cursor

Cursor has native support for HTTP-based MCP servers.

1. In Cursor, open Settings (Cmd+, on Mac, Ctrl+, on Windows)

2. Search for "MCP" in settings

3. Click Edit in settings.json

4. Add RightMessage to the mcpServers section:

{
  "mcpServers": {
    "rightmessage": {
      "url": "https://api.rightmessage.com/mcp/rightmessage",
      "headers": {
        "Authorization": "Bearer YOUR_API_TOKEN_HERE"
      }
    }
  }
}

1. Replace YOUR_API_TOKEN_HERE with your token

2. Save and restart Cursor

Toggle RightMessage tools on/off in the Cursor chat panel. Ask "What campaigns are running in my RightMessage account?" to verify.

VS Code with GitHub Copilot

GitHub Copilot supports MCP through VS Code's extension system.

1. Open VS Code

2. Press Cmd+Shift+P (Mac) or Ctrl+Shift+P (Windows/Linux)

3. Type "MCP: Add Server" and select it

4. Choose HTTP as the transport type

5. Enter the URL: https://api.rightmessage.com/mcp/rightmessage

6. Add the authorization header:

   • Header name: Authorization

   • Header value: Bearer YOUR_API_TOKEN_HERE

7. Save the configuration

Alternatively, create a .vscode/mcp.json file in your workspace:

{
  "mcpServers": {
    "rightmessage": {
      "url": "https://api.rightmessage.com/mcp/rightmessage",
      "headers": {
        "Authorization": "Bearer YOUR_API_TOKEN_HERE"
      }
    }
  }
}

Switch Copilot to Agent mode in the chat panel to access MCP tools.

ChatGPT Desktop

ChatGPT Desktop uses a similar configuration to Claude.

1. Locate your ChatGPT configuration file:

   • macOS: ~/Library/Application Support/ChatGPT/mcp_config.json

   • Windows: %APPDATA%\ChatGPT\mcp_config.json

   • Linux: ~/.config/ChatGPT/mcp_config.json

2. Create or edit the file with this configuration:

{
  "mcpServers": {
    "rightmessage": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://api.rightmessage.com/mcp/rightmessage",
        "--header",
        "Authorization: Bearer YOUR_API_TOKEN_HERE"
      ]
    }
  }
}

1. Replace YOUR_API_TOKEN_HERE with your token

2. Save and restart ChatGPT Desktop

Google Gemini (CLI)

Gemini's command-line tools support MCP server configuration.

1. Open your terminal

2. Run the Gemini MCP add command:

gemini mcp add --transport http --trust https://api.rightmessage.com/mcp/rightmessage

1. When prompted, add the authorization header:

   • Header: Authorization

   • Value: Bearer YOUR_API_TOKEN_HERE

Or manually edit ~/.gemini/settings.json (macOS/Linux) or %USERPROFILE%\.gemini\settings.json (Windows):

{
  "mcpServers": {
    "rightmessage": {
      "httpUrl": "https://api.rightmessage.com/mcp/rightmessage",
      "headers": {
        "Authorization": "Bearer YOUR_API_TOKEN_HERE"
      }
    }
  }
}

Verify with gemini /mcp in your terminal.

What your AI can do

Once connected, your AI assistant can manage nearly every aspect of your RightMessage account through 47 different tools:

Create and manage:

• Segment groups and segments

• Survey questions

• Campaigns (content personalization)

• Widgets (popups, slide-ins, bars)

• Flows (surveys and quizzes with branching logic)

• Offers (lead magnets, content upgrades)

• Forms (email capture)

Analyze performance:

• Overall account analytics

• Audience breakdown by segment

• Campaign, offer, and flow performance metrics

• Traffic analytics

Export and search data:

• Survey answers and responses

• Lead captures

• Visitor search and profiles

• Publish history

How to work with your AI

Start by asking your AI to show you what projects it can access:

"Show me my RightMessage projects and what's in each one."

Your AI will list your projects with counts of segments, questions, campaigns, and other resources. Tell it which project to work on:

"Set the active project to [your project name]."

Now you can ask it to make changes or analyze data:

• "Create a new segment group called 'Experience Level' with three segments: Beginner, Intermediate, and Advanced."

• "Show me which campaigns are performing best this month."

• "Build a flow that asks visitors about their biggest challenge, then shows them a relevant lead magnet."

• "Export all survey responses from the last 30 days."

When you're ready to make changes live, ask your AI to publish:

"Publish these changes to my live site."

Troubleshooting

AI can't see RightMessage tools

• Verify you fully restarted your AI client (not just closed the window)

• Check that your API token is correctly formatted in the config file

• Make sure there are no syntax errors in your JSON configuration

Permission denied or authentication errors

• Your API token may have been deleted or expired. Generate a new one from your Profile.

• Confirm you copied the entire token, including any trailing characters

Rate limit errors

• The MCP server allows 120 requests per minute. If you hit this limit, wait 60 seconds and try again.

Changes not appearing on your site

• Changes are saved as drafts by default. Ask your AI to run publish-config or manually publish from your RightMessage dashboard.