# Playmos

> Build games with shared identity, Mo, ownership, progression and optional multiplayer services. Agent Studio drives authoring through MCP. Playmos Managed IAP is optional: register products → pay on Base Sepolia → verify with Playmos → grant once on your trusted backend. Existing IAP backends/providers do not need a Playmos catalogue. JavaScript examples target @playmos/sdk@0.3.38.

## Add IAP to an existing game

- [Add IAP](https://playmos.io/docs/iap-quickstart.md): Fully Managed, Hybrid Managed or Self Hosted. Hub bridge, standalone checkout and trusted delivery.
- MCP catalogue workflow: playmos_get_iap_games → playmos_get_iap_catalog → playmos_save_iap_catalog. Reuse registered IDs; drafts work before keys.
- MCP contest workflow: playmos_get_contest_guide → playmos_list_contests → playmos_create_contest → playmos_submit_contest. Independent review required.
- MCP tool: playmos_get_iap_guide. Resource: playmos://guides/in-app-purchases. Public and read-only.

## Agent entry points

- [Public MCP](https://playmos.io/api/mcp): initialize and discover tools, resources and prompts without credentials.
- [Agent account and studio signup](https://playmos.io/docs/agent-onboarding.md): proof-of-key signup, scoped access, authoring and approved publication.
- [Agent integration workflow](https://playmos.io/docs/agents.md): Inspect, implement, verify and report evidence under the developer's authority.
- [Complete documentation](https://playmos.io/llms-full.txt): All guides and copyable examples in plain text.

## Skills

- [playmos-iap](https://playmos.io/skills/playmos-iap/SKILL.md): Add in-app purchases to an existing game using Playmos Fully Managed services, a Hybrid Managed backend, or Self Hosted checkout and processing. Includes the Hub SDK bridge, standalone UI, callbacks and verified fulfillment.
- [playmos-integrate](https://playmos.io/skills/playmos-integrate/SKILL.md): Integrate the Playmos SDK into a web, engine or backend project for shared game services, account identity, owned progression and stablecoin commerce.
- [playmos-verify-payments](https://playmos.io/skills/playmos-verify-payments/SKILL.md): Implement or review Playmos backend payment verification, retry recovery, webhook handling and exactly-once purchase grants.
- [playmos-contests](https://playmos.io/skills/playmos-contests/SKILL.md): Integrate Playmos leaderboard contests with studio-defined entry rules, verified admission, settlement and prize claims.
- [playmos-game-integration](https://playmos.io/skills/playmos-game-integration/SKILL.md): Build or integrate a Playmos game through MCP Studio with contest-capable source, optional IAP and controllers, configuration tools and executable integration examples.

## SDK

- [@playmos/sdk 0.3.38](https://www.npmjs.com/package/@playmos/sdk/v/0.3.38)
- [SDK reference](https://playmos.io/docs/reference.md)
- [Discovery manifest](https://playmos.io/.well-known/playmos.json): SDK metadata, skills and Markdown guides. This is a Playmos-specific manifest, not a universal agent protocol.

## Guides

- [Overview](https://playmos.io/docs/index.md): AI Studio, Playmos Games and hosted platform services. Choose your first path.
- [Quick Start: Free play](https://playmos.io/docs/free-play-quickstart.md): Upload an existing browser game, test it in Playmos Hub and release free play.
- [Add IAP to your game](https://playmos.io/docs/iap-quickstart.md): One integration path for Fully Managed, Hybrid Managed and Self Hosted games. Hub bridge, standalone checkout, callbacks and verified delivery.
- [Checkout & backend reference](https://playmos.io/docs/stablecoin-quickstart.md): Choose optional Managed IAP or keep your own backend. Register products, test and integrate manually.
- [Publish an existing game](https://playmos.io/docs/publish-game.md): Bring a browser ZIP or hosted URL, test your game and follow the review and release steps. No agent required.
- [Your first payment](https://playmos.io/docs/quickstart.md): Install the JavaScript SDK. Pay and verify on Base Sepolia.
- [Integrate with an agent](https://playmos.io/docs/agents.md): Discover Playmos skills, the SDK and machine-readable guides from one web entry point.
- [Playground](https://playmos.io/docs/playground.md): Run the actual SDK offline or against the testnet sandbox.
- [Game configuration reference](https://playmos.io/docs/game-configuration.md): Every app identity, hosting, checkout, wallet, contest and service setting in one place.
- [Set up your studio](https://playmos.io/docs/studio-setup.md): Issue test keys, set the payout wallet and use studio-owned resources.
- [Host and publish your game](https://playmos.io/docs/hosting.md): Complete public free games: ZIP upload, exact-build review, permanent links, updates, withdrawal and recovery.
- [Payments & verification](https://playmos.io/docs/payments.md): Intent, pending, confirmed, failed. Idempotency and chain provenance.
- [Web integration](https://playmos.io/docs/browser.md): Browser payment flow, pending states, persisted purchase keys and server grants.
- [Playmos Games](https://playmos.io/docs/games.md): AI Studio game making, shared runtime, portable PlayMO, Hub-hosted services and optional interface shims.
- [PlayMO portable avatars](https://playmos.io/docs/playmo.md): Account avatars, wardrobe, collectibles and portable attributes.
- [Couch mode & Buddy Mode](https://playmos.io/docs/buddy-mode.md): Install Playmos Controller, bring your profile to a TV and join or leave four-player couch sessions.
- [Phone & gamepad controllers](https://playmos.io/docs/controllers.md): Portable SDK pairing, phone controls, real Gamepad API input and Hub iframe passthrough. No Live multiplayer required.
- [Webhooks](https://playmos.io/docs/webhooks.md): Signed raw body, delivery attempts, retries and deduplication.
- [Wallets & the Base app](https://playmos.io/docs/wallets.md): Providers, login chain, gas sponsorship and Base Sepolia payment sends.
- [Games & the storefront](https://playmos.io/docs/integration.md): Iframe stage, game kit, publisher workflow, release gates and metrics.
- [Studio workspace](https://playmos.io/docs/studio.md): Choose a studio, manage games and teams, and find your reports.
- [Financials](https://playmos.io/docs/financials.md): Saved studio ledger, background sync, light bookkeeping and accountant exports. Current source is testnet-only.
- [Player sentiment & feedback](https://playmos.io/docs/sentiment.md): Review collection, charts, topic analysis, drill-downs and optional in-game feedback.
- [Analytics & your telemetry](https://playmos.io/docs/analytics.md): Consent, SDK events, custom telemetry, your exporter and Playmos Analytics.
- [Skill contests](https://playmos.io/docs/contests.md): Studio pools, rolling epochs, entry identity, score authority and payouts.
- [Playmos Live](https://playmos.io/docs/live.md): Premium managed multiplayer for independent leaderboard runs, verified ghosts and capped server usage. SDK release candidate.
- [Anti-Cheat](https://playmos.io/docs/anticheat.md): Fair competition starts with trusted scores. Check runs, spot suspicious play and review the evidence.
- [Your studio pool](https://playmos.io/docs/pools.md): Admin and operator EOAs, CLI, ownership proof, series, settlement and refunds.
- [Payouts & withdrawals](https://playmos.io/docs/payouts.md): Studio revenue, round notices, claimable prizes, wallet withdrawals and bank availability.
- [Unity & game engines](https://playmos.io/docs/engines.md): Unity WebGL host-page integration and the public engine support matrix.
- [In-game economies](https://playmos.io/docs/economies.md): Server-owned agent wallets and testnet transfers with explicit fee terms.
- [HTTP payments](https://playmos.io/docs/x402.md): Playmos x402-shaped challenges, atomic units and transfer settlement.
- [API reference](https://playmos.io/docs/reference.md): Payments, rounds, epochs, webhook endpoints and health.
- [Languages & packages](https://playmos.io/docs/languages.md): Verified npm, NuGet and PyPI versions, server REST and install availability.
- [Keys, errors & environments](https://playmos.io/docs/security.md): Publishable and secret keys, test versus live, errors and recovery.
- [Troubleshooting](https://playmos.io/docs/troubleshooting.md): Timeouts, wrong chains, missing payout wallets, pool ownership and settlement recovery.

## Boundaries

Secret keys stay server-side. Wallet signing, funded spending and production publication require developer authority. Offline mocks are not testnet proof. Live keys and mainnet remain gated. The repository-only MCP server adds scoped draft, build-quarantine and review-submission tools. Read playmos_get_publishing_guide on either MCP connection. Compiled ZIPs up to 500 MiB upload through playmos_upload_game_zip on stdio or shared chunk tools on HTTP MCP. Public free-game ZIP activation uses the publisher workspace and independent exact-build approval; upload alone does not activate it. Read /docs/hosting.md and /docs/agents.md before connecting.