# Gigora MCP — live concert data for AI agents

[Gigora](https://gigora.live) is a live-music discovery platform covering **44,000+ upcoming concerts worldwide** (Ticketmaster, Songkick and local Turkish ticket vendors, refreshed daily). This repository documents its hosted **Model Context Protocol (MCP) server** — to our knowledge the first MCP server for live-concert discovery.

- **Endpoint:** `https://gigora.live/api/mcp` (Streamable HTTP, stateless)
- **Auth:** none — no API key required
- **Full docs & examples:** https://gigora.live/developers

## Tools

| Tool | What it does |
| --- | --- |
| `search_concerts` | Search upcoming concerts by city, country, artist, genre and date range |
| `artist_tour_dates` | Upcoming tour dates for a specific artist |
| `concerts_in_city` | Concerts in a city over the next N days |
| `festival_lookup` | Find festivals by name or country |

Responses include a human-readable summary plus structured data: title, local start time, venue/city/country, headliner, indicative price range and ticket links.

## Connect

**claude.ai / Claude Desktop (custom connector):** add `https://gigora.live/api/mcp` as a remote MCP server.

**Claude Code:**
```bash
claude mcp add --transport http gigora https://gigora.live/api/mcp
```

**Any MCP client:** point a Streamable-HTTP transport at the endpoint above — `initialize`, `tools/list`, `tools/call` all work without a session.

**Standard config (JSON):**
```json
{
  "mcpServers": {
    "gigora": {
      "type": "streamable-http",
      "url": "https://gigora.live/api/mcp"
    }
  }
}
```

## Example prompts

- "Which festivals are on in Portugal this month?"
- "When is Interpol playing near Toulouse?"
- "Find rock concerts in Istanbul in the next two weeks."

## Public JSON endpoints (no MCP client needed)

- `GET https://gigora.live/api/ai/events?city=&country=&artist=&genre=&from=&to=&limit=`
- `GET https://gigora.live/api/ai/artist/<slug>`

Rate-limited, read-only, CORS-enabled for GET. See [gigora.live/developers](https://gigora.live/developers) for details.