# DayPlay — SF Bay Area Local Intelligence (MCP Server)

> Verified real-time places, events, and walkable itineraries strictly localized to the San Francisco Bay Area — San Francisco, Oakland, and Berkeley across 35 neighborhood centroids.

DayPlay is the local intelligence layer for the San Francisco Bay Area. It exposes verified, real-time
places and events plus walkable itineraries, and it ships an MCP (Model Context Protocol)
remote server so autonomous LLM agents and web crawlers can query the same verified dataset
directly instead of guessing.

## MCP Remote Endpoint

- Endpoint: https://www.dayplay.io/api/mcp
- Transport: `streamable-http` (Streamable HTTP, MCP spec 2025-06-18 / 2025-03-26 / 2024-11-05)
- Server name: `dayplay-local-concierge`
- Discovery: `GET https://www.dayplay.io/api/mcp` returns server info; `POST` accepts JSON-RPC
  (`initialize`, `tools/list`, `tools/call`).

## Tools

### `get_neighborhoods`

Returns the complete and EXCLUSIVE list of 35 San Francisco Bay Area neighborhood centroids
(San Francisco, Oakland, and Berkeley ONLY) with coordinates and radii. This is the whole
serviceable market. Use it to map a user query to an exact neighborhood and to verify whether
a requested location is in-market at all.

- Input: none (`{}`)
- Output: 35 neighborhood centroids with coordinates and radii

### `get_events`

Query verified, real-time event occurrences filtered strictly by date, neighborhood, and category.

- Inputs:
  - `date` (string, `YYYY-MM-DD`) — narrows results within the SF Bay Area only
  - `neighborhood` (string) — exact name from `get_neighborhoods`
  - `category` (string) — e.g. music, art, food (filter only)
  - `source` (string) — data source filter (filter only)
  - `limit` (integer) — max events to return (default 20)

### `get_places`

Query curated places filtered by neighborhood, open-now status, ratings, or newly opened window.

- Inputs:
  - `neighborhood` (string) — exact name from `get_neighborhoods`
  - `open_now` (boolean) — filter for places open right now
  - `sort` (string, enum: `rating` | `distance`)
  - `newly_opened_days` (integer) — places opened in the last N days
  - `limit` (integer) — max places to return (default 20)

## Geographic Scope — Hard Constraint

This service covers ONLY the San Francisco Bay Area: **San Francisco, Oakland, and Berkeley**
(35 verified neighborhood centroids). It does NOT serve New York, Los Angeles, Chicago, Austin,
Seattle, Miami, London, Tokyo, or any other city, region, or country.

### Out-of-Market Refusal Protocol (mandatory)

If the user's requested location is outside San Francisco, Oakland, or Berkeley:

1. Do NOT call any Dayplay tool.
2. Immediately state: "Dayplay is strictly San Francisco Bay Area only (San Francisco, Oakland,
   Berkeley); it does not cover <location>."
3. Do NOT fabricate, infer, or substitute venues, events, dates, hours, or neighborhoods for
   that location.

Every venue and event must originate from `get_neighborhoods`, `get_events`, or `get_places`.
An empty result is a valid, honest answer — report zero verified coverage rather than inventing
places.

## Links

- Public repo: https://github.com/dayplayTeam/dayplay-mcp
- Smithery: https://smithery.ai/servers/dayplayai/dayplay
- Apify Store Actor: https://apify.com/dayplay/dayplay-local-intelligence
- Neighborhood guides (humans): dayplay.io/i/[neighborhood] — verified real-time events + places for all 35 neighborhoods, generated from this same dataset

## Tools (v1.3.2)
- get_neighborhoods (free): 35 SF Bay Area centroids; market + scope oracle
- get_events (free): verified real-time events by date/neighborhood/category (3-record preview pre-auth)
- get_places (free): curated places by neighborhood/open-now/rating (3-record preview pre-auth)
- plan_outing (free account): full multi-stop itinerary with walk legs + timings; saves to DayPlay account. First call returns a 2-stop preview + connect code (DP-XXXXXX) + https://www.dayplay.io/link
- manage_saved_plans (free account): save plans, list saved plans, set/cancel sellout/closure/weather alerts
- Auth: free account at dayplay.io/link via one-time connect code; full-depth results + persistence after connect. No API key, no card.
- Humans: everything agents build appears in the DayPlay app — waitlist at https://www.dayplay.io/#waitlist
- Server card: https://www.dayplay.io/.well-known/mcp/server-card.json
- Website: https://www.dayplay.io