RudderStack MCP

Overview

RudderStack MCP connects your AI assistant to your RudderStack workspace via the Model Context Protocol. Debug delivery errors, monitor pipelines, write and test transformations, review audit logs — all through natural language.

What you can do

This section lists the capabilities of RudderStack MCP.

Monitor and debug pipelines

• Investigate destination delivery errors and get root cause analysis
• Check warehouse upload status and table-level processing details
• Stream live events to verify data flow in real time
• Review audit logs to track workspace changes

Manage sources and destinations

• View all sources, destinations, and their connections
• Inspect source and destination configurations
• Analyze event metrics — volume, success/failure rates, latency
• Detect duplicate or similar event names across sources

Build and test transformations

• Write transformation code and test it against sample events before deploying
• Browse pre-built transformation templates
• Monitor transformation performance and latency
• Connect transformations to destinations

Enforce data governance

• Review Tracking Plans and their event schemas
• Check Tracking Plan validation metrics and violations
• Explore the Data Catalog events and properties across your workspace

Query documentation

• Ask questions about RudderStack features and get AI-generated answers with source citations

Access classes

The hosted server exposes three kinds of tools:

• Read tools inspect data without persisting a control-plane change.
• Sensitive execution tools execute code or submit temporary warehouse work without persisting control-plane configuration.
• Write tools persist session state or change control-plane configuration.

See the RudderStack MCP Tool Reference for each tool and the permissions it requires.

Example prompts

Here are a few prompts to get you started:

“Give me a health check of my data pipelines over the past week — show error rates, volume trends, and any issues.”

“My Facebook Conversions API destination has failing events. What’s causing the errors?”

“Find event names on my JavaScript source that look like duplicates or typos.”

“How do I set up a BigQuery destination with a service account key?”

Security and privacy

• Sensitive data protection: Tools that return event payloads, delivery errors, or violations redact or hash selected sensitive fields. Live events, schemas, profile artifacts, transformation code, audit data, and configuration can still contain sensitive information, so review tool output before sharing it
• Access control: The MCP server accesses only the workspaces and resources your RudderStack account has permission to access
• Review required for execution and writes: Review and confirm write and sensitive execution tools before running them. Don’t configure agents to auto-approve sensitive execution tools. For transformation tests, use sanitized sample events because transformation code can make outbound requests even when the tool doesn’t save control-plane configuration
• Limited write operations: Write tools can switch the active workspace, create or update transformations and audiences, and connect them to destinations. When audience activation is enabled, write tools can also create destination and Reverse ETL sync resources for activation, trigger sync runs, and update downstream audience membership. Write tools don’t delete sources or destinations
• OAuth authentication: The server uses OAuth 2.0 with PKCE and dynamic client registration. Compatible clients store and refresh credentials, so you don’t add credentials to the client configuration

Limitations

• Tool availability depends on your plan, enabled products, workspace permissions, and server configuration
• Documentation tools can occasionally return inaccurate AI-generated answers. Verify these answers against official RudderStack documentation

Related AI features

• RudderAI Agent: Use RudderStack’s managed assistant in Slack or the RudderStack dashboard for read-only workspace monitoring and debugging.
• RudderStack Agent Skills: Give your AI coding agent RudderStack workflows, including skills for setting up and using the MCP server.

Feedback

Contact RudderStack Support to provide feedback on RudderStack MCP and share your suggestions for improvement.