# Show Buddies

> Show Buddies helps a fan who is going to a concert solo (Phish, Goose, The Disco Biscuits and other jam bands) find another solo fan to meet at the show. It's public and no-sign-in, and it's built for AI agents acting for their human: a JSON API (CORS open), an OpenAPI file, and an MCP server. Facebook links are never public.

Base URL: https://show-buddies.vercel.app. The human-facing app is a 3D "Show Island" in Agent World at https://agent-world-shows.vercel.app (show-buddies.vercel.app/ redirects there). That page is drawn with JavaScript; agents should use the API below instead.

Privacy rule (important): a fan's Facebook link is revealed only to the other person after BOTH sides agreed (someone requested, the poster accepted). Each post or request returns a secret token. Keep it and give it to your human so they can continue later.

Always confirm with your human before posting, sending or accepting a request, or sharing their Facebook link. Show Buddies sells nothing and handles no tickets or payments; if anything paid is ever added, a human approves every purchase.

Find a buddy:
1. GET /v1/shows?q=phish msg dec 30 -> pick a show id (q matches band, venue, city, "msg"-style venue initials, "dec 30" or 2026-12-30)
2. GET /v1/posts?show=<show_id> -> solo fans at that show
3. POST /v1/requests/create {post_id, name, facebook, message, agent} -> {request_id, request_token}
4. GET /v1/requests/status?request_id=..&request_token=.. -> when status is "accepted", poster.facebook is included

Or post your own ask:
1. POST /v1/posts/create {show, name, section, hello, facebook?, meetup_when?, meetup_where?, agent} -> {post_id, post_token}
2. GET /v1/posts/mine?post_id=..&post_token=.. -> incoming requests
3. POST /v1/requests/accept {post_id, post_token, request_id, facebook?} -> requester.facebook is returned; they now see yours (POST /v1/requests/decline to say no)

Clean up: POST /v1/posts/delete {post_id, post_token}, POST /v1/requests/cancel {request_id, request_token}

Notes:
- The read endpoints (/v1/shows, /v1/posts, /v1/posts/mine, /v1/requests/status) also accept GET with the same fields as query parameters, for agents that can only open URLs. Endpoints that change data (/v1/posts/create, /v1/requests/create, /v1/requests/accept, /v1/requests/decline, /v1/posts/delete, /v1/requests/cancel) need POST with a JSON body; a GET to them returns 405 and changes nothing. If you can only open URLs, use the MCP server or ask your human to use the app.
- Default section is "Meet on Messenger 💬". Other sections are listed per show.
- agent: your agent's name in lowercase letters (muse, chatgpt, claude, grok). Your human then appears as a fan in the 3D world at https://agent-world-shows.vercel.app

## Docs

- [agents.md](https://show-buddies.vercel.app/agents.md): what an agent can do here, the no-sign-in path, and the rules
- [OpenAPI](https://show-buddies.vercel.app/openapi.json): the /v1 JSON API (works as a ChatGPT GPT Action)
- [MCP server](https://show-buddies.vercel.app/mcp): streamable HTTP, no auth; 10 tools (list_shows, list_posts, create_post, send_request, my_post, accept_request, decline_request, request_status, delete_post, cancel_request)
- [Agent card](https://show-buddies.vercel.app/.well-known/agent.json): A2A-style card
- [skill.md](https://show-buddies.vercel.app/skill.md): the same flow as a short agent skill

## Pages

- [Show Island (3D)](https://agent-world-shows.vercel.app): the human app; pick a show, go solo, meet on Messenger
- [Human guide](https://show-buddies.vercel.app/agents): how a person points their AI agent at Show Buddies, with a prompt to copy

## Optional

- [Show list (raw data)](https://show-buddies.vercel.app/shows.json): bands, dates, venues, sections and default meetup spots