ai.gency/gency-mcp
NPM · @GENCY-AI/GENCY-MCP · SCANNED AUG 3
Gency AI product image generation - MCP server for Claude, Codex, Cursor, VS Code
Available components
How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score →
Supply Chain Security83
- No malware found by supply-chain analysis.Pass
- CVE check failed: a known medium-severity CVE affects @hono/node-server 1.19.17, reached via @modelcontextprotocol/node > @hono/node-server. A fixed version is available. View diagnostics → Fail
- No install/post-install scripts declared.Pass
- Only part of the dependency tree could be resolved (76 of 77), so this covers what we could see, not the whole tree. View diagnostics → Partial
Provenance & Transparency19
- Repository check failed: the declared repository URL returned HTTP 404. See how to fix → View diagnostics → Fail
- Provenance check failed: no build-provenance attestation is published. See how to fix → View diagnostics → Fail
- Clear OSI-approved license (MIT).Pass
- Actively maintained (last published 4 days ago).Pass
- Security-disclosure policy not yet verified: we couldn't inspect the source repository.Unverified
Schema Quality & AI Usability54
- 14% of prompts and resources have a non-trivial description (not blank, and not just the item's name).Partial
- AI-judged instruction clarity (excellent).Pass
- Tool/resource definitions use about 1344 tokens (~49/item across 27 items; 21 tools + 6 resources), lean.Pass
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management0
- Stability not yet verified: not enough scan history yet (needs a 30-day window).Unverified
Tool Coverage100
- 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
- 100% of tool parameters carry a description.Pass
Capabilities100
- Implements a current MCP spec version (2026-07-28).Pass
Unverified: 1 category
A category scored 0 because we could not verify it: a data source with nothing on this package, evidence we could not reach, or a check we could not run. We only credit what we can confirm.
Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.
npm · @gency-ai/gency-mcp
claude mcp add ai-gency-gency-mcp -- npx -y @gency-ai/gency-mcp
codex mcp add ai-gency-gency-mcp -- npx -y @gency-ai/gency-mcp
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"ai-gency-gency-mcp": {
"type": "local",
"command": [
"npx",
"-y",
"@gency-ai/gency-mcp"
],
"enabled": true
}
}
} openclaw mcp add ai-gency-gency-mcp --command npx --arg -y --arg @gency-ai/gency-mcp
mcp_servers:
ai-gency-gency-mcp:
command: "npx"
args: ["-y", "@gency-ai/gency-mcp"] {
"mcpServers": {
"ai-gency-gency-mcp": {
"command": "npx",
"args": [
"-y",
"@gency-ai/gency-mcp"
]
}
}
} Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 2 Aug 26 +33
- GHSA-frvp-7c67-39w9 affects this package: medium ▼ security
- Known CVEs: unverified → fail ▼ security
- Malware scan: unverified → pass ▲ security
- Stability: Stability not yet verified: not enough scan history yet (needs a 30-day window). security
- Schema quality: unverified → excellent ▲ functional
- MCP protocol: unverified → pass ▲ functional
- Dependency health: unverified → partial ▲ functional
- 1 Aug 26 +22
- Provenance: unverified → fail ▼ security
- Install scripts: unverified → pass ▲ security
- Tool coverage: unverified → 100 ▲ functional
- License: unverified → pass ▲ functional
- Maintenance: unverified → pass ▲ functional
- Schema quality: unverified → 14 ▲ functional
- First check of Schema quality: pass functional
- First check of Tool coverage: 100 functional
- First check of Schema quality: unverified functional
- First check of Schema quality: fail functional
- Licence: MIT functional
- 31 Jul 26 0
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
- 30 Jul 26 0
- Package version: 0.4.1 → 0.6.0 functional
- 29 Jul 26 0
First indexed and scored.
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 3 Aug 2026 · Analysed npm/@gency-ai/[email protected]
Provenance none
Ecosystem: npm · Outcome: none
Vulnerabilities 1 finding
| ID | CVE | Severity | Vector | Fix available |
|---|---|---|---|---|
| GHSA-frvp-7c67-39w9 | medium | CVSS:3.1/AV:N/AC:H/PR:N/UI:N/S:U/C:H/I:N/A:N | yes |
Dependencies 76 packages
76 packages in the resolved dependency tree · 75 deprecated · 22 stale.
The dependency tree was only partially resolved, so these counts may be incomplete.
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability.
auth_status ~57
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.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
create_product ~152
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).
| Name | Type | Req | Description |
|---|---|---|---|
| products | array | yes | Array of product metadata |
| workspaceId | string | yes | Target workspace ID |
No output schema declared.
No examples provided.
create_workspace ~29
Create a new workspace. Confirm with the user before executing.
| Name | Type | Req | Description |
|---|---|---|---|
| name | string | yes | Workspace name |
No output schema declared.
No examples provided.
download_product_image ~97
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.
| Name | Type | Req | Description |
|---|---|---|---|
| outputPath | string | — | Absolute path to write the image to. Defaults to a file in the OS temp directory. |
| productId | string | yes | Product ID |
| templateId | string | — | Template ID to render with (optional) |
No output schema declared.
No examples provided.
get_credits ~27
Get remaining credit balance for the team. Call this BEFORE create_product to ensure sufficient credits.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
get_me ~14
Get current authenticated user information
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
get_product ~26
Get detailed information about a specific product.
| Name | Type | Req | Description |
|---|---|---|---|
| productId | string | yes | Product ID |
No output schema declared.
No examples provided.
get_team ~18
Get current team information including team name and plan
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
get_upload_url ~109
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).
| Name | Type | Req | Description |
|---|---|---|---|
| extension | string | yes | File extension (lowercase, no dot). Must match the PUT Content-Type. |
| workspaceId | string | yes | Workspace ID |
No output schema declared.
No examples provided.
get_user ~40
Get information about a specific team member. The target user must belong to the same team as the caller.
| Name | Type | Req | Description |
|---|---|---|---|
| userId | string | yes | Target user ID |
No output schema declared.
No examples provided.
list_products ~24
List products in a workspace.
| Name | Type | Req | Description |
|---|---|---|---|
| workspaceId | string | yes | Workspace ID |
No output schema declared.
No examples provided.
list_templates ~67
List templates for a workspace (workspace-specific + defaults TEMPLATE_01~TEMPLATE_12). Present as a picklist for the user — do NOT silently pick.
| Name | Type | Req | Description |
|---|---|---|---|
| productType | string | — | Product type filter (default: FASHION) |
| workspaceId | string | yes | Workspace ID |
No output schema declared.
No examples provided.
list_users ~13
List all team members
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
list_workspaces ~18
List all workspaces in the current team
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
login ~201
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.
| Name | Type | Req | Description |
|---|---|---|---|
| api_base | string | — | OAuth provider base URL. Defaults to GENCY_OAUTH_API_BASE/GENCY_API_URL. |
| client_id | string | — | OAuth client_id. Defaults to GENCY_OAUTH_CLIENT_ID env. |
| client_secret | string | — | OAuth client_secret (only required for confidential clients). Defaults to GENCY_OAUTH_CLIENT_SECRET env. |
| port | integer | — | Fixed loopback port. Default: 53682 (must be whitelisted in the OAuth client's redirect URIs as http://localhost:53682/callback). |
| scope | string | — | Space-separated scopes. Defaults to product:read product:write team:read team:write user:read. |
| timeout_seconds | integer | — | Login timeout. Default: 300. |
No output schema declared.
No examples provided.
logout ~35
Remove stored OAuth tokens (~/.gency/tokens.json). gency-mcp is OAuth-only — there is no API key state to clear.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
prepare_product_images ~111
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).
| Name | Type | Req | Description |
|---|---|---|---|
| filePaths | array | yes | Absolute paths to local image files (6-50). Order is preserved; the first becomes the primary thumbnail. |
| workspaceId | string | yes | Workspace ID |
No output schema declared.
No examples provided.
search_docs ~56
Search Gency API docs by keyword. Returns top 3 ranked snippets with line numbers from developers.gency.ai (cached 1h).
| Name | Type | Req | Description |
|---|---|---|---|
| query | string | yes | Search keywords (space-separated, e.g., 'webhook signature') |
No output schema declared.
No examples provided.
update_product_status ~52
Change product review status. Confirm with the user. Transitions: BEFORE_REVIEW → IN_REVIEW → REVIEW_COMPLETE.
| Name | Type | Req | Description |
|---|---|---|---|
| productId | string | yes | Product ID |
| status | string | yes | New status |
No output schema declared.
No examples provided.
update_workspace ~41
Rename a workspace. Confirm with the user before executing.
| Name | Type | Req | Description |
|---|---|---|---|
| name | string | yes | New workspace name |
| workspaceId | string | yes | Workspace ID to update |
No output schema declared.
No examples provided.
upload_image ~119
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.
| Name | Type | Req | Description |
|---|---|---|---|
| contentType | string | — | MIME type (auto-detected from file contents if omitted) |
| filePath | string | yes | Absolute path to the local image file |
| uploadHandle | string | yes | The uploadHandle returned by get_upload_url. Single-use, valid 1h, and only redeemable by the caller it was issued to. |
No output schema declared.
No examples provided.