edfringe-mcp
An MCP server to query the Edinburgh Festivals API for information about events and venues for all the Edinburgh festivals, inluding historical data.
Note that access to Fringe event data for 2025 is only supported on request. Running this MCP remotely would need approval by Edinburgh Fringe.
Tools
search_edinburgh_festivals
: Search for events based on location, genre, date, or text.search_edinburgh_festival_venues
: Search for venues based on festival type, postcode or other criteria.
Some prompts are also available to frame queries with correct context.
Example queries
what's on at the Gilded Balloon tonight? -> Which of these are comedy?
What disabled access is there at the Assembly rooms?
When did Gordon Brown last speak at the Book festival?
If you have a Google Maps key added, routing and navigation is supported too or, install a Google Maps MCP)
How long does it take to walk between the Gilded Balloon and the Pleasance?
Requirements
Python 3.12+
Setup
Clone or download this project.
Create a.env
file in the project root containing:api_secret=your_secret api_key=your_keyIf you have a Google Maps API key you can add
GOOGLE_MAPS_API_KEY=your API keyand that will enable timing and route calculations between venues.
Install dependencies:
uv syncAdd the following MCP configuration to your
mcp.json
config file in your LLM client app:"edinburghFestival": { "command": "uv", "args": [ "--directory", "/full/path/to/edfringe-mcp", "run", "main.py" ] }
Development
Running tests:
License
This project is licensed under the MIT License. See LICENSE for details.
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
An MCP server that provides tools for querying the Edinburgh Festivals API to retrieve information about events and venues across all Edinburgh festivals, including historical data.
Related MCP Servers
- AsecurityAlicenseAqualityThis server provides tools for AI assistants to interact with the Eventbrite API, allowing users to search for events, get event details, retrieve venue information, and list event categories.
- -securityFlicense-qualityA server that connects MCP clients (Claude, Cursor, Windsurf, etc.) to EventCatalog instances, allowing users to ask questions about their event-driven architecture and get insights about domains, services, and message schemas directly within their development tools.Last updated -916
- -securityFlicense-qualityAn MCP Server that enables interaction with Ticketmaster's Discovery API for accessing event, venue, and artist information through natural language commands.Last updated -
- -securityFlicense-qualityAn MCP Server that enables interaction with the Entertainment Express API, allowing access to entertainment content databases through natural language using the Multi-Agent Conversation Protocol.Last updated -