gobananas-mcp

Quickest setup: gobananasai.com/connect has copy-ready steps for Claude, ChatGPT, Cursor, VS Code, Claude Code, Codex and Gemini CLI. Claude Code and Codex users can install the go-bananas plugin (server + skill). The MCP address is https://mcp.gobananasai.com; https://gobananasai.com/mcp still works.

MCP server for Go Bananas AI image generation. Connects MCP clients (Claude Desktop, Claude Code, Cursor, VS Code, Codex) to the Go Bananas server.

53 tools for subscription generation, provider image generation, conversational editing, reusable assets, posters, model discovery, quota checks, and analytics — this STDIO proxy lists 54, adding the synthetic go_bananas_diagnose connection-troubleshooting tool to every tools/list.

What's New (v1.3.6)

• 1.3.6 — when Go Bananas rejects the sign-in, the MCP proxy says the tool did not run and is safe to retry, instead of warning that it may have completed.
• 1.3.5 — the MCP proxy and CLI client read the browser-login token for every request and refresh it on a 401, so a session that outlives its access token no longer fails one call with "Access token has expired".
• Earlier: 1.3.0 added authoritative subscription routing, explicit generation lanes, and OAuth-aware go_bananas_diagnose output. See CHANGELOG.md — "CLI / MCP proxy releases" — for the full history.

Quick Start

Requires Node.js 20.3.0 or newer. Earlier versions exit with an upgrade message before starting the CLI or MCP connection.

Auth Modes

There are two supported ways to connect:

| Mode | Best For | How Auth Works | | --------------------- | ----------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------- | | Remote HTTP OAuth | claude.ai connectors, Claude Code, Codex, Cursor/VS Code clients that support remote MCP OAuth | The client connects to https://mcp.gobananasai.com and stores OAuth tokens for that URL | | STDIO proxy | Claude Desktop config files, older editors, Hermes/cloud agents, or clients without remote HTTP OAuth | The client launches gobananas-mcp; the proxy reads local gobananas-cli OAuth tokens or GO_BANANAS_API_KEY |

Keep only one go-bananas entry per client/scope. Logging in with npx -y gobananas-cli auth login authenticates the STDIO proxy only; it does not authenticate a separate direct HTTP config entry.

Claude Desktop / claude.ai Remote Connector

No installation needed when using the hosted connector flow:

1. Go to Settings > Connectors > Add custom connector
2. Enter URL: https://mcp.gobananasai.com
3. Authenticate with your Go Bananas account

That's it. All 53 tools are available immediately.

Remote HTTP clients receive subscription-first instructions from the hosted server. STDIO clients receive the same instructions from gobananas-mcp v1.2.0 or newer. Version 1.3.0 adds lane controls and structured provenance for human CLI consumers.

Claude Code (Recommended — Remote HTTP OAuth)

claude mcp add --transport http -s user go-bananas https://mcp.gobananasai.com

Then run /mcp in Claude Code and authenticate in the browser. This uses Go Bananas OAuth; you do not need to paste an API key into your MCP config.

Codex (Remote HTTP OAuth)

codex mcp add go-bananas --url https://mcp.gobananasai.com
codex mcp login go-bananas

Use codex mcp get go-bananas to verify the configured endpoint.

Universal Install (9+ Clients)

Works across Claude, Cursor, VS Code, Gemini CLI, and more:

npx add-mcp https://mcp.gobananasai.com

STDIO Clients / Hermes / Cloud Agents

If your client cannot use remote HTTP MCP connectors, use this local STDIO proxy. Run browser login once, then point the client at gobananas-mcp without putting an API key in the MCP config:

npx -y gobananas-cli auth login

This opens Go Bananas in your browser, stores OAuth tokens locally, and the STDIO proxy reads the token on every request and refreshes it near expiry or on a 401, not just at connect time.

Then add the proxy to your MCP config.

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "go-bananas": {
      "command": "npx",
      "args": ["-y", "gobananas-mcp"],
      "env": {
        "GO_BANANAS_SERVER_URL": "https://gobananasai.com",
        "GO_BANANAS_MCP_TRANSPORT": "streamable-http"
      }
    }
  }
}

Restart Claude Desktop after saving.

Configurations using npx -y gobananas-mcp load the newest package when the app restarts. For a global installation, run npm update -g gobananas-cli gobananas-mcp before restarting the app.

For Claude Code STDIO:

claude mcp add -s user go-bananas \
  -e GO_BANANAS_SERVER_URL=https://gobananasai.com \
  -e GO_BANANAS_MCP_TRANSPORT=streamable-http \
  -- npx -y gobananas-mcp

For Codex STDIO:

codex mcp add go-bananas \
  --env GO_BANANAS_SERVER_URL=https://gobananasai.com \
  --env GO_BANANAS_MCP_TRANSPORT=streamable-http \
  -- npx -y gobananas-mcp

For headless/cloud environments, run npx -y gobananas-cli auth login --no-open and open the printed authorization URL in a browser that can reach the local callback address. If that is not possible, use the API-key fallback:

{
  "mcpServers": {
    "go-bananas": {
      "command": "npx",
      "args": ["-y", "gobananas-mcp"],
      "env": {
        "GO_BANANAS_API_KEY": "sk_live_your_api_key",
        "GO_BANANAS_SERVER_URL": "https://gobananasai.com",
        "GO_BANANAS_MCP_TRANSPORT": "streamable-http"
      }
    }
  }
}

Cursor

Prefer remote HTTP OAuth when supported:

{
  "mcpServers": {
    "go-bananas": {
      "type": "http",
      "url": "https://mcp.gobananasai.com"
    }
  }
}

Otherwise add the STDIO proxy to .cursor/mcp.json after running npx -y gobananas-cli auth login:

{
  "mcpServers": {
    "go-bananas": {
      "command": "npx",
      "args": ["-y", "gobananas-mcp"],
      "env": {
        "GO_BANANAS_SERVER_URL": "https://gobananasai.com",
        "GO_BANANAS_MCP_TRANSPORT": "streamable-http"
      }
    }
  }
}

Global Install

npm install -g gobananas-mcp

Then use "command": "gobananas-mcp" without the args field.

What You Can Do

| Category | Tools | Examples | | ---------------------- | ------------------------------------------------------- | ---------------------------------------------------- | | Subscription | get_subscription_status, generate_with_subscription | Create through the connected subscription first | | Generate | generate_image, batch_generate | Explicit Gemini/OpenAI provider generation | | Edit | edit_image, continue_editing | "add clouds", "make it brighter" | | Characters | create_character, generate_with_character | Consistent characters across scenes | | Products | create_product_reference, generate_with_product | Marketing images with real products | | Styles | create_style_preset, list_style_presets | Reusable brand templates | | Models & Analytics | list_models, check_quota, get_usage_stats | Capability discovery, cost estimates, quota tracking |

Run list_models before advanced model choices, and run check_quota before large batches, OpenAI high quality, or 2K/4K generations. check_quota returns storage/rate/service health plus an approximate provider-cost estimate.

Environment Variables

| Variable | Default | Description | | -------------------------- | ------------------------- | ------------------------------- | | GO_BANANAS_API_KEY | — | API-key fallback for STDIO mode | | GO_BANANAS_SERVER_URL | https://gobananasai.com | Server URL | | GO_BANANAS_MCP_TRANSPORT | streamable-http | Transport protocol |

How It Works

This package re-exports the MCP STDIO proxy from gobananas-cli. The proxy presents a compatible MCP server over stdio and bridges to the remote Go Bananas server over Streamable HTTP. It probes and negotiates MCP 2026-07-28 upstream, falling back to legacy MCP when needed. For clients with remote HTTP MCP support, connect directly to https://mcp.gobananasai.com so the client can perform OAuth login and token refresh itself. For STDIO-only clients, run gobananas auth login or gb auth login once; the proxy will use the saved OAuth tokens and refresh them automatically. If that login expires and GO_BANANAS_API_KEY is also set, the proxy continues with the key and says so; run gb auth login again to restore subscription tools. If you configure both direct HTTP and STDIO under the same name, authenticate the exact entry your client reports in its MCP status.

• Connect timeout: 30 seconds
• Request timeout: 15 minutes (covers queued generation work)
• Tool retries: disabled to prevent duplicate side effects

Related

• gobananas-cli — Interactive CLI for Go Bananas
• Go Bananas — AI image generation platform
• Documentation — Full API and tool documentation