local-events-mcp
Click on "Deploy 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., "@local-events-mcp list events from the Hideout Theatre tomorrow"
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.
local-events-mcp
A small MCP server with semantic event tools:
list_sources()— show configured sources and whether each source-specific scraper is functionalscraper_is_valid(source)— health-check a source-specific scraper and return the extracted semantic payloadget_events_for_time_period(source, days, as_of=None)— return semantic events for a source over a time windowlist_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:
theatermusiccomedyfairsmisc
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.
modulepoints at the source-specific plugin modulethe module exposes
scraper_is_valid()andget_events_for_time_period()tools return semantic objects only: title, event type, description, date, location, event URL, price, and metadata
Related MCP server: Evento Public MCP Server
Run
python -m local_events_mcpOr use the installed console script:
local-events-mcpAvailable Tools
4 toolsget_events_for_time_periodC
Return semantic events for a source within the next N days.
Inputs: source (required), days, as_of. Returns: object
list_events_by_source_and_dateC
Return a source's events for one day, including the scraper status.
Inputs: source (required), date (required). Returns: object
list_sourcesB
List sources with functional status and scraper health.
Inputs: no named parameters. Returns: result
scraper_is_validC
Check whether a source-specific scraper is still returning semantic data.
Inputs: source (required). Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
Each tool has a clearly distinct purpose: get events for a time period, list events for a specific day with scraper info, list sources, and check scraper validity. No overlap in functionality.
Most tools use a consistent verb_noun pattern in snake_case (get_events, list_events, list_sources), but 'scraper_is_valid' deviates with an adjective instead of a verb, breaking the pattern slightly.
4 tools is well-scoped for a local events MCP server. Each tool serves a clear purpose without redundancy, and the count is appropriate for the domain.
The tool surface covers basic querying of events and source/scraper status but lacks CRUD operations for events and sources (e.g., add source, update event). Notable gaps exist for managing data.
Maintenance
Related MCP Connectors
MCP server for Riveter's enrichment, scraping, and monitoring API
Web scraping MCP server: any URL to Markdown or JSON, with JavaScript rendering and batch jobs.
One MCP server for all web data. Scrape, search, crawl, and AI research in one install.
One MCP server for 180+ live web-data APIs returning clean JSON from sites that block scrapers.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceA read-only MCP server that exposes iCalendar feeds as queryable tools for LLM agents, enabling calendar event retrieval and filtering.MIT
- AlicenseAqualityDmaintenanceMCP server to list and get events from Evento's public API using an API key.21ISC
- FlicenseAqualityDmaintenanceA simple MCP server for event scheduling and automation.12-
- MIT