@gurulu/mcp-server

Model Context Protocol (MCP) server for Gurulu — Truth Layer for product analytics.

Lets AI agents (Cursor, Claude Code, Lovable, etc.) read and write your event registry safely.

Install

npm install -g @gurulu/mcp-server
# or run on demand:
npx @gurulu/mcp-server

Configure for Cursor

Add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "gurulu": {
      "command": "npx",
      "args": ["@gurulu/mcp-server"],
      "env": {
        "GURULU_API_KEY": "sk_xxxxxxxxxxxx",
        "GURULU_WORKSPACE_ID": "your-workspace-uuid"
      }
    }
  }
}

Configure for Claude Code

claude mcp add gurulu npx @gurulu/mcp-server \
  --env GURULU_API_KEY=sk_xxxxxxxxxxxx \
  --env GURULU_WORKSPACE_ID=your-workspace-uuid

Tools

| Tool | Purpose | |---|---| | list_events | List all registered events (status filter) | | get_event | Get full event definition (properties, producer rules) | | search_events | Search events by key or meaning | | list_recent_events | Recent event traffic (last 24h) | | get_workspace_health | Workspace health snapshot | | list_alarms | Active health alarms | | add_event | Propose a new event (queued for verification) | | add_property | Add property to existing event | | validate_event | Validate an event payload against registry |

Environment

| Variable | Required | Description | |---|---|---| | GURULU_API_KEY | yes | Workspace API key (sk_xxx) | | GURULU_WORKSPACE_ID | yes | Workspace UUID | | GURULU_ENDPOINT | no | Default: https://api.gurulu.io | | GURULU_MCP_MODE | no | stdio (default) or http | | GURULU_MCP_PORT | no | HTTP mode port (default 4040) |

Transport modes

• stdio (default): For agent IDEs (Cursor, Claude Code). One process per session.
• http: For remote workflows. Run as a service, multiple agents connect via HTTP+SSE.

Documentation

gurulu.io/docs/mcp

License

Business Source License 1.1 — see LICENSE.

The Licensed Work converts to the Apache License, Version 2.0 on 2030-05-21.

Copyright © 2026 MONAFY LTD (UK Company No. 17031485).