Seatgeek MCP

🚀 seatgeek-mcp

The seatgeek-mcp is a comprehensive MCP server that exposes a registry of SeatGeek tools. It includes events, performers, venues, section info, and recommendations, all presented as a TypeScript library.

🚀 Quick Start

Prerequisites

• Node.js >= 18.0.0
• npm >= 8.0.0

Installation

npm install seatgeek-mcp

Usage

As a Standalone Server

# STDIO transport (default)
npm start

# HTTP streaming transport
MCP_HTTP=1 PORT=8080 npm start

✨ Features

• find_events: Search for events by performer, location, date, or venue. This tool is optimized for finding specific events based on user queries. If the query involves a performer, it first looks up the performer, then finds events for that performer. Otherwise, it searches events directly. Returns structured event data with venue information.
• find_event_recommendations: Get personalized event recommendations based on performers, events, or location. This tool first searches for performers and/or events based on the query, then uses the IDs to find similar events. Use location parameters for nearby events.
• find_performer_recommendations: Get personalized performer recommendations based on performers, events, or location. This tool first searches for performers and/or events based on the queries, then uses the IDs to find similar performers.
• retrieve_event_venue_information: Get detailed seating information including sections and rows for a specific event. This tool first searches for the event using the provided query, then retrieves detailed venue layout information.

📦 Installation

npm install seatgeek-mcp

💻 Usage Examples

Basic Usage

As a Standalone Server

# STDIO transport (default)
npm start

# HTTP streaming transport
MCP_HTTP=1 PORT=8080 npm start

Advanced Usage

Testing the Server

1. Using HTTP transport (easiest for testing):

MCP_HTTP=1 PORT=8080 npm start

2. Using curl to test tools (proper MCP protocol sequence):

The MCP protocol requires a specific sequence of requests with proper headers:

a. Initialize the connection (required first step):

curl -v -X POST http://localhost:8080 \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc": "2.0", "id": 1, "method": "initialize", "params": {"protocolVersion": "2024-06-11", "capabilities": {}, "clientInfo": {"name": "curl", "version": "1.0.0"}}}'

b. Extract the session ID from the response headers (look for mcp-session-id)

c. Use the session ID for subsequent requests:

# List available tools
curl -X POST http://localhost:8080 \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "Mcp-Session-Id: YOUR_SESSION_ID_HERE" \
  -d '{"jsonrpc": "2.0", "id": 1, "method": "tools/list", "params": {}}'

# Call a specific tool (example)
curl -X POST http://localhost:8080 \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "Mcp-Session-Id: YOUR_SESSION_ID_HERE" \
  -d '{"jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": {"name": "find_events", "arguments": {"q": "concert", "per_page": 5}}}'

For a complete working example, see:

• examples/curl-example.sh - Shell script demonstrating the full sequence of requests
• examples/node-example.js - Node.js script showing programmatic usage

3. Using the test scripts:

# Run the simple test server script
npm run test-server

# Run the comprehensive tool tests (requires server to be running separately)
npm run test-tools

📚 Documentation

Environment Variables

Setting up Environment Variables

To use this MCP server, you need to set up a .env file in the root directory with your SeatGeek API credentials:

1. Copy the .env.example file to .env:

cp .env.example .env

2. Edit the .env file and replace the placeholder values with your actual SeatGeek API credentials

You can obtain your SeatGeek API credentials by creating an account at SeatGeek Platform.

Using with Claude Desktop

Prerequisites

• Installed Claude Desktop
• Added claude_desktop_config.json under Settings -> Developer

Setup Instructions

• Add to mcpServers list:

"seatgeek-mcp": {
  "command": "node",
  "args": ["/path-to/seatgeek-mcp/dist/server.js"],
  "env": {
    "SEATGEEK_CLIENT_ID": "your-client-id"
  }
}

Using with OpenWebUI

You can use this MCP server with OpenWebUI through the mcpo (MCP Over HTTP) proxy, which automatically generates OpenAPI documentation from your MCP tool schemas.

Prerequisites

• Docker installed on your system (Optional if using uv)
• OpenWebUI installed and running

Setup Instructions

1. Start the mcpo proxy:

docker run -p 8000:8000 -v $(pwd):/workspace -w /workspace ghcr.io/open-webui/mcpo:main -- npm start

or

uvx mcpo --port 8000 -- npm start

2. Verify the proxy is running:

• Open your browser and navigate to http://localhost:8000/docs to see the automatically generated Swagger UI documentation
• You can also check the OpenAPI specification at http://localhost:8000/openapi.json

3. Connect to OpenWebUI:

• Open OpenWebUI
• Go to Settings > Tools & Integrations
• Add a new OpenAPI-compatible tool
• Use the URL: http://localhost:8000

Example Usage in OpenWebUI

Once connected, you can use these tools in OpenWebUI that will make requests such as:

• To search for performers: {"q": "washington nationals", "per_page": 5}
• To search for venues: {"city": "New York", "per_page": 5}

The mcpo proxy automatically handles the conversion between the OpenAPI REST interface and the MCP protocol, making your MCP tools accessible through standard REST endpoints that OpenWebUI can easily integrate with.

🔧 Technical Details

The server implements the Model Context Protocol (MCP) specification, so it can be used with any MCP-compatible client.

📄 Demo