Edfest MCP

🚀 edfringe-mcp

An MCP server that queries the Edinburgh Festivals API to retrieve information about events and venues for all Edinburgh festivals, including historical data.

⚠️ Important Note

Access to Fringe event data for 2025 is not yet supported; this requires approval.

✨ Features

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

📦 Installation

Requirements

• Python 3.12+
• uv

Setup Steps

1. Create an Edinburgh Festival API account.
2. Clone or download this project. Then, create a .env file in the project root with the following content:

   api_secret=your_secret
   api_key=your_key
   

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"
       ]
   }
   

🔧 Technical Details

Development

To run tests, use the following commands:

uv sync --all-groups
uv run pytest

📄 License

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