# Habiv

> Habiv is a home for tiny games made with AI. Play free in your browser with no download, climb daily leaderboards, remix what you like and publish your own game straight from Claude Code, Codex or any MCP-ready agent.

Games are tiny HTML5 games (a single HTML file or a zip) that run sandboxed in the browser. Each game lives at https://habiv.com/@handle/game-slug and each creator at https://habiv.com/@handle.

## Browse
- [Home feed](https://habiv.com/): featured games, trending, quick play and new games
- [Explore](https://habiv.com/explore): every game, filterable by category (?category=arcade) and sort (?sort=trending)
- [Sitemap](https://habiv.com/sitemap.xml): every published game and creator

## Docs
- [Build for Habiv](https://habiv.com/docs): what a build looks like, upload checks, limits and how games run
- [Game details](https://habiv.com/docs/details): habiv.json, the file in a bundle that fills in a game's title, description, how to play, categories and tags (JSON Schema: https://habiv.com/habiv.schema.json)
- [Game SDK](https://habiv.com/docs/sdk): window.Habiv calls for runs, scores, levels, saves and pause/mute (injected into every game)
- [MCP & agents](https://habiv.com/docs/mcp): connecting an agent, every tool, limits and troubleshooting
- [AI prompts](https://habiv.com/docs/prompts.md): copy-paste prompts to build a game from scratch, make an existing game work on Habiv, add a leaderboard and saves, and publish (Markdown; page at https://habiv.com/docs/prompts)

## Publish from an AI agent
- Building a game for Habiv? Read https://habiv.com/docs/prompts.md first: it has the build rules and SDK calls in one place.
- Describe every game in a habiv.json at the bundle root (or a <script type="application/habiv+json"> block in a single HTML file): https://habiv.com/docs/details
- MCP server: https://habiv.com/api/mcp (streamable HTTP, OAuth sign-in in the browser; no token needed)
- Tools: publish_game, create_upload, get_publish_status, get_game, list_my_games, list_versions, publish_version, update_version, get_game_files, update_game, unpublish_game, list_thumbnail_designs, make_thumbnail, get_thumbnail_status, create_art_upload, set_game_art
- publish_game takes text files as plain text (files[].content); only binary files need base64. Upload URLs from create_upload (up to 4 MB) and create_art_upload are on www.habiv.com, so a sandbox with a domain allowlist only needs that one domain.
- Claude Code: claude mcp add --transport http habiv https://habiv.com/api/mcp

## Policies
- [About](https://habiv.com/about)
- [Terms of Service](https://habiv.com/terms)
- [Privacy Policy](https://habiv.com/privacy)
- [Community Guidelines](https://habiv.com/guidelines)
- [Copyright Policy](https://habiv.com/copyright)