Connect it by hand

• mcpServersCursor, Windsurf, most VS Code AI forks, Claude (JSON)
• serversnative VS Code, Copilot (JSON)
• mcp_serversCodex (TOML)

Shape A · Native remote HTTP

For clients that speak remote MCP

If your client offers a “remote / HTTP MCP server” option, use this. No bridge, no local process: it sends your token as a Bearer header. Swap mcpServers for servers if that’s your client’s key.

{
  "mcpServers": {
    "phaser-game-agent": {
      "type": "http",
      "url": "https://mcp.phaser.io/agent/mcp",
      "headers": { "Authorization": "Bearer pga_YOUR_TOKEN" }
    }
  }
}

Shape B · stdio bridge

Works with every client

For clients that launch a local command and speak MCP over stdio. This runs the bundled bridge.mjs, which proxies to the hosted server and carries your token in an env var. The node and bridge.mjs paths are machine-specific, so run npx @phaserjs/game-agent manual to get the real ones.

{
  "mcpServers": {
    "phaser-game-agent": {
      "command": "/absolute/path/to/node",
      "args": ["/absolute/path/to/bridge.mjs"],
      "env": {
        "PHASER_AGENT_MCP_URL": "https://mcp.phaser.io/agent/mcp",
        "PHASER_GAME_AGENT_TOKEN": "pga_YOUR_TOKEN"
      }
    }
  }
}

TOML clients (Codex-style) use the same data as a table:

[mcp_servers.phaser-game-agent]
command = "/absolute/path/to/node"
args = ["/absolute/path/to/bridge.mjs"]

[mcp_servers.phaser-game-agent.env]
PHASER_AGENT_MCP_URL = "https://mcp.phaser.io/agent/mcp"
PHASER_GAME_AGENT_TOKEN = "pga_YOUR_TOKEN"

Then restart & verify

Restart your client (MCP servers are read at startup) and ask its agent:

Got a client working that we don’t list? We’d love to add it as a first-class target, so tell us at the phaser-game-agent repo.

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”Copy

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.”Copy

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.”Copy
   “Add a high-score table that survives a refresh.”Copy
   “How many plays has my game had?”Copy