Eventfinda

Eventfinda MCP

javascript

0

GitHub Stars

javascript

Language

7 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "flying3615-eventfinda-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@gabriel3615/eventfinda-mcp"
      ],
      "env": {
        "EVENTFINDA_PASSWORD": "YOUR_API_PASSWORD",
        "EVENTFINDA_USERNAME": "YOUR_API_USERNAME"
      }
    }
  }
}

This MCP server lets you query Eventfinda for events by location and retrieve rich details such as titles, descriptions, dates, venues, and ticket information. It’s useful for AI agents to discover events and present users with up-to-date options that match their location and interests.

How to use

You will run this MCP server locally and connect your MCP-capable client to it. Once running, you can ask your agent to search for events by location (for example, by city) and filter results by date, price, or free events. The agent will return event details including title, description, URL, start and end times, address, and ticket information when available.

How to install

Prerequisites include Node.js (v14 or higher) and Eventfinda API credentials. You will also need access to a terminal or shell to install dependencies and start the MCP server.

npm install

Additional configuration and notes

Configuration uses an MCP JSON snippet to define how to run the server. The following example runs the Eventfinda MCP using npx and wires in your Eventfinda API credentials.

{
  "mcpServers": {
    "eventfinda": {
      "command": "npx",
      "args": ["-y", "@gabriel3615/eventfinda-mcp"],
      "env": {
        "EVENTFINDA_USERNAME": "YOUR_API_USERNAME",
        "EVENTFINDA_PASSWORD": "YOUR_API_PASSWORD"
      }
    }
  }
}

Starting the MCP server

After dependencies are installed and credentials are configured, start the MCP server to make it available to your MCP client.

npm start

Available tools

list_events

Lists events within the next week for a specified location, returning details such as id, title, description, url, datetime_start, datetime_end, address, is_free, and ticket_info.