Skip to main content

Model Context Protocol Integration

EventPanel provides an MCP server that enables AI assistants like Cursor to automatically migrate events from your codebase and design documents into your EventPanel workspace, and add new events as you develop.

What is MCP?​

Model Context Protocol (MCP) is an open protocol that enables AI assistants to securely connect to external data sources and tools. The EventPanel MCP server empowers AI agents to:

  • Migrate events from code: Extract event definitions from your existing codebase (Swift, Kotlin, TypeScript, etc.) and import them into EventPanel
  • Migrate events from design docs: Parse product specifications, design documents, and requirements to create event definitions
  • Add new events: Let AI agents help you define and add new events to your workspace as you build features

Setup​

Step 1: Generate API Token​

  1. Log in to your EventPanel workspace
  2. Navigate to Settings → API Tokens
  3. Click Create New Token
  4. Fill in:
    • Name: e.g., "Cursor MCP Integration"
    • Permissions: Select Read & Write permission
  5. Click Create and copy the token immediately

Step 2: Configure Cursor​

  1. Open Cursor Settings (Cmd/Ctrl + ,) → Features → Model Context Protocol

  2. Add EventPanel MCP server configuration:

    {
      "mcpServers": {
        "eventpanel": {
          "url": "https://eventpanel.net/mcp",
          "headers": {
            "x-api-key": "YOUR_API_TOKEN_HERE"
          }
        }
      }
    }

  3. Replace YOUR_API_TOKEN_HERE with your token

  4. Restart Cursor

Example Prompts​

Migrate Events from Code​

Analyze this codebase and find all analytics tracking calls. 
Extract event names, properties, and types, then migrate them to EventPanel.
Search for all analytics.track(), logEvent(), and similar calls in this project. 
Create events in EventPanel for each one with their properties.

Migrate Events from Design Docs​

Read this design document and extract all event tracking requirements. 
Create events in EventPanel with descriptions, categories, and properties based on the requirements.
Parse this PRD and identify all events that should be tracked. 
Add them to EventPanel with appropriate categories and property definitions.

Add New Events​

I'm building a checkout flow. What events should I track? 
Create them in EventPanel with appropriate properties like amount, currency, and productIds.
Based on this feature code, suggest and add tracking events to EventPanel. 
Include all relevant properties with correct types.
I need to track user onboarding steps. Create events for each step 
(signup_started, signup_completed, onboarding_completed) and add them to EventPanel.

How It Works​

The AI assistant uses the import_event command automatically when you ask it to migrate or create events. Each event can include:

  • name (required): Event identifier
  • description: What the event tracks
  • categories: Grouping (e.g., "User", "E-COMMERCE")
  • properties: Event parameters with types (STRING, INTEGER, FLOAT, BOOLEAN, DATE, STRING_LIST, etc.) and required flags
  • sources: Platforms where used (iOS, Android, Web)

The AI analyzes your code/docs, structures the events appropriately, and imports them into your workspace.

Troubleshooting​

Connection issues: Verify your API token has Read & Write permissions and the URL is https://eventpanel.net/mcp

Authentication errors: Check that x-api-key header is set correctly in Cursor settings

Import errors: Ensure your token has Write permission and required fields are provided

Next Steps​