# Things To Do API

> Fast, accurate, localized events API for agentic applications. The knowledge base for all shows, pop-ups, markets and more: one plain-words query, over REST or MCP.

Supported regions: San Francisco Bay Area (live), New York City (soon), Los Angeles (soon).

## Use it

- [Docs](https://thingstodoapi.com/docs/): search parameters, the event object, MCP setup, keys and limits
- REST: GET https://api.thingstodoapi.com/v1/search?q=<plain words> (time and place in the words are understood: "jazz in Oakland this weekend")
- MCP: https://api.thingstodoapi.com/mcp, or https://api.thingstodoapi.com/mcp/<key> for clients that take only a URL (tools search_events, get_event, list_coverage). Claude Code: claude mcp add --transport http thingstodo https://api.thingstodoapi.com/mcp/<key>
- [OpenAPI](https://api.thingstodoapi.com/openapi.json)
- Pricing: Free $0 (1,000 queries a month, 60 a minute), Builder $49/month (50,000; 300 a minute), Growth $299/month (500,000; 1,200 a minute), Enterprise custom. Without a key, 50 a day and 10 a minute.
- Keys: make an account at https://thingstodoapi.com/signup/; usage, keys and plan at https://thingstodoapi.com/console/

## Things to do, now

Live lists, soonest first, each one API call:

- https://thingstodoapi.com/things-to-do/
- https://thingstodoapi.com/things-to-do/this-weekend/
- https://thingstodoapi.com/things-to-do/today/
- https://thingstodoapi.com/things-to-do/san-francisco/
- https://thingstodoapi.com/things-to-do/san-francisco/this-weekend/
- https://thingstodoapi.com/things-to-do/san-francisco/today/
- https://thingstodoapi.com/things-to-do/oakland/
- https://thingstodoapi.com/things-to-do/oakland/this-weekend/
- https://thingstodoapi.com/things-to-do/oakland/today/
- https://thingstodoapi.com/things-to-do/berkeley/
- https://thingstodoapi.com/things-to-do/berkeley/this-weekend/
- https://thingstodoapi.com/things-to-do/berkeley/today/
- https://thingstodoapi.com/things-to-do/alameda/
- https://thingstodoapi.com/things-to-do/alameda/this-weekend/
- https://thingstodoapi.com/things-to-do/alameda/today/