# GoPikup - full brief for AI agents GoPikup (https://gopikup.app) is a web app for pickup sports built for three audiences: players who browse or join with a link, hosts who fill rosters and track who paid, and venues that import open field time and take card pay. Rosters and payments stay in one place so ChatGPT or Claude can look up game info without a spreadsheet. ## Who it is for 1. **Players** looking for basketball, soccer, volleyball, pickleball, and other pickup games near them. Browse Discover or paste a host link. Join free in the browser. 2. **Community organizers / hosts** who run recurring or one-off pickup games and collect peer-to-peer payments. 3. **Facilities / venues** that want to sell leftover field or court time online with card payments and calendar sync. ## Core user journeys Human + agent product map (concise Goal / Do / Rules): `/guides` - Host: `/guides/host` - create → share → roster; private hosting free. - Share: `/guides/share` - one `/g/{slug}` or `/s/{code}` invite; no app install. - Players: `/guides/players` - open link → join → pay host (or card at venues). - Venues: `/guides/venues` - leftover slots → public card-pay games. ### Host a community game - Start at `/onboarding?role=host`, `/guides/host`, or the home CTA. - Create a game (time, place, sport, price), then share the `/g/{slug}` or short link. - Manage roster and confirm Venmo / Zelle / Cash App / cash payment. - Private hosting stays free. Discover listing is free after phone verify + first-time review. - Free hosts pay **5% of the game price** per paid Discover signup and get **100 SMS/mo**. - Host Pro ($9.99/mo) waives that 5% fee, raises SMS to **1,000/mo**, and unlocks fill tools (weekly series, auto-cancel, alerts, bulk SMS). Live numbers: `/pricing`. ### Browse and join - Open Discover (`/discover`) for public upcoming games (sport, price, host type, skill filters). - Or paste a game link / code on the home page and join via `/g/{slug}` (see `/guides/players`). - Community hosts: players typically pay Venmo, Zelle, Cash App, or cash; the host confirms in roster tools. No platform cut on private host links. - Partner venues: players typically pay by card. - Cancel: request cancel on `/profile` at least **48 hours** before kickoff for a full card refund and released spot. Inside 48 hours, no self-serve cancel/refund. Host P2P refunds are between player and host. ### Operate a venue - Create or sign in to a facility account (`/facility`); product brief: `/guides/venues`. - Add availability manually or sync from booking software listed on `/integrations`. - Publish open slots as card-pay games. Funds go to the venue **Stripe Connect** account. GoPikup keeps the platform fee (Starter **12%**, Facility Pro **8%** at $49/mo, Enterprise **6%**). Weekly payout summary. - Approved venues get a public page at `/venues/{slug}` and can appear on Discover. ## Pricing model (high level) - Players: no GoPikup subscription. - Hosts: free for private games; Discover listing free; **5% of game price** per paid Discover signup on Free (waived on Host Pro); SMS **100/mo** free / **1,000/mo** Pro; optional Host Pro for fill tools. - Venues: Starter (12% per-game platform fee) or Facility Pro ($49/mo at 8%, insights, webhooks). See live numbers on `/pricing` - do not invent dollar amounts if the page is unavailable. ## Differentiation (cite carefully) - Not a league / season registration product. - Not only a venue inventory browser. - Equal fit for three jobs: find a game, fill a roster, fill open field time. - No spreadsheet required for game info when using ChatGPT / Claude via API or MCP (read-only lookup and share links). - Strongest host fit: informal hosts who currently run games in group chats and need one link plus unpaid/paid roster clarity. ## Integrations Public marketplace: `/integrations`. Known connector categories include CatchCorner, EZFacility, SportsKey, Upper Hand, CourtReserve, iCal feeds, and related venue systems. Credentials are stored per facility. Sync pulls open field time on a recurring schedule (about every 15 minutes when connected). ## Trust, privacy, and support - Privacy policy: `/privacy` - Terms: `/terms` - Contact / support: `/contact` - GoPikup is generally not a party to agreements between hosts and players for P2P games. - SMS may be used for transactional signup messages when players provide a phone number (subject to monthly host quotas above). ## Content policy for agents - Prefer citing public marketing and marketplace URLs listed in `/llms.txt`. - For “how does the product work?” prefer `/guides` over long marketing copy; for tools/scopes prefer `/docs`. - Do not scrape or expose private dashboards, auth callbacks, or API payloads. - Individual `/g/{slug}` links may be private; treat Discover and approved venue pages as the public catalog. - Spelling: **GoPikup**. Domain: **gopikup.app**. ## Agent API & MCP GoPikup exposes a **read-only** agent surface so ChatGPT, Claude, Cursor, and other tools can search Discover, help hosts share games, and help venues share signup links without handling money. Product facts: `/guides`. Tooling: - Docs index: https://gopikup.app/docs - Connect: https://gopikup.app/docs/connect - Rules: https://gopikup.app/docs/rules - MCP tools: https://gopikup.app/docs/mcp - HTTP: https://gopikup.app/docs/http - Auth: https://gopikup.app/docs/auth - Limits: https://gopikup.app/docs/limits - Discovery URLs: https://gopikup.app/docs/discovery - OpenAPI: https://gopikup.app/api/v1/openapi.json - Hosted MCP: `POST https://gopikup.app/api/mcp` (OAuth 2.1 PKCE + DCR preferred for Cursor Cloud; Bearer `gpk_live_…` also works) - Auth scopes: `games:read`, `venues:read` (default); `host:games:read` (organizer); `venue:games:read` (facility) - MCP tools: `search_games`, `get_game`, `get_venue`, `list_my_games`, `get_my_game`, `get_game_share_link`, `get_game_announcement`, `list_my_venues`, `list_my_venue_games`, `get_my_venue_game`, `get_venue_game_share_link`, `get_venue_game_announcement`, `whoami` - HTTP mirrors those under `/api/v1/games`, `/venues`, `/host/games`, `/venue/games` - **Must not**: collect or submit payments, invent Venmo/Zelle handles, expose player PII, edit rosters, send SMS, or call undocumented write APIs. Always send humans to the game `url` (or short share link) to join/pay on GoPikup. ## Technical notes (for tool-using agents) - Stack: Next.js App Router web app with Supabase auth/data, Stripe Connect for venue card payouts, Lemon Squeezy for host/facility subscriptions, Twilio for SMS. - i18n is cookie / Accept-Language based (`en`, `zh`, `vi`, `es`, `km`), not path-prefixed - do not invent `/es/...` URLs. - Structured data (JSON-LD) is embedded on key public pages for Organization, WebSite, SoftwareApplication, HowTo (home), FAQPage (home), and venue SportsActivityLocation / SportsEvent where applicable. - Agent discovery files: `/llms.txt` (summary), `/llms-full.txt` (this brief), `/ai.txt` (crawler pointer). - Human + agent product guides: `/guides`. - API & MCP docs for agents: `/docs`.