Gency Mcp

ai.gencyPublished by gency.aiv0.7.0Updated Oct 29, 2026

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

The publisher's own server: Gency Lite

VerifiedSTDIODesktop onlyMedia & Design

Overview

AI-generated overview

Lets an assistant generate product images through the Gency AI service from a local MCP server.

What you can do
Gency Mcp is a local stdio MCP server that connects an assistant to the Gency AI product image generation service. The registry description presents it as product image generation for assistants such as Claude, Codex, Cursor and VS Code. The manifest does not list individual tools, so the exact operations are not documented here. Configuration is handled through environment variables for the Gency API base URL and OAuth settings.
When to use it
Worth considering when you want an assistant to produce product imagery through Gency without leaving your editor or chat client. It suits desktop workflows, since it runs as a local process and is marked desktop only.
Requirements
Node.js and the npm package @gency-ai/gency-mcp, run locally over stdio. Environment variables include GENCY_API_URL, GENCY_OAUTH_API_BASE, GENCY_OAUTH_CLIENT_ID, GENCY_OAUTH_SCOPE, GENCY_MCP_ALLOWED_CLIENT_IDS and GENCY_MCP_OAUTH_RESOURCE. Secrets GENCY_OAUTH_CLIENT_SECRET and GENCY_MCP_UPLOAD_SECRET are only needed for confidential OAuth clients or multi-instance HTTP serving. Network access to the Gency API is required.
Before you install
The server can ask for the secret GENCY_OAUTH_CLIENT_SECRET and, for multi-instance HTTP serving, GENCY_MCP_UPLOAD_SECRET; treat both as credentials and keep them out of shared configuration. Image generation may consume paid Gency credits, so check your plan and limits. Generated images and prompts are sent to the Gency service, a third party. No tools are listed, so review what the server can do before granting it access.

Installation

In SourceWeft

  1. Open Gency Mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

This repository has no README.

Tools

21

login

Start OAuth login (opens a browser). Captures the callback in-process and stores tokens at ~/.gency/tokens.json. gency-mcp uses OAuth only — this is the single sign-in flow.

Parametersportscopeapi_baseclient_idclient_secrettimeout_seconds

logout

Remove stored OAuth tokens (~/.gency/tokens.json). gency-mcp is OAuth-only — there is no API key state to clear.

Takes no parameters.

auth_status

Inspect current Gency OAuth state. Call this BEFORE the first gency tool in a session if unsure — output's 'Next action' line tells you whether to invoke `login` or proceed. gency-mcp authenticates with OAuth only.

Takes no parameters.

get_team

Get current team information including team name and plan

Takes no parameters.

list_workspaces

List all workspaces in the current team

Takes no parameters.

create_workspace

Create a new workspace. Confirm with the user before executing.

Parametersnamerequired

update_workspace

Rename a workspace. Confirm with the user before executing.

ParametersnamerequiredworkspaceIdrequired

list_templates

List templates for a workspace (workspace-specific + defaults TEMPLATE_01~TEMPLATE_12). Present as a picklist for the user — do NOT silently pick.

ParametersproductTypeworkspaceIdrequired

list_products

List products in a workspace.

ParametersworkspaceIdrequired

get_product

Get detailed information about a specific product.

ParametersproductIdrequired

create_product

Create AI-generated product images. **Consumes credits — confirm with the user first.** Only `category: "CLOTHING"` is accepted by the API today. Defaults to ONE product per request (all colors go in a single `colors` array; split only on explicit user request). **Do NOT guess colors/fabrics/features/laundryTips from filenames or category — ask the user.** Generation is asynchronous: poll `get_product` until status leaves CREATING. Read resource `gency://api-reference/products` for the full ProductMetadata schema (category enum, additionalInfo, sizeTables format).

ParametersproductsrequiredworkspaceIdrequired

update_product_status

Change product review status. Confirm with the user. Transitions: BEFORE_REVIEW → IN_REVIEW → REVIEW_COMPLETE.

ParametersstatusrequiredproductIdrequired

get_upload_url

Get a presigned S3 URL to upload one product image, plus the uploadHandle that `upload_image` requires. Single-use, valid 1h; uploaded images retained 24h. See `gency://api-reference/images`. Tip: for the common 6+ images case, prefer `prepare_product_images` (single call).

ParametersextensionrequiredworkspaceIdrequired

download_product_image

Render a generated product's detail page and save the resulting image locally. Requires the product to be generated (status past CREATING). Rendering is slow — allow up to 3 minutes.

ParametersproductIdrequiredoutputPathtemplateId

upload_image

PUT a local image file to the presigned S3 URL that get_upload_url issued. Pass the `uploadHandle` from that call — it carries the destination URL, so no URL is accepted here.

ParametersfilePathrequiredcontentTypeuploadHandlerequired

prepare_product_images

Upload 6+ local images for a workspace and return imageIds ready for create_product. Use this when the user gives you several image paths — it replaces 6× (get_upload_url + upload_image). Fails fast if fewer than 6 paths are supplied (Gency requires min 6 per product).

ParametersfilePathsrequiredworkspaceIdrequired

get_me

Get current authenticated user information

Takes no parameters.

list_users

List all team members

Takes no parameters.

get_user

Get information about a specific team member. The target user must belong to the same team as the caller.

ParametersuserIdrequired

get_credits

Get remaining credit balance for the team. Call this BEFORE create_product to ensure sufficient credits.

Takes no parameters.

search_docs

Search Gency API docs by keyword. Returns top 3 ranked snippets with line numbers from developers.gency.ai (cached 1h).

Parametersqueryrequired

Version history

2
  1. v0.7.0LatestOct 22, 2026
  2. v0.6.0Sep 16, 2026

Score

65% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts
  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts

    Declare a GitHub repository with a README, or serve resource_documentation in the OAuth protected-resource metadata.

  • License10 pts

    Declare a license in the repository or the registry entry.

Other Gency integrations

Gency Lite

ai.gencyOfficial publisher

Remote MCP server that lets an assistant generate Amazon-style A+ Content and AI product images from product photos.

Streamable HTTPWeb executableAuth
Business & CommerceCredential requiredOct 27, 2026