The page did not load

The connection dropped or something went wrong. Try again — it usually helps.

Go home

MCP

Connect Claude, Cursor, Codex or any MCP host and generate from the chat


GeckoGen is an MCP server. A connected assistant can list models, read each model's parameters, start generations and show the results — with your balance and history.

Claude.ai and Claude Desktop

Add GeckoGen as a custom connector with this address:

https://api.geckogen.app/mcp

Claude opens a GeckoGen page where you confirm access with your account. You can revoke it in the connector settings of Claude.

Claude Code, Cursor and Codex

  1. Open your profile on GeckoGen and create a key in MCP Connector.
  2. Copy the ready setup for your client from the same section, or use one of these:

Claude Code:

claude mcp add --transport http --scope user geckogen \
  https://api.geckogen.app/mcp \
  --header "Authorization: Bearer YOUR_KEY"

Cursor (~/.cursor/mcp.json):

{
  "mcpServers": {
    "geckogen": {
      "url": "https://api.geckogen.app/mcp",
      "headers": { "Authorization": "Bearer YOUR_KEY" }
    }
  }
}

Codex (~/.codex/config.toml), then export GECKOGEN_API_KEY with your key:

[mcp_servers.geckogen]
url = "https://api.geckogen.app/mcp"
bearer_token_env_var = "GECKOGEN_API_KEY"

Local server for your files

The local server runs on your computer and can send images from your disk to a generation:

curl -fsSL https://api.geckogen.app/mcp-local/install.sh | sh

The client setup for the local server is in the same MCP Connector section of your profile.

What the assistant can do

  • List models and read the exact parameters of each one.
  • Quote the price of a generation before starting it.
  • Start image, video and music generations and wait for the result.
  • Read your balance and generation history.

A generation that fails returns its tokens to your balance.