Skip to content
MCP server

Gency MCP

Gency AI product image generation - MCP server for Claude, Codex, Cursor, VS Code

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
0.7.1
Listing updated
4 days ago

About Gency MCP

Gency MCP is an open-source MCP server for design and media. It runs locally on your machine and is started by your AI client.

Install

Run in a terminal

claude mcp add gency-mcp --env GENCY_OAUTH_CLIENT_SECRET='<GENCY_OAUTH_CLIENT_SECRET>' --env GENCY_MCP_UPLOAD_SECRET='<GENCY_MCP_UPLOAD_SECRET>' -- npx -y @gency-ai/gency-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "gency-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@gency-ai/gency-mcp"
      ],
      "env": {
        "GENCY_OAUTH_CLIENT_SECRET": "<GENCY_OAUTH_CLIENT_SECRET>",
        "GENCY_MCP_UPLOAD_SECRET": "<GENCY_MCP_UPLOAD_SECRET>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "gency-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@gency-ai/gency-mcp"
      ],
      "env": {
        "GENCY_OAUTH_CLIENT_SECRET": "<GENCY_OAUTH_CLIENT_SECRET>",
        "GENCY_MCP_UPLOAD_SECRET": "<GENCY_MCP_UPLOAD_SECRET>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "gency-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@gency-ai/gency-mcp"
      ],
      "env": {
        "GENCY_OAUTH_CLIENT_SECRET": "<GENCY_OAUTH_CLIENT_SECRET>",
        "GENCY_MCP_UPLOAD_SECRET": "<GENCY_MCP_UPLOAD_SECRET>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "gency-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@gency-ai/gency-mcp"
      ],
      "env": {
        "GENCY_OAUTH_CLIENT_SECRET": "<GENCY_OAUTH_CLIENT_SECRET>",
        "GENCY_MCP_UPLOAD_SECRET": "<GENCY_MCP_UPLOAD_SECRET>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "gency-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@gency-ai/gency-mcp"
      ],
      "env": {
        "GENCY_OAUTH_CLIENT_SECRET": "<GENCY_OAUTH_CLIENT_SECRET>",
        "GENCY_MCP_UPLOAD_SECRET": "<GENCY_MCP_UPLOAD_SECRET>"
      }
    }
  }
}

Configuration

  • GENCY_API_URLGency API base URL
  • GENCY_OAUTH_CLIENT_IDOAuth client ID override. Defaults to the built-in official client, so most users never set this.
  • GENCY_OAUTH_CLIENT_SECRETOAuth client secret, only needed for confidential clients.
  • GENCY_OAUTH_API_BASEOAuth provider base URL. Defaults to GENCY_API_URL.
  • GENCY_OAUTH_SCOPESpace-separated OAuth scopes.
  • GENCY_MCP_ALLOWED_CLIENT_IDSserve-http only: OAuth client IDs whose tokens this server accepts (space or comma separated). Empty accepts any client.
  • GENCY_MCP_UPLOAD_SECRETserve-http only: HMAC key for signed upload handles. Only needed when running more than one instance, so a handle issued by one verifies on another.
  • GENCY_MCP_PREVIEW_IMAGE_HOSTSExact HTTPS regional S3 bucket hostnames allowed for inline preview images (space or comma separated). Empty returns preview metadata and URL without fetching image bytes.
  • GENCY_MCP_OAUTH_RESOURCERFC 8707 resource indicator to send on authorize/token/refresh requests. Opt-in until the Gency authorization server is confirmed to accept it.
  • GENCY_MCP_ENABLE_EDITOR_TOOLSEnable rename, saved preview and live editor tools only after deploying compatible backend APIs. Disabled by default.

Pricing

Open source

Gency MCP FAQ

Is Gency MCP free?

Yes. Gency MCP is open source, so you can use and self-host it for free.

How do I add Gency MCP to Claude Code?

Run this command in your terminal: claude mcp add gency-mcp --env GENCY_OAUTH_CLIENT_SECRET='<GENCY_OAUTH_CLIENT_SECRET>' --env GENCY_MCP_UPLOAD_SECRET='<GENCY_MCP_UPLOAD_SECRET>' -- npx -y @gency-ai/gency-mcp

What are the best alternatives to Gency MCP?

The closest alternatives to Gency MCP are HyperFrames by HeyGen, ffmpeg-skill, AvatarSay — Fictional Character & Talking Video MCP, ChartAnt and VfxSmith.

Alternatives to Gency MCP

  1. Hosted MCP connector for creating and rendering videos from HTML through AI chat

    • Remote
    • Freemium
    • 85.3K GitHub stars
    • Design and media
  2. ffmpeg-skill

    MCP server

    Local FFmpeg video and audio editing tools for coding agents over MCP

    Runs locally
    • Open source
    • 6.9K GitHub stars
    • Design and media
  3. ChartAnt

    MCP server

    Remote MCP server returning charts, maps and dashboards as hosted PNG links

    • 51 tools
    • Remote
    • Freemium
    • Design and media
  4. VfxSmith

    MCP server

    Search, generate, refine and export pixel art game effects from Claude Code or Codex

    Not checked yet
    • Remote
    • Freemium
    • Design and media
  5. CalderFlow

    MCP server

    Turn notes or specs into editable flowcharts, timelines and funnels from an AI assistant

    • 10 tools
    • Remote
    • Free
    • Design and media