local-events-mcp

A small MCP server with semantic event tools:

• list_sources() — show configured sources and whether each source-specific scraper is functional

• scraper_is_valid(source) — health-check a source-specific scraper and return the extracted semantic payload

• get_events_for_time_period(source, days, as_of=None) — return semantic events for a source over a time window

• list_events_by_source_and_date(source, date) — legacy compatibility wrapper for one source on one day

Source config

Edit sources/<source type>/<source>.json to add or update sources. Each source lives in its own file.

Current categories:

• theater

• music

• comedy

• fairs

• misc

The server also still understands the legacy sources.json file, but the categorized folder is the preferred layout.

Each source now points at a source-specific Python module under src/local_events_mcp/source_plugins/. The module path is stored in each source JSON and is loaded from disk, so slugs like the-hideout-theatre remain valid.

• module points at the source-specific plugin module

• the module exposes scraper_is_valid() and get_events_for_time_period()

• tools return semantic objects only: title, event type, description, date, location, event URL, price, and metadata

Related MCP server: eesti.ai events MCP server

Run

python -m local_events_mcp

Or use the installed console script:

local-events-mcp