What is Eventor API Client?
Eventor API Client is a Python client for integrating with the Eventor orienteering API. It provides access to events, entries, and results and includes an MCP (Model Context Protocol) server integration so AI assistants can query orienteering data.
How to use Eventor API Client?
Clone the repository, set up a virtual environment with uv, install dependencies from requirements.txt, and copy the example config file to eventor_config.py. Edit that file with your actual API key and personId. To test, run python -m eventor in debug mode, which produces a JSON file. For use with Claude, add an MCP server entry to claude_desktop_config.json pointing uv at the project directory and running mcp_server.py.
Key features of Eventor API Client
- Access event results, entries, and organization data
- Configurable caching reduces API calls
- Exposes three MCP tools for AI assistants
- Parses data into LLM-friendly format
- Debug mode generates standalone JSON output
- Uses configurable API key and personId for secure access
Use cases of Eventor API Client
- Have an LLM summarize weekly club results
- Fetch personal events for a given person over a specific period
- Retrieve detailed results for one event and person
- Integrate orienteering data into AI-driven reports or dashboards
评论