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+
uv

Setup

Create an Edinburgh Festival API account.
Clone or download this project.
Create a .env file in the project root containing:
```
api_secret=your_secret
api_key=your_key
```
If you have a Google Maps API key you can add
```
GOOGLE_MAPS_API_KEY=your API key
```
and that will enable timing and route calculations between venues.
Install dependencies:
```
uv sync
```

Add 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:

uv sync --all-groups
uv run pytest

License

This project is licensed under the MIT License. See LICENSE for details.

Edinburgh Festival API