← All editors

Connect VS Code

GitHub Copilot Chat, Agent mode. Native remote MCP. Two ways to wire it up: let our CLI do it, or edit the config by hand.

The agent runs on credits

Building gives you your own cloud sandbox, where your projects and the Phaser Agentic Engine live. Time on it is billed per minute, and generating images and audio costs credits too. A fully featured game typically costs around 500 credits to build.

You need credits on your Phaser account before you can build.

Option A · Automatic Recommended

Let the CLI configure it

Signs you in and writes VS Code’s MCP config for you. Needs Node.js 20+.

Terminal
npx @phaserjs/game-agent setup --tool vscode

Or run npx @phaserjs/game-agent with no arguments to detect every editor you have installed and pick from a list.

Option B · Manual

Edit the config by hand

Prefer to wire it up yourself? Generate a token, then add the phaser-game-agent server to VS Code’s config file under the servers key.

Your access token

A token and a positive credit balance are required to perform any operation on the MCP server.

Checking your account…

The config file lives here (create it if it doesn’t exist):

  • macOS~/Library/Application Support/Code/User/mcp.json
  • Windows%APPDATA%\Code\User\mcp.json
  • Linux~/.config/Code/User/mcp.json
mcp.json
{
  "servers": {
    "phaser-game-agent": {
      "type": "http",
      "url": "https://mcp.phaser.io/agent/mcp",
      "headers": {
        "Authorization": "Bearer pga_YOUR_TOKEN"
      }
    }
  }
}

Restart & verify

  1. Restart VS Code

    MCP servers are read at startup, so the new tools won’t appear until you fully restart VS Code.

  2. Ask it to check your account

    Open Copilot Chat → Agent mode and ask it to check your account. A greeting with your name and credit balance means you’re connected.

    Check my Phaser Game Agent account
You need Copilot Chat in Agent mode to call MCP tools. After restarting, run “MCP: List Servers” from the Command Palette to confirm the server is registered.
If you also have the Claude Code VS Code extension, its MCP panel reads a workspace .mcp.json. That is not the same list and won’t show this server, so verify through Copilot’s Agent mode instead.

What you can ask it

You describe what you want in plain language and your agent calls the tools for you. Tap a prompt to copy it.

Account and games

Build a game

Tweak and polish

Build your first game

Three prompts, start to finish. Paste them into your agent’s chat.

  1. Prove the connection

    It greets you by name and reports your credit balance, which tells you the tool loaded and your token works.

    Check my Phaser Game Agent account

  2. Describe a game

    Your agent reads the built-in guide, opens a cloud project, reuses known-good blocks, writes the code, type-checks it and publishes a preview. You get a public playUrl when it finishes.

    Use the Phaser Game Agent: open a project and build me a Breakout clone, then preview it.

  3. Play it and ask for changes

    Open the play URL in your browser, then keep talking. Your sandbox pauses automatically after every operation, so you pay for the work it does and not for the time you spend playing or thinking.

    Make the paddle wider and add a particle burst when a brick breaks.
    Add a high-score table that survives a refresh.
    How many plays has my game had?

After the build

Finished games land in your library at /agent/games, with versions and play analytics. From there you can:

Play it

Runs in the browser. Players need no download and no account.

Share it

Every game gets a public link you can send to anyone.

Export it

Download a standalone build for Web, Windows, macOS or Linux.

Embed it

Drop it into your own site with an iframe.

See your games