Integrates with the EventHorizon Django event management platform, providing tools for managing events, registrations, and user profiles through Knox authentication.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@EventHorizon MCP Serverlist my upcoming hosted events"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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-MCPFrom Source
git clone https://github.com/NotoriousArnav/EventHorizon-MCP.git
cd EventHorizon-MCP
npm install
npm run buildConfiguration
Environment Variables
Variable | Required | Default | Description |
| Yes |
| EventHorizon API URL |
| Yes | - | Knox authentication token |
| No |
|
|
| No |
| Request timeout in ms |
Getting a Knox Token
Log into your EventHorizon Django instance
Go to Django Admin > Knox Tokens > Add Token
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 with optional search/location filters |
| Get detailed event information by ID |
| Create a new event |
| Update an existing event |
| Delete an event (organizer only) |
Registration
Tool | Description |
| Register for an event |
| Cancel registration |
| View registrations (organizer only) |
| Approve/waitlist/cancel registration |
User
Tool | Description |
| Get current user profile |
| List your event registrations |
| List events you organize |
Utility
Tool | Description |
| 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 testTesting Without an MCP Client
Use the MCP Inspector:
npx @modelcontextprotocol/inspector node dist/index.jsOr 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.jsRequirements
Node.js 18+
EventHorizon Django instance with Knox authentication enabled
License
MIT
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.