Skip to content
Build

For people who already code with an AI agent

Build Oddgrounds games with your own Claude Code or Codex

Your agent, your terminal, your subscription. Connect it to Oddgrounds in two commands, and it can start from a template, write the game, check it the way publishing does, and put it live when you say so.

Connect your agentSee how it works

Free to connect. You'll sign in or make an account first.

Works with the agents you use

  • Claude Code

    Add Oddgrounds as an MCP server with one command, or per project with a .mcp.json. Tested with Claude Code 2.1.

  • Codex

    Add Oddgrounds with codex mcp add, or a few lines in ~/.codex/config.toml. Tested with the Codex CLI 0.159.

  • Any MCP client

    Oddgrounds speaks the open Model Context Protocol, so other agents that support remote MCP servers can connect too.

How it works

  1. Make a tokenOn Connect an agent, pick what your agent may do: read your games, change drafts, and (only if you want) publish.
  2. Add Oddgrounds to your agentPaste one command into your terminal. The token stays in your shell, never in a shared file.
  3. Ask for a game“Make a new Oddgrounds game from the platformer template and validate it.” Your agent takes it from there.
The setup, in full

Make a token first, then swap it in for <your token>.

Set up your agent

1. Put the token in your shell (e.g. in ~/.zshrc):

export ODDGROUNDS_TOKEN=<your token>

2. Add the Oddgrounds server:

claude mcp add --transport http oddgrounds https://oddgrounds.com/mcp --header "Authorization: Bearer $ODDGROUNDS_TOKEN"

Or, per project, a .mcp.json (Claude Code asks you to approve it once):

{
  "mcpServers": {
    "oddgrounds": {
      "type": "http",
      "url": "https://oddgrounds.com/mcp",
      "headers": {
        "Authorization": "Bearer ${ODDGROUNDS_TOKEN}"
      }
    }
  }
}

3. Then ask your agent: “Make a new Oddgrounds game from a template, and validate it.”

What your agent can do

  • Start from a template

    Every starter game on Oddgrounds, or a blank one, as a private draft.

  • Work on real files

    Pull a game's files, edit them with your own tools, push them back as a new draft version.

  • Check it like publishing does

    The same build, safety and originality checks our own builder runs, with the problems spelled out.

  • Use the art and sound library

    Search the free art and sound library and drop what fits into the game.

  • Preview privately

    A private link to the draft, so you can play it before anyone else does.

  • Publish when you say so

    Set the title and details, then publish. Moderation and every publishing check still apply.

Your account, your rules

  • We never see your Claude or ChatGPT login. Your agent runs on your machine and pays for its own thinking.
  • Tokens only do what you picked, expire on their own, and you can revoke one any time.
  • Every change and every refusal is in your activity log, with the agent that made it.
  • Drafts stay private. Nothing goes public until you (or your agent, with your permission) publish.

Questions

Does it cost anything?

Connecting an agent is free, and so is everything it does on Oddgrounds. Your agent's own AI usage is billed by its maker, on your Claude or ChatGPT plan.

Do I need to know how to code?

It helps. This is for people who already use a coding agent in a terminal. If you'd rather just describe a game, the Oddgrounds builder does it all in your browser.

Can my agent publish without asking?

Only if you give its token the Publish permission, which is off by default. Even then, moderation and the originality check run first, exactly as they do in the studio.

Can I keep working on the game in the studio?

Yes. A game your agent makes is an ordinary Oddgrounds game: open it in the studio, keep building with the Oddgrounds builder, or go back to your agent.

What does my agent connect to?

The Oddgrounds MCP server at oddgrounds.com/mcp, using your token. It can only see and change your own games.

Ready when your agent is

Make a token, paste one command, and ask for your first game.

Connect your agent