Skip to main content
Glama
NotoriousArnav

EventHorizon MCP Server

EventHorizon MCP Server

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

Installation

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

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/NotoriousArnav/EventHorizon-MCP'

If you have feedback or need assistance with the MCP directory API, please join our Discord server