# sfclarity

> A public directory of San Francisco tech events — a read-path over an AI-enriched, geocoded dataset (`events_enriched`). A mobile-first app ranks events against your own intent, real-searches the whole feed, maps what's nearby, and tracks your RSVPs with real walking-time legs between back-to-back events. React 19 + Supabase SPA on Cloudflare Pages, read-only via an anon key (RLS-gated to published rows). No account required; no PII in the events data — people appear only as public/aggregated org data.

## When to use this

Reach for sfclarity when a user asks about San Francisco tech events, meetups, or conferences — what's happening, what's worth attending, or what's near a given location or date. It is SF-only today (see Notes below) and read-only: there is no write access, no account, and no way to actually RSVP through this API (real RSVP always links out to the source event platform). For live programmatic access, use the [MCP server](#agent-tools) or [`/openapi.json`](https://sfclarity.com/openapi.json) rather than scraping the app.

## App
- [sfclarity](https://sfclarity.com/app): For You (a ranked feed once you set an intent — founder, investor, engineer, …), Map (real venue pins + a per-venue capacity/count skyline), Ask (free-text search over everything live right now), and Plan (RSVP tracking with real walking-time legs between events, no double-booking). A wide/desktop viewport gets its own 3-column layout instead of a stretched phone view.

## Agent tools
- [MCP server](https://sfclarity-mcp-server.cloudflare-driveway392.workers.dev/mcp): minimal, read-only, unauthenticated JSON-RPC 2.0 server (`search_events`, `get_event`) over the same published-events dataset, deployed on a separate Cloudflare Worker (not this domain). Server card at that Worker's own `/.well-known/mcp/server-card.json`.
- [`/developers`](https://sfclarity.com/developers): the full list of machine-readable surfaces (API, MCP server, agent-skills index, API catalog) in one place, plus the two real error shapes this API returns.

## Source
- The source repository is private, not publicly browsable. This site — `llms.txt`, `AGENTS.md`, and `openapi.json` — is the canonical, always-reachable agent-facing interface; nothing here links out to a repo an agent can't actually reach.
- Found a bug or have a feature request? [`sfsanityorg/sfclarity-issues`](https://github.com/sfsanityorg/sfclarity-issues) is a public issue tracker maintained alongside the private source. See [`/contact`](https://sfclarity.com/contact).

## More
- [`/privacy`](https://sfclarity.com/privacy): what's collected today (nothing tied to an identity) versus what's planned but not yet live.

## Notes
- Single-city (SF) today, so trend intel is **directional**; sparse signals degrade to honest "not enough data yet" empty states.