Connect Your AI Assistant

Claude

1. Open Settings, then Connectors.
2. Choose Add custom connector.
3. Name it TimTim.Live and paste the address above.

Claude Code, in a terminal:

claude mcp add --transport http timtim-live https://api.timtim.live/v1/mcp

Cursor, VS Code and other MCP apps

Add it to the app's MCP settings file.

{
  "mcpServers": {
    "timtim-live": {
      "url": "https://api.timtim.live/v1/mcp"
    }
  }
}

{
  "servers": {
    "timtim-live": {
      "type": "http",
      "url": "https://api.timtim.live/v1/mcp"
    }
  }
}

An app that only runs local servers can reach it through a bridge such as mcp-remote: npx mcp-remote https://api.timtim.live/v1/mcp.

Show real events

Add your website key or test key to the end of the address. Ticket links then carry your partner credit, and calls count on your dashboard.

https://api.timtim.live/v1/mcp?key=tt_pk_live_YOUR_WEBSITE_KEY

A server key never goes in an address. If your app can send headers, send it as Authorization: Bearer … instead. Get a free test key →

What the assistant can do

• Find events

  find_events

  Find public live events from TimTim.Live using a city, country, category, dates or a performer's name. Upcoming events, soonest first.

• Find events near a place

  find_events_near_location

  Find public live events near a point on the map (latitude and longitude), within a radius in kilometres.

• Find events by type

  find_events_by_category

  Find public live events of one type (music, festival, nightlife, conference…), optionally in one city or country.

• Get one event

  get_event

  Get one event by its TimTim.Live id — including when it was cancelled, postponed or has ended, so you can say so.

• List event types

  list_categories

  Which event types have upcoming events, with how many each.

• List cities

  list_locations

  Which cities have upcoming events, with how many each.

It can only read. It cannot buy tickets, refund, change an event or touch an account — there is no tool for any of that. Every answer keeps the event's id, its status (cancelled, sold out…), its TimTim.Live page and its ticket link.

Try it without an assistant

curl -s https://api.timtim.live/v1/mcp -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"find_events","arguments":{"city":"Miami"}}}'

Prefer to run it yourself? The open-source @timtim-live/mcp package is a local version of the same tools — source on GitHub.