Skip to main content
Glama
Sign In
Edinburgh Festivals MCP Server

Edinburgh Festivals MCP Server

by richarda23
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Hybrid

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.

Related MCP server: eventin-mcp-server

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.

Available Tools

3 tools
edinburgh_festival_eventsC

Searches this year's Edinburgh festival events. :param datetime_from: An optional ISO8601-like timestamp. e.g. '2025-08-12 00:00:00' :param datetime_to: An optional ISO8601-like timestamp. e.g. '2025-08-12 00:00:00' :param festival: possible values are fringe, demofringe, jazz, book, international, tattoo, art, hogmanay, science, imaginate, film, mela, storytelling. :param genre: The genre of the show. This will vary by festival type but may include comedy, theatre etc :param venue_name: The genre of the show. This will vary by festival type but may include comedy, theatre etc :param search_text: description of the show to search for. :param artist: Name of an artist or performer to search for. :param title: the title of the show to search for. :param year: The year of the festival. Defaults to "*", which means all years. :param datetime_from: The start date and time for the search range. :param number_of_results: The maximum number of results to retrieve, up to 100 at a time. :param page: The page number for pagination, starting from 0. :return:

Inputs: datetime_from, datetime_to, festival, genre, +7 more. Returns: result

edinburgh_festival_venue_routesC

Calculate route between venues

Inputs: origin (required), destination (required). Returns: object

edinburgh_festival_venuesC

Search Edinburgh festival venues

Inputs: festival, postcode, name, year, +2 more. Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Deploy Server
    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    TDQS

    B3/5.0

    Scored across 3 tools

    Disambiguation5/5

    The three tools have clearly distinct purposes: one searches for events, one searches for venues, and one calculates routes between venues. There is no overlap in functionality, making it easy for an agent to select the right tool for each task.

    Naming Consistency5/5

    All tool names follow a consistent snake_case pattern with the prefix 'edinburgh_festival_' followed by a descriptive noun phrase (events, venue_routes, venues). This uniformity makes the tool set predictable and easy to understand.

    Tool Count3/5

    With only three tools, the server feels somewhat thin for a festivals domain that might benefit from additional operations like booking tickets, getting event details, or managing schedules. However, the tools cover core search and navigation needs, keeping it borderline but functional.

    Completeness3/5

    The tools provide good search capabilities for events and venues, plus route calculation, but there are notable gaps. For example, there is no tool to retrieve detailed information about a specific event or venue, update data, or handle user interactions like favorites or reviews, which limits comprehensive festival management.

    Resources

    Related MCP Connectors

    Related MCP Servers