TimTim.Live Developer Preview

Connect Your AI Assistant

Works now

Give your assistant one address. Then ask it things like “What music is on in Miami this weekend?”

The address is an MCP server: a plug that lets AI assistants ask TimTim.Live for events.

MCP server address

https://api.timtim.live/v1/mcp

No key needed to try it — you get sample events, and the assistant is told they are samples.

Claude

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

Claude Code, in a terminal:

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.

Cursor (.cursor/mcp.json)

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

VS Code (.vscode/mcp.json)

{
  "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.

Address with your key

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

Terminal

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.