@dayplayai/mcp-server 1.2.0

package/.cursor/mcp.json

@@ -0,0 +1,7 @@
+{
+  "mcpServers": {
+    "dayplay": {
+      "url": "https://www.dayplay.io/api/mcp"
+    }
+  }
+}

package/.cursor-plugin/plugin.json

@@ -0,0 +1,26 @@
+{
+  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
+  "name": "dayplay-local-concierge",
+  "description": "San Francisco Bay Area only (San Francisco, Oakland, Berkeley across 35 neighborhood centroids): verified events tonight, places open now, and walkable itineraries by neighborhood. Out-of-market locations are not served - not available outside the San Francisco Bay Area.",
+  "version": "1.0.0",
+  "author": {
+    "name": "Dayplay Team",
+    "email": "hello@dayplay.io"
+  },
+  "homepage": "https://www.dayplay.io",
+  "repository": "https://github.com/dayplayTeam/dayplay-mcp",
+  "license": "MIT",
+  "keywords": [
+    "san-francisco",
+    "bay-area",
+    "events",
+    "things-to-do",
+    "restaurants",
+    "nightlife",
+    "itinerary",
+    "local-guide",
+    "mcp",
+    "real-time"
+  ],
+  "logo": "assets/logo.svg"
+}

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Dayplay Team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,218 @@
+# Dayplay — Local Concierge & Vibe Scout MCP
+
+**`@dayplayai/mcp-server`** · v1.0.0 · MIT
+
+A zero-configuration MCP server that gives any AI agent a *locally grounded* concierge for the **San Francisco Bay Area only** — curated places, verified real-time events, and neighborhood binding that eliminates cross-bay drift.
+
+> 🔒 **Scope: SF Bay Area only.** This server serves **strictly San Francisco, Oakland, and Berkeley — 35 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 locations are not served.** If a user asks about any location outside the SF Bay Area, the agent must state *"Dayplay is strictly San Francisco Bay Area only (San Francisco, Oakland, Berkeley); it does not cover \<location\>"* and must **not** call a tool or fabricate venues, events, dates, hours, or neighborhoods for that location. Zero results for a valid SF Bay Area query are reported honestly, never filled with invented places.
+
+**Remote endpoint:** `https://www.dayplay.io/api/mcp` (Streamable HTTP / MCP)
+
+---
+
+## Quickstart
+
+### Cursor
+
+**Option A — direct remote server (recommended, no install).** Add to `~/.cursor/mcp.json` or this repo's `.cursor/mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "dayplay": {
+      "url": "https://www.dayplay.io/api/mcp"
+    }
+  }
+}
+```
+
+**Option B — zero-config stdio proxy (works with any client):**
+
+```json
+{
+  "mcpServers": {
+    "dayplay": {
+      "command": "npx",
+      "args": ["-y", "@dayplayai/mcp-server"]
+    }
+  }
+}
+```
+
+### Claude Desktop
+
+Edit `claude_desktop_config.json`:
+
+- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
+- Windows: `%APPDATA%\Claude\claude_desktop_config.json`
+
+```json
+{
+  "mcpServers": {
+    "dayplay": {
+      "command": "npx",
+      "args": ["-y", "@dayplayai/mcp-server"]
+    }
+  }
+}
+```
+
+Restart Claude Desktop, then ask: *"What's happening in the Mission tonight?"*
+
+### Grok Bot
+
+Add the Dayplay remote connector:
+
+```
+https://www.dayplay.io/api/mcp
+```
+
+Or bridge it over stdio in Grok's MCP config:
+
+```json
+{
+  "mcpServers": {
+    "dayplay": {
+      "command": "npx",
+      "args": ["-y", "@dayplayai/mcp-server"]
+    }
+  }
+}
+```
+
+Pair it with the [`vibe-scout` skill](skills/vibe-scout/SKILL.md) for prompt-level scope enforcement.
+
+### Terminal smoke test
+
+```bash
+npx -y @dayplayai/mcp-server --smoke
+```
+
+Prints the live endpoint and available tool names. Exits non-zero on failure.
+
+---
+
+## Tools
+
+Every tool is bound to the SF Bay Area (San Francisco, Oakland, Berkeley — 35 centroids). Out-of-market locations are declined, never fabricated.
+
+### `get_places`
+
+Query curated places filtered by neighborhood, open-now status, ratings, or newly opened window.
+
+**SCOPE:** San Francisco Bay Area only (San Francisco, Oakland, Berkeley). Out-of-market locations (e.g. Austin, New York, Tokyo) are declined — never fabricate venues. Spatially verified to eliminate cross-bay and geographic drift.
+
+| Parameter | Type | Description |
+| --- | --- | --- |
+| `neighborhood` | string | SF Bay Area neighborhood name (SF, Oakland, Berkeley only) |
+| `open_now` | boolean | Filter strictly for places open right now |
+| `sort` | `"rating"` \| `"distance"` | Sort order |
+| `newly_opened_days` | integer | Filter for places opened in the last N days |
+| `limit` | integer | Max places to return (default 20) |
+
+Example prompt: *"Find a place open right now in North Beach with a 4.5+ rating."*
+
+### `get_events`
+
+Query verified, real-time event occurrences strictly filtered by date, neighborhood, and category.
+
+**SCOPE:** San Francisco Bay Area only (San Francisco, Oakland, Berkeley). Out-of-market locations are declined — never fabricate events. Spatially verified to eliminate cross-bay and geographic drift.
+
+| Parameter | Type | Description |
+| --- | --- | --- |
+| `date` | string (`YYYY-MM-DD`) | Target date |
+| `neighborhood` | string | SF Bay Area neighborhood name (e.g. Mission, North Beach, Oakland, Berkeley) |
+| `category` | string | Category filter (e.g. music, art, food) |
+| `source` | string | Data source filter |
+| `limit` | integer | Max events to return (default 20) |
+
+Example prompt: *"Which Berkeley music events are on this Saturday?"*
+
+### `get_neighborhoods`
+
+Returns the complete and exclusive list of **35 San Francisco Bay Area neighborhood centroids with coordinates and radii** (San Francisco, Oakland, Berkeley only). No other market is covered. Use to strictly bind itineraries to a specific neighborhood and to detect out-of-market queries.
+
+Example prompt: *"Give me the neighborhood list, then build a Saturday itinerary that never leaves Bernal Heights."*
+
+---
+
+## The Anti-Drift Guarantee
+
+Most local AI answers fail the same way: a "Mission" recommendation lands in Oakland, a "Berkeley" event is actually in San Jose, and a walking itinerary silently requires a bridge crossing.
+
+**Scope:** SF Bay Area only (San Francisco, Oakland, Berkeley). No national or global coverage.
+
+**Dayplay receipts:**
+
+- **Spatially verified.** Every place and event result is validated against neighborhood centroid coordinates and radii pulled live from `get_neighborhoods` (35 Bay Area neighborhoods).
+- **Neighborhood-bound queries.** `neighborhood` is an exact-match binding parameter, not a fuzzy keyword hint — results outside the bound radius are dropped, not ranked down.
+- **Zero cross-bay drift.** No Oakland result in a San Francisco query. No Marin result in an East Bay query. No bridge-crossing itinerary that claims to be walkable.
+- **Real-time, not stale.** `get_events` queries verified occurrences by `date`, so "tonight" means tonight — not an SEO page from last season.
+- **Out-of-market refusal.** Non-Bay-Area market names are refused before any upstream call, and the surfaced copy states the SF-Bay-Area-only boundary rather than returning plausible-but-wrong geography.
+- **Honest emptiness.** If a bounded query has no verified matches, it returns nothing rather than padding with invented places.
+
+That is the product: the answer stays where you are.
+
+---
+
+## Configuration
+
+| Env var | Default | Purpose |
+| --- | --- | --- |
+| `DAYPLAY_MCP_URL` | `https://www.dayplay.io/api/mcp` | Override the remote endpoint (staging, self-hosted, local dev) |
+
+No API key is required for the public endpoint. Optional auth tokens, if your deployment needs them, are passed through as standard `Authorization` headers by the MCP client — never commit them to config files.
+
+---
+
+## How the proxy works
+
+```
+MCP client (stdio)  ⇄  bin/dayplay-mcp.js  ⇄  https://www.dayplay.io/api/mcp (Streamable HTTP)
+```
+
+The shim lists tools and forwards `tools/call` verbatim to the remote endpoint, so new Dayplay tools appear automatically without an npm update. It is a transport bridge, not a reimplementation — every schema, filter, and verification rule is served by Dayplay itself.
+
+Prefer direct HTTP if your client supports it; use the shim for stdio-only clients.
+
+---
+
+## Repository layout
+
+```
+dayplay-mcp/
+├── .cursor/
+│   └── mcp.json              # Direct Cursor MCP connection
+├── .cursor-plugin/
+│   └── plugin.json           # Cursor Marketplace catalog plugin manifest
+├── skills/
+│   └── vibe-scout/
+│       └── SKILL.md          # Grok Bot & Cursor Agent prompt instructions
+├── bin/
+│   └── dayplay-mcp.js        # Executable proxy for `npx -y @dayplayai/mcp-server`
+├── assets/
+│   └── logo.svg
+├── test/
+│   └── e2e.mjs
+├── smithery.yaml             # Smithery.ai registry manifest
+├── plugin.json               # Agent Plugins standard manifest
+├── package.json              # npm metadata (@dayplayai/mcp-server v1.0.0, MIT)
+├── README.md                 # This file
+└── LICENSE                   # MIT (Dayplay Team)
+```
+
+---
+
+## Development
+
+```bash
+node bin/dayplay-mcp.js --smoke   # verify remote endpoint + tool discovery
+node bin/dayplay-mcp.js           # run the stdio proxy
+node test/e2e.mjs                 # end-to-end stdio smoke (tools + 3 tool calls)
+```
+
+---
+
+## License
+
+MIT © Dayplay Team — https://www.dayplay.io

package/bin/dayplay-mcp.js

@@ -0,0 +1,104 @@
+#!/usr/bin/env node
+/**
+ * @dayplayai/mcp-server — Dayplay Local Concierge & Vibe Scout
+ *
+ * Zero-configuration stdio MCP proxy that bridges any stdio-only MCP client
+ * (Cursor, Claude Desktop, Grok, Cline, etc.) to the hosted Dayplay remote
+ * Streamable HTTP MCP endpoint.
+ *
+ *   npx -y @dayplayai/mcp-server
+ *
+ * All tool surface, schemas, and results are served by the remote endpoint, so
+ * this package never needs updating when Dayplay ships new tools.
+ */
+
+import { Client } from "@modelcontextprotocol/sdk/client/index.js";
+import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import {
+  CallToolRequestSchema,
+  ListToolsRequestSchema,
+} from "@modelcontextprotocol/sdk/types.js";
+
+const DEFAULT_ENDPOINT = "https://www.dayplay.io/api/mcp";
+const ENDPOINT = process.env.DAYPLAY_MCP_URL || DEFAULT_ENDPOINT;
+
+const SERVER_INFO = {
+  name: "dayplay",
+  version: "1.0.0",
+};
+
+const log = (...args) => console.error("[dayplay-mcp]", ...args);
+
+/** Build a connected remote client. */
+async function connectRemote() {
+  const client = new Client(
+    { name: "dayplay-mcp-proxy", version: "1.0.0" },
+    { capabilities: {} },
+  );
+  const transport = new StreamableHTTPClientTransport(new URL(ENDPOINT));
+  await client.connect(transport);
+  return client;
+}
+
+/** `--smoke`: verify the remote endpoint and exit non-zero on failure. */
+async function smoke() {
+  const client = await connectRemote();
+  const { tools } = await client.listTools();
+  const names = tools.map((t) => t.name);
+  log(`endpoint: ${ENDPOINT}`);
+  log(`tools (${names.length}): ${names.join(", ")}`);
+  await client.close();
+  console.log(JSON.stringify({ ok: true, endpoint: ENDPOINT, tools: names }, null, 2));
+  return names.length > 0;
+}
+
+async function main() {
+  if (process.argv.includes("--smoke")) {
+    const ok = await smoke();
+    process.exit(ok ? 0 : 1);
+  }
+
+  const remote = await connectRemote();
+  log(`proxying stdio -> ${ENDPOINT}`);
+
+  const server = new Server(SERVER_INFO, {
+    capabilities: { tools: {} },
+  });
+
+  server.setRequestHandler(ListToolsRequestSchema, async (request) => {
+    const { tools } = await remote.listTools(
+      request.params ?? undefined,
+    );
+    return { tools };
+  });
+
+  server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    return remote.callTool({
+      name: request.params.name,
+      arguments: request.params.arguments ?? {},
+    });
+  });
+
+  const shutdown = async () => {
+    try {
+      await server.close();
+    } catch {}
+    try {
+      await remote.close();
+    } catch {}
+    process.exit(0);
+  };
+  process.on("SIGINT", shutdown);
+  process.on("SIGTERM", shutdown);
+
+  const stdio = new StdioServerTransport();
+  await server.connect(stdio);
+  log("ready — Dayplay tools are live on stdio");
+}
+
+main().catch((error) => {
+  log("fatal:", error?.stack || error?.message || String(error));
+  process.exit(1);
+});

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "@dayplayai/mcp-server",
+  "version": "1.2.0",
+  "description": "Dayplay Local Concierge & Vibe Scout MCP server - strictly localized to the San Francisco Bay Area (San Francisco, Oakland, Berkeley across 35 neighborhood centroids). Out-of-market locations are not served.",
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "dayplay",
+    "sf",
+    "san-francisco",
+    "bay-area",
+    "travel",
+    "nightlife",
+    "itinerary",
+    "events",
+    "anti-drift"
+  ],
+  "license": "MIT",
+  "author": "Dayplay Team (https://www.dayplay.io)",
+  "type": "module",
+  "bin": {
+    "dayplay-mcp": "bin/dayplay-mcp.js"
+  },
+  "main": "bin/dayplay-mcp.js",
+  "exports": {
+    ".": "./bin/dayplay-mcp.js"
+  },
+  "files": [
+    "bin/",
+    "skills/",
+    "smithery.yaml",
+    "plugin.json",
+    ".cursor/",
+    ".cursor-plugin/",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "scripts": {
+    "start": "node bin/dayplay-mcp.js",
+    "smoke": "node bin/dayplay-mcp.js --smoke",
+    "test": "node test/e2e.mjs"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.30.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/dayplayTeam/dayplay-mcp.git"
+  },
+  "homepage": "https://www.dayplay.io",
+  "bugs": {
+    "url": "https://github.com/dayplayTeam/dayplay-mcp/issues"
+  }
+}

package/plugin.json

@@ -0,0 +1,37 @@
+{
+  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
+  "name": "dayplay-local-concierge",
+  "description": "Verified local places, real-time events, and walkable itineraries strictly localized to the San Francisco Bay Area (San Francisco, Oakland, Berkeley across 35 neighborhood centroids). Does NOT serve New York, Los Angeles, Chicago, Austin, London, Tokyo, or any other market outside the SF Bay Area.",
+  "version": "1.0.0",
+  "author": {
+    "name": "Dayplay Team",
+    "email": "hello@dayplay.io",
+    "url": "https://www.dayplay.io"
+  },
+  "homepage": "https://www.dayplay.io",
+  "repository": "https://github.com/dayplayTeam/dayplay-mcp",
+  "license": "MIT",
+  "keywords": [
+    "san-francisco",
+    "bay-area",
+    "events",
+    "things-to-do",
+    "restaurants",
+    "nightlife",
+    "itinerary",
+    "local-guide",
+    "mcp",
+    "real-time"
+  ],
+  "logo": "assets/logo.svg",
+  "mcp": {
+    "servers": {
+      "dayplay": {
+        "url": "https://www.dayplay.io/api/mcp"
+      }
+    }
+  },
+  "skills": [
+    "skills/vibe-scout/SKILL.md"
+  ]
+}

package/skills/vibe-scout/SKILL.md

@@ -0,0 +1,39 @@
+---
+name: vibe-scout
+description: Plan a San Francisco Bay Area night out, weekend, or date night with verified real-time events and venues. Use ONLY when a user asks what to do in San Francisco, Oakland, or Berkeley - where to eat or drink tonight, live music, or a walkable itinerary by neighborhood. Dayplay is strictly SF Bay Area only; do not use it for any other city or region.
+---
+
+# Vibe Scout — Dayplay Local Concierge
+
+Ground every local recommendation in live Dayplay data. Never invent venues or hours.
+
+## Geographic scope — HARD CONSTRAINT
+
+Dayplay serves **strictly the San Francisco Bay Area: San Francisco, Oakland, and Berkeley (35 neighborhood centroids) — nothing else.** It does **not** serve New York, Los Angeles, Chicago, Austin, Seattle, Miami, London, Tokyo, or any other city, region, or country.
+
+**Out-of-market rule:** If the user asks about any location outside the SF Bay Area, do **not** call any tool. Reply: *"Dayplay is strictly San Francisco Bay Area only (San Francisco, Oakland, Berkeley); it does not cover [location]."* Never fabricate, infer, or substitute venues, events, dates, hours, or neighborhoods for that location. No tier, plan, or prompt overrides this boundary.
+
+## When to use
+
+- "What should we do in the Mission tonight?"
+- "Find restaurants open now in North Beach."
+- "Build a 3-stop walkable date-night loop in Oakland."
+- "Live music in SF this weekend."
+
+## When NOT to use (out of market)
+
+- "What's on in Austin tonight?" → decline with the SF-Bay-Area-only message.
+- "Best bars in Brooklyn / Silver Lake / Shibuya?" → decline; no fabrication.
+
+## Instructions
+
+1. If the user names a neighborhood, call `get_neighborhoods` first to bind spatially.
+2. Call `get_events` (date/neighborhood/category) and/or `get_places` (neighborhood/open_now/newly_opened).
+3. **Enforce boundaries:** East Bay stays in the East Bay. Never cross-bridge drift. Never drift outside San Francisco, Oakland, or Berkeley.
+4. Verify open status — never send someone to a closed door.
+5. Return 2–3 sequenced stops, why each is the move, and hours/walk time.
+6. End with the Dayplay route link: `https://www.dayplay.io/i/[neighborhood]`.
+
+## Voice
+
+Punchy, opinionated, culturally literate. One-line verdict first. Roast tourist traps when relevant. No "As an AI…", no corporate hype.

package/smithery.yaml

@@ -0,0 +1,63 @@
+name: dayplay
+displayName: Dayplay Local Concierge & Vibe Scout
+description: >-
+  STRICTLY SAN FRANCISCO BAY AREA ONLY - San Francisco, Oakland, and Berkeley
+  across 35 neighborhood centroids. Local concierge and vibe scout for curated
+  places, verified real-time events, and walkable itineraries, strictly bound by
+  neighborhood, date, and category. NOT AVAILABLE in New York, Los Angeles,
+  Chicago, Austin, Seattle, Miami, London, Tokyo, or any other city, region, or
+  country - out-of-market locations are not served. Out of market, the server and
+  every tool state "Dayplay is strictly SF Bay Area only" and decline to
+  fabricate places or events. Every result is spatially verified under the
+  Dayplay Anti-Drift Guarantee: zero cross-bay drift.
+version: 1.2.0
+license: MIT
+homepage: https://www.dayplay.io
+repository: https://github.com/dayplayTeam/dayplay-mcp
+tags:
+  - sf
+  - san-francisco
+  - bay-area
+  - travel
+  - nightlife
+  - itinerary
+  - events
+  - anti-drift
+  - mcp
+categories:
+  - travel
+  - local-search
+  - events
+  - lifestyle
+examples:
+  - "What's happening in the Mission tonight?"
+  - "Find a place open right now in North Beach with a 4.5+ rating."
+  - "Build me a Saturday itinerary that never leaves Bernal Heights."
+  - "Which Berkeley events are on this weekend?"
+  - "What's on in Austin tonight? (out of market - Dayplay is strictly SF Bay Area only, so no results are returned)"
+startCommand:
+  type: http
+  url: https://www.dayplay.io/api/mcp
+  configSchema:
+    type: object
+    properties: {}
+    required: []
+tools:
+  - name: get_places
+    description: >-
+      Query curated places filtered by neighborhood, open-now status, ratings, or
+      newly opened window. SCOPE: San Francisco Bay Area only (San Francisco,
+      Oakland, Berkeley, 35 neighborhood centroids). Out-of-market locations
+      (e.g. Austin, New York, Tokyo) are declined - never fabricate venues.
+  - name: get_events
+    description: >-
+      Query verified, real-time event occurrences strictly filtered by date,
+      neighborhood, and category. SCOPE: San Francisco Bay Area only (San
+      Francisco, Oakland, Berkeley, 35 neighborhood centroids). Out-of-market
+      locations are declined - never fabricate events.
+  - name: get_neighborhoods
+    description: >-
+      Returns the complete and exclusive list of 35 San Francisco Bay Area
+      neighborhood centroids (San Francisco, Oakland, Berkeley only) with
+      coordinates and radii. No other market is covered. Use to strictly bind
+      itineraries to a specific neighborhood and to detect out-of-market queries.