EventHorizon

You are about to run an MCP server that lets EventHorizon Django handle events, registrations, and user data through a standardized, code-driven interface. This MCP server exposes a small set of tools you can call from any MCP client to list, create, update, and manage events and registrations, while handling authentication and API communication with EventHorizon.

How to use

Connect with your MCP client to perform common actions such as listing events, creating events, registering for events, and managing registrations. You will authenticate with a Knox token and point your client at your EventHorizon API URL. With the server running, use the client’s built-in MCP commands to perform tasks like listing events by filters, creating new events, registering attendees, and reviewing or updating registrations.

How to install

Prerequisites you need before installation: a system with Node.js 18 or newer.

Install by running the MCP server directly from the command line without cloning a repository:

npx github:NotoriousArnav/EventHorizon-MCP

Optionally, install from source to build locally. Run these commands in your shell:

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

Configuration

Set up your environment with the required credentials and endpoints. You must provide the EventHorizon API URL and a Knox authentication token. Optional logging and timeout settings can be adjusted to fit your deployment.

Environment variables to configure (shown values are examples):

EVENTHORIZON_BASE_URL=http://localhost:8000
EVENTHORIZON_API_TOKEN=your_knox_token_here
LOG_LEVEL=info
API_TIMEOUT=30000

Additional setup and runtime notes

Getting a Knox token: log into your EventHorizon Django instance and either create a Knox token in Django Admin > Knox Tokens > Add Token, or obtain a token via the API with a login request.

Testing without a client

If you want to verify the MCP server without a full client, you can use the MCP Inspector or send raw JSON-RPC requests to ensure the server responds as expected.

Security notes

Treat your Knox token like a password. Do not expose EVENTHORIZON_API_TOKEN in public logs or shared configurations. Restrict access to the host running the MCP server and rotate tokens as needed.

Development and maintenance notes

If you are developing from the source repository, you can run a development server with hot-reload during development and build for production when ready. Use the standard node/npm workflow to test changes locally.

Examples and troubleshooting

If you encounter connection issues, verify that EVENTHORIZON_BASE_URL points to your EventHorizon instance and that EVENTHORIZON_API_TOKEN is valid. Check that the host machine can reach the base URL on the configured port and that network ACLs or firewalls permit the traffic.

Tools overview

The server provides actions to manage events, registrations, and user profiles via MCP-enabled clients. Operational capabilities include listing, creating, updating, and deleting events, registering users for events, viewing and managing registrations, and fetching the current user’s profile and registrations.

Available tools

list_events

List events with optional filters such as search terms or location to help you quickly find relevant events.

get_event

Retrieve detailed information about a specific event by its ID.

create_event

Create a new event with required metadata such as title, date, location, and capacity.

update_event

Update details for an existing event, including time, location, or description.

delete_event

Remove an event (organizer only) when it is no longer needed.

register_for_event

Register a user for a specific event to secure a spot.

unregister_from_event

Cancel a previously placed registration for an event.

get_event_registrations

View all registrations for an event (organizer only).

manage_registration

Approve, waitlist, or cancel a registration.

get_my_profile

Fetch the current user’s profile information.

get_my_registrations

List the registrations for the current user.

get_my_hosted_events

List events that the current user organizes.

health_check

Perform a basic health check against the API and authentication.