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

1. Create an Edinburgh Festival API account.

2. 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.

3. Install dependencies:

uv sync

4. 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.