RudderStack MCP Server

The RudderStack MCP server provides a standardized interface that allows any compatible AI model or agent to access your RudderStack data. This centrally hosted and managed server follows the Model Context Protocol (MCP) specification, providing simple and secure access to RudderStack’s powerful data infrastructure.

What is MCP?

Model Context Protocol (MCP) is an open standard that enables AI assistants to securely connect to external data sources and tools. The RudderStack MCP server implements this protocol to give AI models direct access to your customer data pipelines, sources, destinations, and transformations.

Available Tools

The RudderStack MCP server provides tools for:

More functionality is being added regularly.

Setup Instructions

Claude (Team/Enterprise)

  1. Admin Setup: Visit claude.ai/settings/connectors, click Add Custom Connection, enter:
    • Integration name: RudderStack
    • Integration URL: https://mcp.rudderstack.com/mcp
  2. User: connect to RudderStack, and enable tools in chats

Claude (Individual Paid)

  1. Visit claude.ai/settings/connectors on web or navigate to Settings → Connections on desktop
  2. Click Add Custom Connection
  3. Enter the following:
    • Integration name: RudderStack
    • Integration URL: https://mcp.rudderstack.com/mcp
  4. Save and enable the connection

Claude (Free)

  1. Open your Claude Desktop configuration file:

    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    • Windows: %APPDATA%\Claude\claude_desktop_config.json

  2. Add the RudderStack MCP server to the configuration:

{
  "mcpServers": {
    "rudderstack": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.rudderstack.com/mcp"]
    }
  }
}
  1. Restart Claude Desktop for the changes to take effect

VS Code

For VS Code integration, add to your settings:

{
  "mcp.servers": {
    "rudderstack": {
      "command": "npx",
      "args": ["mcp-remote", "https://mcp.rudderstack.com/mcp"]
    }
  }
}

Cursor

Install in Cursor

Or manually add to your Cursor configuration:

{
  "rudderstack": {
    "command": "npx",
    "args": ["-y", "mcp-remote", "https://mcp.rudderstack.com/mcp"]
  }
}

Windsurf

In Windsurf, navigate to Settings → MCP Servers and add:

{
  "name": "rudderstack",
  "command": "npx",
  "args": ["mcp-remote", "https://mcp.rudderstack.com/mcp"]
}

Direct Connection

For testing or custom integrations:

npx mcp-remote "https://mcp.rudderstack.com/mcp"

OAuth Authentication Flow

When you first connect to the RudderStack MCP server through any of the above methods, you’ll go through a secure OAuth authentication process:

What Happens During Setup

  1. Initial Connection: When you first use any MCP tool to connect to https://mcp.rudderstack.com/mcp, the server detects you need authentication
  2. Browser Redirect: Your default browser will automatically open and redirect you to RudderStack’s login page
  3. RudderStack Login: Sign in with your existing RudderStack credentials (email and password)
  4. Authorization: Review and approve the MCP integration’s requested permissions to access your RudderStack data
  5. Automatic Return: Once authorized, you’re redirected back and the MCP connection is established
  6. Tool Integration: Your MCP client (Claude, VS Code, etc.) will now have access to RudderStack tools and data

Troubleshooting

Connection Issues

If you’re having trouble connecting:

  1. Verify the server is accessible at https://mcp.rudderstack.com
  2. Update to the latest version of npx and your MCP client
  3. Try clearing stored authentication and reconnecting

Authentication Errors

  1. Ensure you have an active RudderStack account
  2. Verify your account has the necessary permissions
  3. Clear browser cookies and try again
  4. Contact your RudderStack administrator if issues persist

Known Limitations

Learn More