io.github.antics-gg/antics-mcp
Deploy a web game to a playable multiplayer URL with rooms, state sync, and leaderboards.
Open source Open in the app JSON README (API)
About
Deploy a web game to a playable multiplayer URL with rooms, state sync, and leaderboards.
Details
- Kind
- MCP servers
- Topic
- Cloud & DevOps
- Publisher
- antics-gg
- Origin
- official
- Category
- ferramentas
- Transport
- local
- Version
- 0.5.0
- Stars
- 5
- Last push
- 2026-07-23T13:39:33Z
- Repository state
- ativo
- Language
- TypeScript
- License
- NOASSERTION
- Added
- 2026-08-29 03:02:26
- Updated
- 2026-08-29 03:02:26
- Origin id
io.github.antics-gg/antics-mcp
README
# antics-mcp
**Multiplayer for your game, in one prompt.** An [MCP](https://modelcontextprotocol.io) server
that lets an AI agent generate a web game and deploy it to a **playable multiplayer URL** —
rooms, live state sync, and leaderboards — inside a single conversation.
AI can write a whole game — a single HTML file or a multi-file project — but it can't stand up
a server, so everything it builds is single-player. `antics-mcp` is the missing piece: your
agent writes the game, calls one tool, and hands you back a link your friends can open. No
backend, no player accounts.
→ [antics.gg](https://antics.gg) · full API in one file: [antics.gg/llms.txt](https://antics.gg/llms.txt)
## Install
**Claude Code:**
```sh
claude mcp add antics -- npx -y antics-mcp
```
**Claude Desktop / Cursor / any MCP client** — add to your MCP config
(`claude_desktop_config.json`, Cursor's `mcp.json`, etc.):
```json
{
"mcpServers": {
"antics": {
"command": "npx",
"args": ["-y", "antics-mcp"]
}
}
}
```
Then just ask: *“Make a 2-player game and deploy it.”* The agent writes it, calls `deploy_game`,
and returns a playable URL — no copy-paste, no site visit, no login.
## Tools
| Tool | What it does | Login? |
|------|--------------|--------|
| **`deploy_game`** | Deploy a game (`html` for a single file, or `files` for a multi-file project) → returns a playable multiplayer URL. Keyless (ephemeral room) unless given a `projectId`. | No |
| **`create_project`** | Create a project; returns its id, publishable key (`pk_`), and secret key (`sk_`, shown once). | Yes |
| **`get_leaderboard`** | Read a project's leaderboard (top scores). | Yes |
| **`list_projects`** | List your projects. | Yes |
| **`set_share_preview`** | Brand how a project's room links unfurl on social — title, description, and image. | Yes |
`deploy_game` works **without any login** — it returns an ephemeral, keyless URL you can share
immediately (rooms hold 8 players and last 24h). To persist links + leaderboards and raise the
limits, sign in once with `npx antics-cli login` (GitHub), then the owner-scoped tools unlock and
`deploy_game` can target a project.
## How the multiplayer works
Your agent doesn't need to know any of this up front — [antics.gg/llms.txt](https://antics.gg/llms.txt)
is the complete API in one file, written so an LLM can integrate it one-shot. In brief: a game
calls `joinRoom({})`, shared room state is host-authoritative with per-player slices, writes
coalesce to ~20 Hz, and a leaderboard is one `submitScore()` call. The deployed game runs at a
`/r/<code>` URL with an invite link + QR built in.
## Links
- Site: https://antics.gg
- Docs / API reference: https://antics.gg/docs · https://antics.gg/llms.txt
- Try a demo (no install): the four games on [antics.gg](https://antics.gg) were each generated
one-shot from the docs.