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