Things To Do API
Plain-language local event search for the San Francisco Bay Area, over REST and MCP
- Pricing
- Freemium
- Platforms
- API, Web
- Runs
- Remotely
- Version
- 0.1.0
- Listing updated
- 1 day ago
About Things To Do API
Things To Do API is a freemium MCP server for events and entertainment. It runs as a hosted remote server, so there is nothing to install locally.
Queries can carry time, place and audience in ordinary words, such as a weekend comedy night that suits quiet parents, or can be narrowed with date ranges, a city or neighborhood, a latitude/longitude radius and a category such as music, market, popup, supper_club or class. Results come back as JSON events with local and UTC times, venue details, a summary, tags, price, ticket links and a match score.
Coverage is currently the San Francisco Bay Area (San Francisco, Oakland, Berkeley, Alameda and nearby), with New York City and Los Angeles listed as next. A search for an uncovered city returns no events plus a message saying what is covered. Sources are read through the day and the search index refreshes every ten minutes.
The MCP endpoint embeds your API key in the URL, and the same key works for the REST API. Requests over a limit get a 429 with a Retry-After header.
Install
Run in a terminal
claude mcp add --transport http events https://api.thingstodoapi.com/mcpAdd to Settings → Connectors → Add custom connector
https://api.thingstodoapi.com/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"events": {
"url": "https://api.thingstodoapi.com/mcp"
}
}
}Add to .vscode/mcp.json
{
"servers": {
"events": {
"type": "http",
"url": "https://api.thingstodoapi.com/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"events": {
"serverUrl": "https://api.thingstodoapi.com/mcp"
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"events": {
"type": "http",
"url": "https://api.thingstodoapi.com/mcp"
}
}
}Tools this server provides (3)
Taken from the project documentation; the running server may differ.
- search_events
- Search local events with plain words or filters
- get_event
- Fetch a single event by id
- list_coverage
- List the places currently covered
What it does
- Plain-words search
- Time, place and who the outing is for can be written into one natural-language query.
- Structured filters
- Filter by date range, place, coordinates and radius, or one of ten event categories.
- Rich event objects
- Each event has venue, local and UTC times, price, tags, ticket links and a match score.
- Coverage check
- A list_coverage tool tells an assistant which areas are currently supported.
- REST and MCP
- The same data is available through a REST API with an OpenAPI spec or a remote MCP URL.
Good for
- Ask an assistant for things to do this weekend in Oakland
- Build an event feed into a local-guide app
- Find family-friendly or low-crowd outings by describing them
- Check ticket links and prices for pop-ups and markets
Pricing
Freemium
Free key with 1,000 calls a month; then $5 per 1,000 calls, with volume discounts
Prices change. Check thingstodoapi.com before you buy.
Things To Do API FAQ
What area does it cover?
The San Francisco Bay Area, including San Francisco, Oakland, Berkeley and Alameda. New York City and Los Angeles are next.
How do I add it to Claude Code?
Run claude mcp add --transport http thingstodo with the MCP URL that includes your key.
What are the usage limits?
Without a key you get 50 calls a day and 10 a minute. The free plan gives 1,000 calls a month at 60 a minute, and pay as you go allows 300 a minute.
How fresh are results?
Sources are read through the day and the search index updates every ten minutes.
Is Things To Do API free?
Things To Do API has a free plan, with paid plans for more usage or features.
How do I add Things To Do API to Claude Code?
Run this command in your terminal: claude mcp add --transport http events https://api.thingstodoapi.com/mcp
What are the best alternatives to Things To Do API?
The closest alternatives to Things To Do API are MaineMCP, Agent Bookability Index, Tap2Cal, Veseljko katalog usluga za proslave and 숏츠생성기 Free K-pop Shorts.
Alternatives to Things To Do API

MaineMCP
MCP serverSearch public Maine events, communities and startups, with links to the source listings
- 4 tools
- Remote
- Free
- Events and entertainment
Agent Bookability Index
MCP serverNYC-area event vendor prices, areas and booking options sourced from vendor sites
- 9 tools
- Remote
- Free
- Events and entertainment
Tap2Cal
MCP serverCreate shareable add-to-calendar links and read RSVPs from your AI assistant
Not checked yet- 9 tools
- Remote
- Free
- Productivity

Veseljko katalog usluga za proslave
MCP serverSearch Croatian wedding and party venues, bands, photographers and caterers
- 5 tools
- Remote
- Free
- Events and entertainment
숏츠생성기 Free K-pop Shorts
MCP serverFree finished K-pop shorts with title, description and thumbnail for YouTube Shorts
- 3 tools
- Remote
- Free
- Design and media
Public tour and ticket search for Gramado, Calafate, Bariloche, Ushuaia and Cartagena
- 3 tools
- Remote
- Free
- Maps and travel