Skip to content
MCP server

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/mcp

Add to Settings → Connectors → Add custom connector

https://api.thingstodoapi.com/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "events": {
      "url": "https://api.thingstodoapi.com/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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

  1. MaineMCP

    MCP server

    Search public Maine events, communities and startups, with links to the source listings

    • 4 tools
    • Remote
    • Free
    • Events and entertainment
  2. NYC-area event vendor prices, areas and booking options sourced from vendor sites

    • 9 tools
    • Remote
    • Free
    • Events and entertainment
  3. Tap2Cal

    MCP server

    Create shareable add-to-calendar links and read RSVPs from your AI assistant

    Not checked yet
    • 9 tools
    • Remote
    • Free
    • Productivity
  4. Search Croatian wedding and party venues, bands, photographers and caterers

    • 5 tools
    • Remote
    • Free
    • Events and entertainment
  5. Free finished K-pop shorts with title, description and thumbnail for YouTube Shorts

    • 3 tools
    • Remote
    • Free
    • Design and media