Gency MCP Server

by studiolab-devai.gency/gency-mcpv0.6.0

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

Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Maintained2mo ago

Install Gency MCP server

claude mcp add gency -e GENCY_OAUTH_CLIENT_SECRET='<gency-oauth-client-secret>' -e GENCY_MCP_UPLOAD_SECRET='<gency-mcp-upload-secret>' -- npx -y @gency-ai/gency-mcp

{
  "mcpServers": {
    "gency": {
      "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 (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "gency": {
      "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>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "gency": {
      "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 .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "gency": {
      "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.

Configuration

Variable	Required	Secret	Description
GENCY_API_URL	—	—	Gency API base URL
GENCY_OAUTH_CLIENT_ID	—	—	OAuth client ID override. Defaults to the built-in official client, so most users never set this.
GENCY_OAUTH_CLIENT_SECRET	—	yes	OAuth client secret, only needed for confidential clients.
GENCY_OAUTH_API_BASE	—	—	OAuth provider base URL. Defaults to GENCY_API_URL.
GENCY_OAUTH_SCOPE	—	—	Space-separated OAuth scopes.
GENCY_MCP_ALLOWED_CLIENT_IDS	—	—	serve-http only: OAuth client IDs whose tokens this server accepts (space or comma separated). Empty accepts any client.
GENCY_MCP_UPLOAD_SECRET	—	yes	serve-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_OAUTH_RESOURCE	—	—	RFC 8707 resource indicator to send on authorize/token/refresh requests. Opt-in until the Gency authorization server is confirmed to accept it.

Freshness

Maintained — last maintenance signal 2mo ago. The newest of the signals below sets the band.

Last commit (default branch)
no data · GitHub
Latest release
no data · GitHub
Package published
no data · npm/PyPI
Registry entry updated
2026-07-30 · 2mo ago · official registry · v0.6.0

FAQ

›How do I install the Gency MCP server in Claude Code?

Run: claude mcp add gency -e GENCY_OAUTH_CLIENT_SECRET='<gency-oauth-client-secret>' -e GENCY_MCP_UPLOAD_SECRET='<gency-mcp-upload-secret>' -- npx -y @gency-ai/gency-mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Gency require an API key?

Yes. It expects GENCY_OAUTH_CLIENT_SECRET, GENCY_MCP_UPLOAD_SECRET, of which 2 are secrets.

›Can I use Gency as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is Gency in the official MCP registry?

Yes, as ai.gency/gency-mcp.