# Player Two

> A game store and a launchpad: games for sale (or free) to play in the browser or download, and raises where players back a game being made, paid to its developer stage by stage as they post proof.

## Submitting a game as an agent

An agent can submit its player's game (for the store, or as a raise), upload its pictures, trailers and web builds, and edit its page, with a key the player makes in their studio (https://playertwo.lol/studio, under Agents). Send it as `Authorization: Bearer p2_agent_...`.

- MCP server (Streamable HTTP): https://playertwo.lol/api/mcp. Tools: get_submission_guide, check_game, upload_media, upload_web_build, submit_game, update_game, get_game, my_studio, list_trophies, define_trophy, list_boards, define_board.
- Agent API: https://playertwo.lol/api/v1/agent/guide explains every field, its limits, the rules and an example of each kind. Submit with POST https://playertwo.lol/api/v1/agent/games {"draft": {...}, "publish": true}.
- API spec: https://playertwo.lol/openapi.json (OpenAPI 3.1): every call of the agent API, the game SDK (a play session's, rooms' and a game server's), a game's services for its developer and the public reads, with the four ways a call says who it is (an agent key p2_agent_, a play session p2s_, a game key p2g_, a signed-in player).
- A web build bigger than a zip (up to 5 GB and 20,000 files): once the game is on Player Two, push its folder with https://playertwo.lol/cli/p2.mjs (Node 20 or later, nothing to install): `P2_AGENT_KEY=p2_agent_... node p2.mjs push <folder> --game <slug>`. It plays at https://<slug>.playertwo.cc, with no code changes. The three calls it makes: https://playertwo.lol/docs/hosting#push-calls.
- A raise is live at once but takes no money until the player (a human) checks their identity in their studio. Agents can't do that, or pay, claim money or change accounts.

## Reading a game's page

Every game's page (https://playertwo.lol/game/<slug>) has a section for agents that players don't see, `<section data-agent-facts>`: what the game is, where to play it and whether a guest can, how to play (its controls and goals, in its developer's words), whether it is multiplayer, the Player Two services it has, and how to report a bug. It is in the page's HTML even when the page asks a player's age first. The same game as JSON: https://playertwo.lol/api/v1/games/<slug>.

## More

- Docs: https://playertwo.lol/docs
- The game SDK (trophies, stats, leaderboards, saves, presence, and rooms for multiplayer with no server of the game's own, for hosted games): https://playertwo.lol/docs/sdk
- On npm: playertwo-sdk (init() for bundled code, and the SDK's TypeScript types, a room's code included: https://www.npmjs.com/package/playertwo-sdk), and a new game from a starter: `npm create playertwo-game@latest my-game` (https://www.npmjs.com/package/create-playertwo-game)
- Hosting a web game here, or playing it from its own site: https://playertwo.lol/docs/hosting
- Help: https://playertwo.lol/help
- Content policy: https://playertwo.lol/policy