.codex-plugin/plugin.json

{
  "name": "rudderstack",
  "version": "0.43.0",
  "description": "Debug your event pipeline from your agent: errors, violations, failed loads. Official hosted MCP server for RudderStack.",
  "author": {
    "name": "RudderStack",
    "email": "mcp@rudderstack.com",
    "url": "https://www.rudderstack.com"
  },
  "homepage": "https://www.rudderstack.com/docs/ai-features/rudderstack-mcp/",
  "repository": "https://github.com/rudderlabs/rudderstack-mcp",
  "license": "MIT",
  "keywords": [
    "rudderstack",
    "customer-data-platform",
    "data-pipelines",
    "event-streaming",
    "data-observability",
    "tracking-plan",
    "reverse-etl",
    "warehouse"
  ],
  "mcpServers": "./.mcp.json",
  "interface": {
    "displayName": "RudderStack",
    "shortDescription": "Debug your data pipelines",
    "longDescription": "RudderStack MCP connects ChatGPT and Codex to your RudderStack workspace, so you can debug customer data pipelines by asking instead of clicking through dashboards.\n\nWhat you can do:\n- Debug delivery: destination errors with sample events and API responses, success and failure rates, latency, and a live tail of events.\n- Check warehouse and Reverse ETL syncs: upload history, failed loads, table-level detail and sync runs.\n- Enforce your tracking plan: violations per event, tracking plan versions, the Data Catalog, and duplicate or misspelled event names.\n- Build audiences: explore your data graph, preview an audience's size, create it, and sync it to an activation destination.\n- Investigate changes: audit logs, source and destination configuration, Profiles runs and RudderStack status incidents.\n- Ask the docs: answers from RudderStack documentation with citations.\n\nWho it's for: data engineers, analytics engineers and growth engineers who run event pipelines on RudderStack.\n\nHow it handles your data: you sign in with RudderStack OAuth, and every call runs with your RudderStack permissions in workspaces you can already access. Some tools redact or hash sensitive fields in event payloads before they reach the model.\n\nLimitations: most tools only read. A few write, to transformations, audiences and their destination connections, and each tool declares whether it reads or writes so ChatGPT can confirm before acting. Tools for features that aren't enabled in your workspace return empty results. You need a RudderStack account.",
    "developerName": "RudderStack",
    "category": "Developer Tools",
    "capabilities": [
      "Read",
      "Write"
    ],
    "websiteURL": "https://www.rudderstack.com/docs/ai-features/rudderstack-mcp/?utm_source=openai-plugins&utm_medium=listing&utm_campaign=mcp-listings",
    "supportURL": "https://www.rudderstack.com/docs/ai-features/rudderstack-mcp/connect/?utm_source=openai-plugins&utm_medium=listing&utm_campaign=mcp-listings",
    "privacyPolicyURL": "https://www.rudderstack.com/privacy-policy/",
    "termsOfServiceURL": "https://www.rudderstack.com/terms-of-service/",
    "defaultPrompt": [
      "Give me a health check of my RudderStack pipelines over the past week.",
      "Why is my Facebook Conversions API destination failing?",
      "Find duplicate or misspelled event names on my web source."
    ],
    "brandColor": "#2B8BFF",
    "logo": "./assets/logo.png",
    "composerIcon": "./assets/logo.png",
    "brandColorDark": "#A4CBFF"
  },
  "extensions": {
    "com.openai": {
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Workspace overview after connecting",
              "prompt": "Give me an overview of my RudderStack workspace.",
              "tools_triggered": "user_details, list_sources, list_destinations, list_connections",
              "expected_behavior": "Names the active workspace and summarizes its sources, destinations and how they connect. No write tools are called."
            },
            {
              "description": "Recent destination delivery errors",
              "prompt": "Have there been any delivery errors on my RudderStack destinations in the past week? Include the error messages.",
              "tools_triggered": "list_destinations, get_destinations_errors",
              "expected_behavior": "Lists each destination with failed deliveries in the past week, with the event names, counts, status code and the destination's error message, and suggests a likely cause. Says so plainly if there were none. Changes nothing."
            },
            {
              "description": "Duplicate or misspelled event names",
              "prompt": "Find event names on my RudderStack JavaScript source that look like duplicates or typos.",
              "tools_triggered": "list_sources, get_source_event_names_similarity",
              "expected_behavior": "Returns pairs of similar event names (for example Product Click and Product Clicked) with similarity scores and recommends which name to keep. Changes nothing."
            },
            {
              "description": "Event and property lookup",
              "prompt": "Check the event schemas on my RudderStack JavaScript source: does Order Completed exist, and what properties does it carry?",
              "tools_triggered": "list_sources, get_source_event_schemas, get_source_event_properties",
              "expected_behavior": "Confirms Order Completed is being received, with its count and last seen time, and lists its properties (such as order_id, revenue, total, currency and products) with their data types."
            },
            {
              "description": "Event volume by name",
              "prompt": "How many events has my RudderStack JavaScript source received today, by event name?",
              "tools_triggered": "list_sources, get_source_event_metrics",
              "expected_behavior": "Returns event counts for the source grouped by event type and name for today. Changes nothing."
            }
          ],
          "negative": [
            {
              "description": "Deleting a destination is not supported",
              "prompt": "Delete my RudderStack webhook destination."
            },
            {
              "description": "Revealing raw PII is not supported",
              "prompt": "Show me the real email addresses of the RudderStack users whose events failed yesterday."
            },
            {
              "description": "Unrelated request should not trigger the plugin",
              "prompt": "What's a good recipe for banana bread?"
            }
          ]
        },
        "demo_recording_url": "https://youtu.be/NPSGe3mtvH0"
      },
      "publication": {
        "release_notes": "First release: debug RudderStack pipelines, find delivery errors, check event names and properties, and review warehouse and Reverse ETL syncs from ChatGPT and Codex."
      }
    }
  },
  "apps": "./.app.json"
}