# Things To Do API

> Things To Do API is a freemium MCP server for events and entertainment. Plain-language local event search for the San Francisco Bay Area, over REST and MCP. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API, Web
- **Website:** https://thingstodoapi.com/docs/
- **MCP Registry name:** com.thingstodoapi/events
- **Categories:** events and entertainment
- **Listing updated:** 2026-11-16

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http events https://api.thingstodoapi.com/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://api.thingstodoapi.com/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "events": {
      "url": "https://api.thingstodoapi.com/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "events": {
      "type": "http",
      "url": "https://api.thingstodoapi.com/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "events": {
      "serverUrl": "https://api.thingstodoapi.com/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "events": {
      "type": "http",
      "url": "https://api.thingstodoapi.com/mcp"
    }
  }
}
```

## Tools

- `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

## 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

- [MaineMCP](https://ai-powered.com/mcp/mainemcp): MaineMCP is a free MCP server for events and entertainment.
- [Agent Bookability Index](https://ai-powered.com/mcp/agent-bookability-index): Agent Bookability Index is a free MCP server for events and entertainment.
- [Tap2Cal](https://ai-powered.com/mcp/tap2cal): Tap2Cal is a free MCP server for productivity.
- [Veseljko katalog usluga za proslave](https://ai-powered.com/mcp/veseljko-katalog-usluga-za-proslave): Veseljko katalog usluga za proslave is a free MCP server for events and entertainment.
- [숏츠생성기 Free K-pop Shorts](https://ai-powered.com/mcp/free-k-pop-shorts): 숏츠생성기 Free K-pop Shorts is a free MCP server for design and media.
- [Tickets: tours and event tickets in South America](https://ai-powered.com/mcp/tickets-tours-and-event-tickets-in-south-america): Tickets: tours and event tickets in South America is a free MCP server for maps and travel.
- [DalVivo](https://ai-powered.com/mcp/dalvivo): DalVivo is a free MCP server for maps and travel.
- [Last.fm MCP](https://ai-powered.com/mcp/last-fm-mcp): Last.fm MCP is an open-source MCP server for events and entertainment.

---
Source: https://ai-powered.com/mcp/things-to-do-api
