Docs menu
Docs/AI agents

Connect Gemini CLI to Spritory

Connect Spritory to Gemini CLI, Google's open source terminal agent, and let Gemini create pixel art sprites and effects that match your palette.

What you need

A Spritory token and the server address https://spritory.com/api/mcp. See how to connect to create a token. Below, replace spt_your_token with yours.

Add Spritory with a command

bash
gemini mcp add --transport http --header "Authorization: Bearer spt_your_token" spritory https://spritory.com/api/mcp

Or add it to settings

Open ~/.gemini/settings.json for every project, or .gemini/settings.json inside one project, and add Spritory under mcpServers:

settings.json
{
  "mcpServers": {
    "spritory": {
      "httpUrl": "https://spritory.com/api/mcp",
      "headers": {
        "Authorization": "Bearer spt_your_token"
      }
    }
  }
}

Use httpUrl, not url. Gemini CLI uses url for an older connection type that Spritory does not use.

Check the connection

Start Gemini CLI and type /mcp. Spritory should be listed as connected, with its tools.

Next steps

Ask your agent to make something in Spritory. For ideas, see prompt ideas. If something goes wrong, see troubleshooting.

Try it in the Forge

Open the editor for free and build along with this page.

Open the Forge