EventHorizon MCP Server

A Model Context Protocol (MCP) server for integrating with the EventHorizon Django event management platform.

Installation

From GitHub (Recommended)

Run directly using npx without cloning:

npx github:NotoriousArnav/EventHorizon-MCP

From Source

git clone https://github.com/NotoriousArnav/EventHorizon-MCP.git
cd EventHorizon-MCP
npm install
npm run build

Configuration

Environment Variables

Variable	Required	Default	Description
EVENTHORIZON_BASE_URL	Yes	http://localhost:8000	EventHorizon API URL
EVENTHORIZON_API_TOKEN	Yes	-	Knox authentication token
LOG_LEVEL	No	info	debug, info, warn, error
API_TIMEOUT	No	30000	Request timeout in ms

Getting a Knox Token

1. Log into your EventHorizon Django instance
2. Go to Django Admin > Knox Tokens > Add Token
3. Or use the API: POST /api/auth/login/ with credentials

MCP Client Setup

Claude Desktop

Add to ~/.config/claude/claude_desktop_config.json (Linux) or ~/Library/Application Support/Claude/claude_desktop_config.json (macOS):

{
  "mcpServers": {
    "eventhorizon": {
      "command": "npx",
      "args": ["-y", "github:NotoriousArnav/EventHorizon-MCP"],
      "env": {
        "EVENTHORIZON_BASE_URL": "http://localhost:8000",
        "EVENTHORIZON_API_TOKEN": "your_knox_token_here"
      }
    }
  }
}

OpenCode

Add to your OpenCode MCP config (~/.config/opencode/config.json):

{
  "mcp": {
    "servers": {
      "eventhorizon": {
        "type": "local",
        "command": ["npx", "-y", "github:NotoriousArnav/EventHorizon-MCP"],
        "env": {
          "EVENTHORIZON_BASE_URL": "http://localhost:8000",
          "EVENTHORIZON_API_TOKEN": "your_knox_token_here"
        }
      }
    }
  }
}

Cursor

Add to Cursor's MCP settings:

{
  "mcpServers": {
    "eventhorizon": {
      "command": "npx",
      "args": ["-y", "github:NotoriousArnav/EventHorizon-MCP"],
      "env": {
        "EVENTHORIZON_BASE_URL": "http://localhost:8000",
        "EVENTHORIZON_API_TOKEN": "your_knox_token_here"
      }
    }
  }
}

Local Development

If running from source:

{
  "mcpServers": {
    "eventhorizon": {
      "command": "node",
      "args": ["/absolute/path/to/EventHorizon-MCP/dist/index.js"],
      "env": {
        "EVENTHORIZON_BASE_URL": "http://localhost:8000",
        "EVENTHORIZON_API_TOKEN": "your_knox_token_here"
      }
    }
  }
}

Available Tools

Event Management

Tool	Description
list_events	List events with optional search/location filters
get_event	Get detailed event information by ID
create_event	Create a new event
update_event	Update an existing event
delete_event	Delete an event (organizer only)

Registration

Tool	Description
register_for_event	Register for an event
unregister_from_event	Cancel registration
get_event_registrations	View registrations (organizer only)
manage_registration	Approve/waitlist/cancel registration

User

Tool	Description
get_my_profile	Get current user profile
get_my_registrations	List your event registrations
get_my_hosted_events	List events you organize

Utility

Tool	Description
health_check	Test API connection and auth

Development

# Install dependencies
npm install

# Run in development mode (hot reload)
npm run dev

# Build for production
npm run build

# Run production build
npm start

# Run tests
npm test

Testing Without an MCP Client

Use the MCP Inspector:

npx @modelcontextprotocol/inspector node dist/index.js

Or send raw JSON-RPC:

echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"1.0"}}}' | node dist/index.js

Requirements

• Node.js 18+
• EventHorizon Django instance with Knox authentication enabled

License

MIT