# Things To Do API

> Search local events in plain words: shows, pop-ups, markets, classes, with times, venues, prices.

- name: com.thingstodoapi/events
- version: 0.1.0
- connection class: R0 (autonomous)
- trust: 82/100 flags: no-repository
- quality: 73/100 (new)
- owner: not claimed
- descriptor: https://api.protogrid.dev/v1/servers/com.thingstodoapi%2Fevents
- tools: https://api.protogrid.dev/v1/servers/com.thingstodoapi%2Fevents/tools

**An agent can connect right now, no human step.** Remote endpoint, no authentication, reachable on the last probe.

## Connection (mcpServers)

```json
{
  "mcpServers": {
    "events": {
      "type": "http",
      "url": "https://api.thingstodoapi.com/mcp",
      "headers": {
        "Authorization": "Bearer ${EVENTS_TOKEN}"
      }
    }
  }
}
```

Placeholders to fill: `${EVENTS_TOKEN}`.

## Trust

- hygiene: 80
- liveness: 97
- freshness: 100
- provenance: 55
- drivers: +dns-namespace +website +reachable +uptime-93% +updated-4d-ago -no-repository
- Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed.

## Quality 73/100 (new)

### protocol: 75 (weight 25)

- warn `protocol.modern`: newest supported version is 2025-06-18; 2026-07-28 not supported, older versions are deprecated until 2027-07-28
- n/a `protocol.stateless`: only applies to 2026-07-28 servers
- pass `protocol.transport`: streamable HTTP
- n/a `protocol.list_ttl`: only applies to 2026-07-28 servers

### authorization: n/a (weight 15)

- n/a `auth.prm`, `auth.as_metadata`, `auth.cimd`: no remote uses OAuth
- n/a `auth.secret_in_url`: no templated URL

### tool hygiene: 71 (weight 30)

- pass `tools.descriptions`: every tool has a description
- pass `tools.description_length`: descriptions are concise
- pass `tools.schemas`: every tool has an object input schema
- fail `tools.annotations`: no tool declares readOnlyHint or destructiveHint, so clients cannot tell safe calls from risky ones
- fail `tools.directory_hints`: no tool declares all four of readOnlyHint, destructiveHint, idempotentHint and openWorldHint; missing: get_event (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); list_coverage (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); search_events (readOnlyHint, destructiveHint, idempotentHint, openWorldHint)
- pass `tools.token_cost`: about 596 tokens to load every tool
- pass `tools.api_dump`: tools are not a one-to-one API dump

### stability: n/a (weight 15)

- n/a `stability.changes`, `stability.rug_pull`: tool history recorded for 3 of the 7 days needed

### dependencies: n/a (weight 15)

- n/a `deps.known_vulns`, `deps.mcp_sdk_version`, `deps.resolvable`: no npm or PyPI package

- tools: 3, about 596 tokens to load them all
- tool set hash: 073501cf82ab9b3276907f2cd36a6ed3
- tools last changed: 2026-10-19T06:39:23.400Z
- badge: [![protogrid quality](https://protogrid.dev/badge/com.thingstodoapi/events.svg)](https://protogrid.dev/servers/com.thingstodoapi/events)
- Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed.

### Tool changes

- 2026-10-19 `list_coverage` changed (annotations)
- 2026-10-19 `get_event` changed (annotations)
- 2026-10-19 `search_events` changed (annotations)
- 2026-10-19 `list_coverage` changed (annotations)
- 2026-10-19 `get_event` changed (annotations)
- 2026-10-19 `search_events` changed (annotations)

Full history: https://api.protogrid.dev/v1/servers/com.thingstodoapi%2Fevents/changes

## Remotes

- https://api.thingstodoapi.com/mcp (streamable-http, auth none, reachable true, uptime30d 0.9285714)

## Packages

_none_

## Tools (3)

- `get_event`: Everything known about one event by its id (from search_events): all its tags, venue, links and times.
- `list_coverage`: The metros and cities covered, and the categories. Call it when unsure whether a city is covered.
- `search_events`: Find events happening in a city: concerts, DJ and club nights, comedy and theater, pop-ups and supper clubs, night markets and flea markets, festivals and street fairs, parties, classes, exhibitions. Pass what the user asked for in plain words as `query` ("techno this weekend in Oakland", "spooky things to do friday", "farmers market sunday morning"); time and place in the words are understood. Say who it is for in the same words ("comedy this weekend for my parents, they hate crowds", "things to do with my kids saturday"): what suits them comes first. Use `from`/`to`, `place` or `near` when you already know them exactly. Returns events with start times in the local timezone, the venue, a summary, tags, ticket and source links, and why each matched. Covers the San Francisco Bay Area today; a place outside it comes back as not covered, with no events. For more, call again with the `offset` a search returns as next_offset.