Developer reference
Genpire MCP server reference
Genpire's MCP server lets an AI assistant work in a person's own Genpire account: look up products, design them, make documents, colours, print files and Studio images (factory quote requests are coming soon). This page describes the server for developers and reviewers. For how people connect and use it, see Genpire in ChatGPT and Claude.
https://mcp.genpire.com/mcp| Item | Value |
|---|---|
| MCP endpoint | https://mcp.genpire.com/mcp |
| Transport | Streamable HTTP, stateless, POST only |
| Authorization server | https://mcp.genpire.com (OAuth 2.1) |
| Scopes | genpire.read, genpire.design, genpire.quote (+ offline_access for refresh) |
| Server info | name: "genpire", title: "Genpire", version: "1.0.0" |
| Tools defined | 26 (21 available, 5 coming soon); each caller sees the subset for its host |
| UI | One MCP Apps resource: ui://genpire/product-v1.html (the Genpire card) |
| Supported hosts | ChatGPT; Claude (claude.ai, Desktop, mobile); Claude Code |
| Support | support@genpire.com |
- URL:
https://mcp.genpire.com/mcp. - Method:
POSTwith a JSON-RPC body (at most 1 MB).GET,DELETEand other methods answer405withAllow: POSTand a JSON-RPC error (-32000, "Method not allowed."). There is no SSE stream to open and no session to keep. - Stateless: every request is handled by a fresh server built from the caller's access token. Each request must carry the bearer token.
- Protocol revisions: the 2026-07-28 revision (its per-request
_metaenvelope, including the client's capabilities, is read on every call) and the earlier 2025 revisions in stateless mode. - Host and Origin: the
Hostheader must bemcp.genpire.com. A request that carries anOriginheader must come from the server's own origin; anything else answers403("Forbidden host" / "Forbidden origin"). Hosts call the server from their own servers, without anOrigin. - Cache hints (2026-07-28):
tools/list,server/discover,resources/listandresources/readcarry a private 5-minute cache hint: each answer depends on the person and the host. - Server instructions: each caller gets plain instructions (≤ 1024 characters) that name exactly the model-visible tools it is given, grouped by scope. Example, for Claude (claude.ai) in production:
Genpire is a product design studio. These tools work in the signed-in person's own Genpire account. To look things up: list_my_products, get_product, get_job, get_usage, list_my_brands. To design: create_product, edit_product, redraw_product, show_options, use_option, apply_brand, make_tech_documents, suggest_colours, make_colour_previews, write_description, explore_ideas, make_moodboard, match_pantone, make_print_files, make_studio_images. For a quote from Genpire's factory network: prepare_quote_request. The person confirms and sends it in Genpire. Refer to products, jobs, ideas and brand styles by the handles the tools return; longer work returns a job to check later. Plan usage is shown only as the percentage left, never as amounts or prices. An address or phone number is never asked for in chat. Anything designed here is called a "product". Built and powered by Genpire.
On ChatGPT the last-but-one sentence reads "…sends it in the Genpire card." The app-only send_quote_request is never named.
Genpire works out the host from the token's client, never from anything the client sends:
| Host | How Genpire knows | Profile | Results shown as | Waits up to (default) | Quote send |
|---|---|---|---|---|---|
| ChatGPT | ChatGPT's CIMD (or a ChatGPT redirect) | chatgpt | The Genpire card | 40 seconds | In the card |
| Claude (claude.ai, Desktop, mobile) | Claude's CIMD (or Claude's redirect) | claude | The Genpire card | 150 seconds | From the product in Genpire |
| Claude Code | Claude Code's CIMD | claude | Links | 150 seconds | From the product in Genpire |
| Other MCP clients (test server only, such as MCP Inspector) | A local (loopback) redirect, accepted only on Genpire's test server | other | Card if the request declares MCP Apps UI, else links | 40 seconds | From the product in Genpire |
- The
claudeprofile is Genpire's design profile. It has no product photos (make_photos) and no tool that uses the person's own image (use_image);match_pantoneandmake_print_fileshave no image input; Studio images offer 32 of 35 styles (no Lifestyle, Campaign creative or UGC lifestyle) and nonotes; product videos (coming soon) offer 11 of 15 styles and nonotes. The narrowed schemas are what Claude sees intools/list; a call outside them is refused again by Genpire. - Quote sending is listed only where the person confirms in the card: ChatGPT. Claude's hosted apps get it only if Genpire turns on in-card confirmation for Claude (off today). Claude Code and other clients never get it: there
prepare_quote_requestshows the quote details, and the person requests the quote from the product in Genpire. - Other MCP clients can't connect to the production server: it accepts sign-in only from ChatGPT, Claude and Claude Code.
- Waiting: a tool waits for the work up to the host's window. Longer work answers with a job (§5).
How many tools each host lists in production:
| Host | Listed today | Available today | With every tool on |
|---|---|---|---|
| ChatGPT | 24 (23 the model can call + send_quote_request, app-only) | 21 | 26 |
| Claude (claude.ai, Desktop, mobile) | 21 | 20 | 23 |
| Claude Code | 21 | 20 | 23 |
Listed but not available yet: use_image on ChatGPT (attached images are not switched on, so it answers that they aren't available yet; the image input of match_pantone and make_print_files too) and the quote tools (prepare_quote_request, and send_quote_request on ChatGPT), which answer unavailable until they are switched on. The tools table in §6 marks them "Coming soon".
The model never sees a Genpire id. Every object is referred to by a sealed handle: an encrypted, opaque string bound to the person and to its kind. A handle opens only for the person it was made for and only as its own kind.
| Prefix | What it refers to | Made by | Used by |
|---|---|---|---|
p_ | A product | Every product result, list_my_products | Every tool's product input |
j_ | A background job | Any tool whose work outlasts the wait | get_job |
b_ | A personal brand style (Brand DNA) | list_my_brands | create_product.brand, apply_brand.brand |
k_ | A colour idea | suggest_colours | make_colour_previews.colour |
c_ | A product-list cursor | list_my_products.nextCursor | list_my_products.cursor |
d_ | A product idea | explore_ideas | create_product.idea |
u_ | An image the person attached | Genpire, when it stores a ChatGPT attachment | Set by the server; clients send image instead |
Rules:
- Opaque. Never parse, build, shorten or change a handle. Pass it back exactly as received.
- Person-bound. A handle from one person's results is useless in another person's call (
not_found). - Shape: the prefix, then 40–400 base64url characters (
c_: up to 600;d_: up to 980). Two handles for the same object can differ. - Can go stale. A colour idea or a product idea can stop being current ("That colour idea isn't current. Use suggest_colours first." / "That idea isn't current. Use explore_ideas again.").
| Link | What it does |
|---|---|
https://mcp.genpire.com/o/p_… | "Open in Genpire" for a product (openUrl). A small page posts the handle to the Genpire app, which signs the person in and opens the product only for its owner. The handle never goes into a URL query |
https://mcp.genpire.com/i/i_… | Links mode only: an image, file or video on Genpire storage. Redirects to the file; works for 7 days |
https://www.genpire.com/pricing | Genpire's plans page (usage.plansUrl). Informational; nothing is sold in the chat |
No other URL ever appears in model data.
Success:
content[0]— a short English summary (≤ 1500 characters).- On Claude (claude.ai, Desktop, mobile),
content[1]repeatsstructuredContentas JSON text, because that host gives the model onlycontent. - In links mode, one
resource_linkper image, file and video (https://mcp.genpire.com/i/i_…, withnamesuch asimage-1/file-1/video-1and itsmimeType). structuredContent— the tool's output (§6), validated against theoutputSchemathe caller was given._meta["genpire/widget"]— the card's data (§8), on card hosts only._meta["openai/widgetSessionId"]— echoed from the request, so ChatGPT updates the same card.
Error: isError: true, content[0] = the error sentence, _meta["genpire/error"] = { "error": { "code", "message" }, "product"?, "job"?, "usage"? }. There is no structuredContent on an error. See §7.
What model data never carries: a raw id, any URL other than the three in §4.2, a #RRGGBB colour value, a token, an e-mail, an address or a phone number, or any amount of credits. Genpire checks every result for these before it leaves; a result that fails the check answers failed instead.
ProductCard — product (p_), name (≤ 120 or null), stage (design · views · specs · tech_pack), brandName (≤ 60 or null), canEdit (false for team products), openUrl (the /o/ link or null).
ImageRef — n (1–12, matches the card's image n), kind (view · option · colour · photo · tech_file · upload), view (front · back · side · top · bottom or null), caption (≤ 60).
DocCard — docType (size_guide · specs · tech_pack), title (≤ 120), lines (≤ 6 lines of ≤ 120), status (ready · failed).
JobCard — job (j_), product (p_), label (≤ 120), state (running · done · failed), partial (boolean: some results are ready), pollAfterSeconds (3–60).
Usage — percentLeft (0–100), tone (default · warning · danger), plansUrl (the plans page or null).
NextStep — tool (a tool name), label (≤ 60). Suggestions only; a next step only ever names one of the original 19 tools.
ChoiceNeed — a question Genpire needs answered: field (≤ 40), question (≤ 200), options (≤ 12 labels of ≤ 60).
ProductResult (most design tools) — product (ProductCard), images (≤ 12 ImageRef), documents? (≤ 3 DocCard), job? (JobCard), options? (≤ 3 { n }), needs? (≤ 8 ChoiceNeed), usage? (Usage; absent if the usage read failed), nextSteps (≤ 10 NextStep).
- A tool waits for the work up to the host's window (§3). If the work is still running, the result carries a
job(JobCard) withstate: "running", and the work keeps going in Genpire. - Call
get_jobwith thej_handle afterpollAfterSecondsto read its state and its finished images, documents and usage. - The Genpire card polls
get_jobby itself every 5 seconds, for up to 120 polls (10 minutes). A new tool result restarts the budget. get_jobhas its own rate-limit bucket (§9), so polling never uses up the bucket of the other tools.get_jobonly opens jobs started from the same assistant (ChatGPT, or Claude).get_productshowsbusyElsewhere: truewhen the product is busy with work started anywhere else, such as the Genpire editor.- The finished result is always saved in the person's Genpire account, even if no one polls.
Legend. Hints are the MCP annotations, set as explicit booleans on every tool: RO = readOnlyHint, DX = destructiveHint, ID = idempotentHint, OW = openWorldHint. "Card" = the tool renders the Genpire card (_meta.ui.resourceUri). Strings are trimmed; lengths are in characters. Every input object is strict: unknown keys are refused. product is always a p_ handle.
Status: "Available" = listed and working in production; "Coming soon" = not working in production yet, even where a host already lists it (§3).
26 tools: 21 available, 5 coming soon. Status in production on 2026-11-18. Each host lists only its own subset; always read tools/list.
| Tool | What it does | Scope | Hosts | Status |
|---|---|---|---|---|
list_my_productsList my products | Lists the person's Genpire products, newest first: their own products, which they can change, and their team's products, which are read-only here. | genpire.read |
| Available |
get_productGet a product | Shows one Genpire product as it is now: its views, documents, options, any work still running and how much of the person's plan is left. | genpire.read |
| Available |
get_jobGet job status | Shows the status and results of background work on a Genpire product, such as views being drawn or a tech pack being prepared. | genpire.read |
| Available |
get_usageGet usage left | Shows how much of the person's Genpire plan is left to use, as a percentage. | genpire.read |
| Available |
list_my_brandsList my brand styles | Lists the person's personal brand styles (Brand DNA) in Genpire and which one is active. | genpire.read |
| Available |
create_productCreate a product | Creates a new product design from the person's description or from an idea that explore_ideas returned, and draws its first sheet (front, back and side views). | genpire.design |
| Available |
edit_productEdit a product | Changes a product's design as described, for the whole product or one of its views. | genpire.design |
| Available |
redraw_productRedraw a product | Draws a product again, or redraws one of its views. | genpire.design |
| Available |
show_optionsShow 3 options | Draws three alternative looks for a product from three short descriptions, for the person to choose from. | genpire.design |
| Available |
use_optionUse an option | Keeps option 1, 2 or 3 of a product's alternative looks as its design and draws its full sheet. | genpire.design |
| Available |
apply_brandApply a brand style | Restyles a product in one of the person's Genpire brand styles, or in their active one. | genpire.design |
| Available |
make_tech_documentsMake tech documents | Makes a product's technical documents: the technical details (size guide and specs), one of them, or the full tech pack. | genpire.design |
| Available |
suggest_coloursSuggest colours | Suggests numbered colour ideas for a product, with a swatch of each in the Genpire card. | genpire.design |
| Available |
make_colour_previewsPreview colours | Shows one of the suggested colour ideas on the product, or all of them. | genpire.design |
| Available |
use_imageUse my image | Uses the person's image on a product as a logo, patch, print, fabric, wash, component or reference, or starts a new product from it. | genpire.design |
| Coming soon |
write_descriptionWrite a description | Writes a sales description of a product in Genpire. | genpire.design |
| Available |
make_photosMake product photos | Makes studio photos of a product on a white background, in a real-life scene, on a model or as a campaign set in one scene and mood. | genpire.design |
| Available |
explore_ideasExplore product ideas | Suggests two to four ready-to-make product ideas, either new products or variations of one of the person's products, each with an idea handle that create_product can make. | genpire.design |
| Available |
make_moodboardMake a moodboard | Builds a moodboard of inspiration pictures found on the web for a look, theme or product and saves it to the person's Genpire moodboards. | genpire.design |
| Available |
match_pantoneMatch Pantone colours | Finds the nearest Pantone fabric (TCX) and print (Solid Coated) codes for HEX colour codes, for a product's own colours or, in ChatGPT, for an attached image. | genpire.design |
| Available |
make_print_filesMake print files | Makes factory files for clothing, shoes and hats: a print file, a seamless repeat pattern, an embroidery file with thread colours, or vector files of a product's artwork or, in ChatGPT, an attached image. | genpire.design |
| Available |
make_studio_imagesMake Studio images | Makes images of a product in one of Genpire Studio's styles for creative shots, ads, social posts, prints, logos and retail displays. | genpire.design |
| Available |
make_product_videoMake a product video | Starts a short video of a product in one of Genpire Studio's video styles; the video is made in the background. | genpire.design |
| Coming soon |
make_3d_modelMake a 3D model | Starts a 3D model of a product from its views; it is made in the background and saved with the product in Genpire. | genpire.design |
| Coming soon |
prepare_quote_requestPrepare a quote request | Prepares a request for a quote from Genpire's factory network (a sample of 1 to 3 or a bulk order of 4 or more) for the person to confirm. | genpire.quote |
| Coming soon |
send_quote_requestSend the quote request | Sends the quote request the person confirmed in the Genpire card to Genpire's factory network. Only the card's button can call it. | genpire.quote |
| Coming soon |
Every read tool: RO true · DX false · ID true · OW false. Reads change nothing in the person's account.
Lists the person's Genpire products, newest first: their own products, which they can change, and their team's products, which are read-only here.
Card: yes. Needs a product: no.
| Input | Type | Required | Rules |
|---|---|---|---|
cursor | c_ handle | no | The nextCursor of the previous page |
limit | integer | no | 1–20 |
Output: products — up to 20 rows of { product, name (≤ 120 or null), stage, canEdit, teamName (≤ 120 or null), openUrl }; nextCursor — a c_ handle or null. Thumbnails go to the card only. No dates.
Shows one Genpire product as it is now: its views, documents, options, any work still running and how much of the person's plan is left.
Card: yes.
| Input | Type | Required |
|---|---|---|
product | p_ handle | yes |
Output: product (ProductCard), images (≤ 12 ImageRef), documents { sizeGuide, specs, techPack } (booleans), job? (running work started from this assistant), busyElsewhere? (work started anywhere else), options? (≤ 3 { n }), usage?.
Shows the status and results of background work on a Genpire product, such as views being drawn or a tech pack being prepared.
Card: yes. Own rate-limit bucket.
| Input | Type | Required |
|---|---|---|
job | j_ handle | yes |
Output: job (JobCard), images? (≤ 12 ImageRef), documents? (≤ 3 DocCard), usage?.
When a host is offered make_product_video or make_3d_model (coming soon), the output schema also allows: video? { n: 1, caption (≤ 60) }, model3d? { formats: ("glb" | "usdz")[], missing: ("glb" | "usdz")[] } and progress? (0–100). Until then, get_job's schema is exactly the one above. Reading a 3D job may refresh that one 3D record in Genpire (as Genpire's own 3D page does); the person sees no change, so RO stays true.
Shows how much of the person's Genpire plan is left to use, as a percentage.
Card: no. Input: none ({}).
Output: usage (Usage): percentLeft, tone, plansUrl. Never an amount, a balance or a price.
Lists the person's personal brand styles (Brand DNA) in Genpire and which one is active.
Card: no. Input: none ({}).
Output: brands — up to 50 rows of { brand (b_), name (≤ 120), active, hasLogo }.
Every design tool: RO false · ID false · OW false, unless the tool says otherwise. Each saves what it makes in the person's account or starts background work, and each call makes new work. Every design tool:
- screens the person's words against Genpire's rules and the person's saved "don't" rules (the rule text never leaves Genpire);
- uses part of the person's Genpire plan usage where the same action does in Genpire (the description says so);
- counts toward the design-action rate limit and the person's daily limit (§9).
Create a new product design in the person's Genpire account from their description or from an idea that explore_ideas returned, and draw its first sheet (front, back and side views). Uses part of the person's Genpire plan usage.
DX false. Card: yes. Needs a product: no. ChatGPT progress text: "Drawing your product…" → "Product ready".
| Input | Type | Required | Rules |
|---|---|---|---|
brief | string | one of | 3–2000. The person's description |
idea | d_ handle | one of | An idea from explore_ideas |
name | string | no | 1–120. Not with idea |
brand | b_ handle | no | A brand style to design in. Not with idea |
Give exactly one of brief or idea. An idea is made as it is. Output: ProductResult for the new product.
Changes a product's design as described, for the whole product or one of its views. Uses part of the person's Genpire plan usage.
DX false (earlier revisions stay in the product's history). Card: yes. ChatGPT progress text: "Updating the design…" → "Design updated".
| Input | Type | Required | Rules |
|---|---|---|---|
product | p_ handle | yes | |
change | string | yes | 1–500 |
view | enum | no | front · back · side |
Output: ProductResult (a new design revision).
Draws a product again, or redraws one of its views. Uses part of the person's Genpire plan usage.
DX false. Card: yes.
| Input | Type | Required | Rules |
|---|---|---|---|
product | p_ handle | yes | |
view | enum | no | front · back · side — redraw that view |
drawAgain | boolean | no | Draw the same design again |
prompt | string | no | 1–2000. The full description to draw the view from |
With neither view nor drawAgain, Genpire picks what is missing (for example, the back and side after a lone front). Output: ProductResult.
Draws three alternative looks for a product from three short descriptions, for the person to choose from. Uses part of the person's Genpire plan usage.
DX false (the product itself is unchanged until use_option). Card: yes (with a "Use option n" button).
| Input | Type | Required | Rules |
|---|---|---|---|
product | p_ handle | yes | |
variants | array of string | yes | Exactly 3, each 10–600 |
Output: ProductResult with options [{ n: 1 }, { n: 2 }, { n: 3 }] and the option images (kind: "option").
Keeps option 1, 2 or 3 of a product's alternative looks as its design and draws its full sheet. Uses part of the person's Genpire plan usage.
DX false (earlier revisions stay). Card: yes.
| Input | Type | Required | Rules |
|---|---|---|---|
product | p_ handle | yes | |
option | integer | yes | 1–3 |
Output: ProductResult. Options that are no longer current answer stale.
Restyles a product in one of the person's Genpire brand styles, or in their active one. Uses part of the person's Genpire plan usage.
DX false. Card: yes.
| Input | Type | Required | Rules |
|---|---|---|---|
product | p_ handle | yes | |
brand | b_ handle | no | Absent = the person's active brand style |
Output: ProductResult (a new revision).
Makes a product's technical documents in Genpire: the technical details (size guide and specs), one of them, or the full tech pack. The tech pack uses part of the person's Genpire plan usage.
DX true: redo replaces the existing technical details or tech pack. Card: yes. ChatGPT progress text: "Preparing technical documents…".
| Input | Type | Required | Rules |
|---|---|---|---|
product | p_ handle | yes | |
kind | enum | yes | technical_details (size guide + specs) · size_guide · specs · tech_pack |
redo | boolean | no | Only with technical_details or tech_pack |
Output: ProductResult with documents (DocCard). The tech pack usually runs as a job.
Writes a sales description of a product in Genpire.
DX false. Card: yes.
| Input | Type | Required | Rules |
|---|---|---|---|
product | p_ handle | yes | |
redo | boolean | no | Write it again |
Output: product (ProductCard), description (≤ 2000).
Suggests two to four ready-to-make product ideas from Genpire's ideation, either new products or variations of one of the person's products, each with an idea handle that create_product can make.
DX false. Card: yes (each idea has a "Make this one" button). Needs a product: optional. ChatGPT progress text: "Exploring ideas…" → "Ideas ready".
| Input | Type | Required | Rules |
|---|---|---|---|
product | p_ handle | no | Given = variations of this product |
focus | string | no | 1–300 |
category, audience, season, material, tier | string | no | 1–60 each |
range | enum | no | focused (2 ideas) · balanced (3, the default) · wide (4) |
more | boolean | no | More ideas like the last ones |
Output: product?, ideas — 1–4 rows of { n, name (≤ 80), summary (≤ 200), idea (d_) }, usage?, nextSteps. Pass an idea to create_product to make it.
Suggests numbered colour ideas for a product, with a swatch of each in the Genpire card.
DX false. Card: yes.
| Input | Type | Required | Rules |
|---|---|---|---|
product | p_ handle | yes | |
style | string | no | 1–60, e.g. "earthy" |
Output: product (ProductCard), colours — up to 6 rows of { n, name (≤ 60), colour (k_) }. The colour values go to the card only.
Shows one of the suggested colour ideas on the product, or all of them.
DX false. Card: yes.
| Input | Type | Required | Rules |
|---|---|---|---|
product | p_ handle | yes | |
colour | k_ handle | one of | One colour idea from suggest_colours |
all | true | one of | Preview every suggested colour |
Give exactly one of colour or all. Output: ProductResult with colour previews (kind: "colour").
ChatGPT / other clients: Finds the nearest Pantone fabric (TCX) and print (Solid Coated) codes for HEX colour codes, for an attached image or for a product's own colours.
Claude: Finds the nearest Pantone fabric (TCX) and print (Solid Coated) codes for HEX colour codes or for a product's own colours.
DX false. Card: yes. Needs a product: optional. ChatGPT progress text: "Matching Pantone colours…". The attached-image input (ChatGPT) is coming soon: see use_image.
| Input | Type | Required | Hosts | Rules |
|---|---|---|---|---|
product | p_ handle | no | all | Its saved colours |
colours | array of string | no | all | 1–8 HEX codes, #RRGGBB or RRGGBB |
image | ChatGPT file object | no | ChatGPT | See use_image |
upload | u_ handle | no | ChatGPT, other | Set by the server |
ChatGPT / other: at most one of colours, image, upload, and at least one of them or product. Claude: colours or product.
Output: product?, source (colours · image · product), swatches — 1–8 rows of { n, name (≤ 60), share (0–100 or null), tcx, coated, approximate }, nextSteps. The colour values themselves go to the card only.
Builds a moodboard of inspiration pictures found on the web for a look, theme or product and saves it to the person's Genpire moodboards.
DX false · OW true (it searches the public web for inspiration pictures; nothing is posted or sent anywhere). Card: yes. Needs a product: optional. ChatGPT progress text: "Building a moodboard…" → "Moodboard saved".
| Input | Type | Required | Rules |
|---|---|---|---|
product | p_ handle | no | |
direction | string | no | 1–300 |
Give direction, product or both. Output: product?, board { name (≤ 80 or null), pictures (0–8, the pictures linked in the card), saved }, usage?, nextSteps. The picture links (third-party pages) and a link to Genpire's moodboards go to the card only; they are never shown as images and never become links in links mode.
Uses the person's image on a product as a logo, patch, print, fabric, wash, component or reference, or starts a new product from it. Uses part of the person's Genpire plan usage.
Hosts: ChatGPT (and other clients' schemas; only ChatGPT can send a file). DX false. Card: yes. ChatGPT: _meta["openai/fileParams"] = ["image"].
Coming soon: ChatGPT already lists use_image, but attached images are not switched on in production yet. Until they are, every call answers unavailable ("Using attached images isn't available yet. Upload the image in Genpire instead."). The same applies to the attached-image input of match_pantone and make_print_files.
| Input | Type | Required | Rules |
|---|---|---|---|
product | p_ handle | unless use is new_product | |
image | ChatGPT file object | one of | { download_url (https), file_id (1–200), mime_type? (1–100), file_name? (1–255) } |
upload | u_ handle | one of | Set by the server after it stores image |
use | enum | yes | logo · patch · print · fabric · wash · component · reference · new_product |
fields | object | no | Up to 8 of position, size, coverage, scale, attachMethod, action, target, view, wash (each 1–60) |
instructions | string | no | 1–500 |
match | enum | no | inspired · exact |
The image is downloaded only from OpenAI's file hosts (https, no redirects off those hosts, 15 seconds), must be PNG, JPEG or WebP (checked from its bytes) and at most 10 MB, then is checked, moderated and stored privately in the person's Genpire account. Its preview goes to the card only.
Output: ProductResult (product, images and nextSteps may be absent while a new product is not made yet; then needs holds Genpire's questions).
ChatGPT / other clients: Makes factory files in Genpire for clothing, shoes and hats: a product's print file, a seamless repeat pattern, an embroidery file with thread colours, or vector files of a product's artwork or an attached image.
Claude: Makes factory files in Genpire for clothing, shoes and hats: a product's print file, a seamless repeat pattern, an embroidery file with thread colours, or vector files of a product's artwork.
DX false (older print files stay as earlier versions). Card: yes. ChatGPT progress text: "Making print files…". The attached-image input (ChatGPT) is coming soon: see use_image.
| Input | Type | Required | Hosts | Rules |
|---|---|---|---|---|
product | p_ handle | yes, except a vector from an image (ChatGPT) | all | |
mode | enum | yes | all | print_file · pattern · embroidery · vector |
placement | enum | no | all | placed · all_over; only with print_file |
image | ChatGPT file object | no | ChatGPT | Only with embroidery or vector |
upload | u_ handle | no | ChatGPT, other | Set by the server; one image at most |
Output: product?, made (the mode), images (ImageRef), files — up to 12 rows of { n, format } with format one of svg · eps · pdf · tiff · png, missingFormats (formats not made; may include ai), threads? (up to 12 { name, pantone (or null) } for embroidery), job?, usage?, nextSteps. Genpire never ships an .ai file. Download buttons are in the card; in links mode, each file is a resource_link.
Makes studio photos of a product on a white background, in a real-life scene, on a model or as a campaign set in one scene and mood. Uses part of the person's Genpire plan usage.
Hosts: ChatGPT and other clients; not Claude. DX false. Card: yes.
| Input | Type | Required | Rules |
|---|---|---|---|
product | p_ handle | yes | |
style | enum | yes | white_background · lifestyle · on_model · campaign |
count | integer | no | 1–3 (a campaign makes 3 unless count is given) |
look | enum | no | street · studio · nature · home; only with campaign |
scene | string | no | 1–200; only with campaign |
A campaign with neither look nor scene answers a needs question (the card shows the four looks). Campaigns need a paid Genpire plan. Output: ProductResult with kind: "photo" images.
Makes images of a product in one of Genpire Studio's styles for creative shots, ads, social posts, prints, logos and retail displays. Uses part of the person's Genpire plan usage.
DX false (Studio only adds images). Card: yes. ChatGPT progress text: "Making Studio images…". Also counts toward the media rate limit (§9). Needs a paid Genpire plan and the product's front view.
| Input | Type | Required | Hosts | Rules |
|---|---|---|---|---|
product | p_ handle | yes | all | |
style | enum | yes | all | One of the styles below (Claude: 32) |
count | integer | no | all | 1–3 (default 1) |
aspectRatio | enum | no | all | 1:1 · 2:3 · 3:2 · 3:4 · 4:3 · 9:16 · 16:9 · 21:9 (default: the style's own) |
notes | string | no | ChatGPT, other | 1–300 |
Output: ProductResult — the images (kind: "photo", captions "Studio image n"), or a job.
| Style | Label | Claude |
|---|---|---|
creative_hero_shot | Hero shot | Yes |
creative_detail_closeup | Detail | Yes |
creative_lifestyle_shot | Lifestyle | No |
creative_studio_lighting | Studio | Yes |
creative_luxury_showcase | Luxury | Yes |
ads_instagram_post | Instagram post | Yes |
ads_story_reel | Story | Yes |
ads_pinterest_pin | Pinterest pin | Yes |
ads_facebook_ad | Facebook ad | Yes |
ads_promotional_banner | Banner | Yes |
ads_campaign_creative | Campaign creative | No |
social_ig_carousel | Carousel slide | Yes |
social_tiktok_vertical | TikTok frame | Yes |
social_story_sticker | Story sticker | Yes |
social_twitter_card | Social card | Yes |
social_pinterest_pin | Pinterest pin | Yes |
social_ugc_lifestyle | UGC lifestyle | No |
print_floral_print | Floral print | Yes |
print_hand_drawn | Hand-drawn print | Yes |
print_abstract_print | Abstract print | Yes |
print_geometric_textile | Geometric print | Yes |
print_vintage_surface | Vintage surface | Yes |
print_fabric_texture | Fabric texture | Yes |
logo_wordmark | Wordmark | Yes |
logo_monogram | Monogram | Yes |
logo_emblem | Emblem | Yes |
logo_icon_mark | Icon mark | Yes |
logo_combination_mark | Icon and text | Yes |
logo_minimalist_brand | Minimal logo | Yes |
display_on_shelf | On a shelf | Yes |
display_storefront | Storefront window | Yes |
display_on_table | On a table | Yes |
display_on_billboard | Billboard | Yes |
display_bus_stop_board | Bus stop board | Yes |
display_pop_up_stand | Pop-up stand | Yes |
On Claude, every request is product-only (no people, no hands or body parts), and Claude sends no free text to Studio.
These two tools are defined but not listed by any host yet. Each will be switched on separately. While they are off, get_job's output schema stays as in §6.1.
Starts a short video of a product in one of Genpire Studio's video styles; the video is made in the background. Uses part of the person's Genpire plan usage.
DX false. Card: yes (the finished video plays in the card, never autoplay, with a "Download video" button). ChatGPT progress text: "Starting your video…" → "Video started". Media rate limit (§9). Needs a paid Genpire plan and the product's front view; refused while other work runs on the product.
| Input | Type | Required | Hosts | Rules |
|---|---|---|---|---|
product | p_ handle | yes | all | |
scenario | enum | yes | all | One of the 15 styles below (Claude: 11) |
seconds | 6 · 8 · 10 | no | all | Default: the style's own. A length the style doesn't offer is refused before any usage is used |
aspectRatio | enum | no | all | 9:16 (default) · 16:9 |
resolution | enum | no | all | 720p · 1080p (default) · 4k |
notes | string | no | ChatGPT, other | 1–600; required for custom_idea |
Styles: product_reveal, spin_360, feature_highlight, ad_cinematic_commercial, ad_social_reel, scene_wind_on_hill, scene_sky_hero, scene_terracotta_room, scene_light_beam, scene_wheat_field, scene_pool_day (all hosts); how_to_style, model_walk, model_in_action, custom_idea (ChatGPT and other clients only).
Output: ProductResult plus job (always — the video runs in the background) and video { scenario, seconds, aspectRatio, resolution }. When done, get_job adds video { n: 1, caption }; the file (MP4 or WebM, from Genpire storage) goes to the card, or to a resource_link in links mode.
Starts a 3D model of a product from its views; it is made in the background and saved with the product in Genpire. Uses part of the person's Genpire plan usage.
DX false (older 3D models stay as earlier versions). Card: yes ("3D model ready" with GLB and USDZ download buttons; no 3D viewer in the card). ChatGPT progress text: "Starting the 3D model…" → "3D model started". Same schema on every host. Media rate limit (§9). Needs the product's views; refused while other work runs on the product. If a model is already being built for the product, the answer is that job, with no second charge.
| Input | Type | Required | Rules |
|---|---|---|---|
product | p_ handle | yes | |
quality | enum | no | hd (default) · fast |
Output: ProductResult plus job. When done, get_job adds model3d { formats, missing } and, while running, progress (0–100). Only GLB (model/gltf-binary) and USDZ (model/vnd.usdz+zip) from Genpire storage are offered.
Coming soon. Both quote tools are already listed in production, but they are not switched on yet: until they are, they answer unavailable. The schemas below are final.
Prepares a request for a quote from Genpire's factory network (a sample of 1 to 3 or a bulk order of 4 or more) for the person to confirm.
RO false · DX false · ID false · OW false: it only creates a pending confirmation; nothing is sent, and it simply expires. Card: yes. Not a design action: it does not count toward the design-action bucket.
| Input | Type | Required | Rules |
|---|---|---|---|
product | p_ handle | yes | |
quantity | integer | yes | 1–100000 (1–3 = a sample, 4 or more = a bulk order) |
sizes | array of string | no | Up to 12, each 1–20 |
destinationCountry | string | yes | 2–60: an ISO 3166-1 alpha-2 code or a country name |
evenWithoutTechPack | boolean | no | Ask for the quote although the product has no tech pack |
Output: product (ProductCard), lines — up to 12 { label (≤ 60), value (≤ 120) }, shipTo { countryName }, confirmIn (widget = confirm in the card; genpire = nothing waits for confirmation; the person requests the quote from the product in Genpire).
The shipping address and phone come from the person's saved profile in Genpire. They never cross MCP, and the model must never ask for them; only the country name is shown. An incomplete profile answers needs_shipping_profile. With confirmIn: "widget" (ChatGPT), the confirmation is held by Genpire for 15 minutes, works once, and is bound to the person. With confirmIn: "genpire" (Claude, Claude Code), no confirmation leaves Genpire.
Sends the quote request the person confirmed in the Genpire card to Genpire's factory network.
App-only: _meta.ui.visibility: ["app"] (ChatGPT also gets openai/visibility: "private"). Only the card's Send quote request button calls it; the model never can. RO false · DX true (the send cannot be undone) · ID false · OW true (it reaches third parties: factories). Listed on ChatGPT; on Claude only if in-card confirmation is turned on for Claude (off today); never on Claude Code or other clients.
| Input | Type | Required | Rules |
|---|---|---|---|
confirmation | string | yes | The card's 22-character token (A–Z a–z 0–9 _ -) |
option | string | yes | 1–40, the card's option id |
The confirmation token travels only in _meta["genpire/widget"].confirm, never in model data. On a 2026-07-28 request that does not declare the MCP Apps UI capability, the call is refused with "Confirm in the Genpire card." A token that is used, expired or not the person's answers "That quote is no longer waiting for confirmation."
Output: product (ProductCard), quote { state: "requested" | "already_requested" }, nextSteps?.
A refused or failed call returns isError: true with one plain English sentence in content[0] and _meta["genpire/error"].error = { code, message }. The default sentence of each code:
| Code | Default sentence |
|---|---|
not_found | I can't find that product in this Genpire account. |
team_product | This is a team product: it is read-only here. Open it in Genpire through its link to change it. |
busy | Genpire is still working on this product. Try again when the current work is done. |
out_of_usage | This needs more Genpire plan usage. The person can compare plans in Genpire. |
daily_limit | The daily limit for Genpire actions from this app is reached. Try again tomorrow. |
refused_rule | This conflicts with one of the person's saved 'don't' rules in Genpire. |
refused_content | This request can't be made in Genpire. |
invalid | That request is not valid for this product. |
stale | Those options are no longer current. Show new options first. |
line_art | This product is black and white. Colour it in Genpire first. |
needs_more | Describe the change more clearly. |
unavailable | This isn't available in Genpire right now. |
needs_tech_pack | This product needs a tech pack before a quote can be requested. |
needs_shipping_profile | The person needs to complete their shipping address and phone in Genpire first. |
not_entitled | This needs another Genpire plan. |
failed | Genpire couldn't finish this. Try again. |
out_of_usage and daily_limit errors also carry usage (percentage only). Other sentences replace the default when they say more:
| Code | Sentence | When |
|---|---|---|
invalid | Which product? Use list_my_products first. | A product tool called without a product |
busy | Genpire is still working on this product (started outside this chat). Try again later. | Work started elsewhere |
invalid | That brand style isn't in this Genpire account. Use list_my_brands first. | Unknown b_ |
invalid | Two brand styles share this name. Rename one in Genpire. | |
invalid | That colour idea isn't current. Use suggest_colours first. | Stale k_ |
invalid | That idea isn't current. Use explore_ideas again. | Stale or foreign d_ |
not_found | That image isn't available any more. Attach it again. | A stored attachment that is gone |
invalid | Only the technical details or the tech pack can be made again. | redo on another kind |
invalid | This product needs its front view first. Draw it with redraw_product. | Studio images, video |
invalid | A 3D model needs the product's views. Draw them with redraw_product first. | 3D model |
invalid | That length isn't offered for this video style. Use 6, 8 or 10 seconds as the style allows. | Video length |
invalid | That style shows people, which isn't available in this app. Pick another style. | People style from a Claude client |
invalid | Print files are made for clothing, shoes and hats only. | Print files |
invalid | This product has no print or logo to make a file from. Add one with edit_product first. | Print files |
invalid | Those HEX codes are not valid. Use six-digit codes. | Pantone |
invalid | That quote is no longer waiting for confirmation. | Quote send |
invalid | Confirm in the Genpire card. | Quote send without the MCP Apps UI capability |
not_entitled | Studio images come with a Genpire plan. · Product videos come with a Genpire plan. · A campaign shoot comes with a Genpire plan. | Paid features |
failed | Genpire couldn't find ideas for that right now. Try a different focus. · Genpire couldn't build that moodboard. Try again. | Ideas, moodboard |
| Code | Sentence | When |
|---|---|---|
unavailable | Too many requests — try again in a minute | A rate limit (§9) |
unavailable | Genpire is not available right now. Please try again in a few minutes. | Genpire could not be reached |
failed | Something went wrong in Genpire. Please try again. | An unexpected answer, or a result that failed the model-data check |
unavailable | This needs another Genpire permission. Reconnect Genpire to allow it. | Missing scope (§2.7) |
unavailable | Using an attached image works in ChatGPT. Upload the image in Genpire instead. | An image from a host other than ChatGPT |
unavailable | Using attached images isn't available yet. Upload the image in Genpire instead. | Image downloads not enabled |
invalid | That file can't be used. Attach the image again. | Not an OpenAI file link |
invalid | The image is too large (10 MB at most). | |
invalid | Attach a PNG, JPEG or WebP image. | |
unavailable | The image couldn't be read right now. Try again. | Download failed or timed out |
refused_content | That image can't be used in Genpire. | The image failed moderation |
Arguments that don't match the published input schema are refused before Genpire runs anything.
| Answer | When |
|---|---|
401 + WWW-Authenticate | No token, or the token is not valid for this server (§2.8) |
403 insufficient_scope | Missing scope on a host other than ChatGPT (§2.7) |
403 "Forbidden host" / "Forbidden origin" | Wrong Host, or a foreign Origin (§1) |
405 "Method not allowed." | Anything but POST /mcp |
Most tools render one UI resource:
| Item | Value |
|---|---|
| URI | ui://genpire/product-v1.html |
| MIME type | text/html;profile=mcp-app |
| Size | One self-contained HTML file, ≤ 150 KB |
| CSP | Images from Genpire's storage origins only; connectDomains: [], frameDomains: [], baseUriDomains: [] — the card has no network of its own |
| Border | prefersBorder: true |
| Hosts | ChatGPT and Claude (claude.ai, Desktop, mobile). Claude Code gets links instead |
Tool _meta: every tool sets ui.visibility (["model", "app"], or ["app"] for send_quote_request) and securitySchemes; card tools also set ui.resourceUri (and the older ui/resourceUri key). ChatGPT also gets openai/outputTemplate, openai/widgetAccessible: true, openai/toolInvocation/invoking|invoked, openai/fileParams on image tools and openai/visibility: "private" on the app-only tool. The ChatGPT resource adds openai/widgetDescription, openai/widgetPrefersBorder and openai/widgetCSP (redirect_domains: the Genpire app and its storage, so downloads open without a warning).
Card data — _meta["genpire/widget"] (never model data):
| Key | Content |
|---|---|
images | Up to 12 { n, url } — the pictures for the ImageRefs with the same n |
thumbnails | Up to 20 { product, url } — product list thumbnails |
editorUrl | The product in the Genpire editor ("Open in Genpire") |
colours | Up to 6 { colour (k_), hex } — colour-idea swatches |
swatches | Up to 8 { n, hex } — Pantone swatches |
confirm | { token, optionId } — the quote confirmation (only where the card confirms) |
previews | Up to 4 short-lived previews of the person's attached images |
files | Up to 12 { n, label, url, mime } — print files (and 3D files, coming soon) |
links | Up to 9 { title, url, kind: "picture" | "genpire" } — moodboard pictures and the Genpire moodboards page |
videos | Up to 3 { n, url, mime } — the finished product video (coming soon) |
What the card does: it uses the MCP Apps bridge (ui/initialize, ui/notifications/tool-result, ui/notifications/host-context-changed, ui/notifications/size-changed, ui/open-link, tools/call). From the card, the person can: use option n (use_option), preview a colour (make_colour_previews), make an idea (create_product with idea), pick a campaign look (make_photos), send a quote (send_quote_request), open the product in Genpire, and see plans when usage is low. It polls get_job while work runs (§5). The card shows no logo; its footer reads "Built and powered by Genpire".
Links mode (Claude Code, and other clients whose request does not declare the MCP Apps UI capability): no card data is sent. Images, files and videos on Genpire storage arrive as resource_link blocks to https://mcp.genpire.com/i/i_… with their MIME type; colour values, moodboard picture links and the quote token are not sent.
Per person and host (each person has separate buckets for ChatGPT, for Claude — Claude Code shares Claude's — and for other clients):
| Bucket | Limit | Applies to |
|---|---|---|
| All tools | 60 per 5 minutes | Every tool except get_job |
| Design actions | 20 per 5 minutes | Every genpire.design tool (on top of "All tools") |
| Media | 6 per 10 minutes | make_studio_images, make_product_video, make_3d_model, shared (on top of the two above) |
| Jobs | 120 per 5 minutes | get_job only |
A call is counted only if every bucket it uses allows it; a refused call uses no slot anywhere. The refusal is the tool error "Too many requests — try again in a minute".
Per person, across all connected apps: 120 tool calls and 240 get_job calls per 5 minutes, 12 media calls per 10 minutes, and a daily limit on design actions (daily_limit: "Try again tomorrow").
Sign-in and links, per IP address:
| Endpoint | Limit |
|---|---|
/.well-known/* | 600 per 5 minutes |
POST /oauth/register | 300 per hour |
GET /oauth/authorize and the resume step | 30 per 10 minutes |
/o/… (open in Genpire) | 120 per 5 minutes |
/i/… (links-mode files) | 600 per 5 minutes |
Tokens: 10 refreshes per minute per token family; 5 failed attempts per authorization code (then it is burned); 60 token or revoke requests per minute per self-registered (DCR) client. Shared client ids (CIMD) are never rate-limited as a whole, so one busy user never blocks another.
- The server never asks for, stores or returns the person's e-mail, address or phone.
- It never reads the host's chat history, memory or files; it receives only each tool's inputs.
- Product names and the person's words come back as data, never as instructions to the model.
- Logs carry counts, codes and timings only: never a token, a handle, tool arguments or an e-mail.
- Tokens are stored only as sha256 digests.
- See the Genpire Privacy Policy and the Terms.
- Server:
genpire1.0.0. The card's URI carries its version (product-v1); a breaking card change would get a new URI. - Each caller sees its own list.
tools/listdepends on the host and on which tools Genpire has switched on. Always readtools/listrather than hard-coding it. - New tools and new options ship off. Genpire adds each new tool, or a new option of an existing tool, switched off, and turns it on separately. While it is off,
tools/listand the server instructions stay exactly as before. - Output schemas only grow. New output keys are optional.
get_job's output gains its video and 3D keys only for hosts that are offered those tools. - Next steps in results only ever name the original 19 tools, so they never point a host at a tool it may not list.
Change log
| Date | Change |
|---|---|
| 2026-11-18 | make_product_video and make_3d_model deployed, switched off (coming soon); get_job reads their jobs once they are on |
| 2026-11-17 | Switched on: explore_ideas, make_moodboard, match_pantone, make_print_files, make_studio_images, the campaign style of make_photos and create_product from an idea. prepare_quote_request and send_quote_request listed; they answer unavailable until quote requests are switched on (coming soon) |
| 2026-11-16 | Added: make_tech_documents, suggest_colours, make_colour_previews, write_description, make_photos and use_image (ChatGPT; attached images coming soon) |
| 2026-11-12 | First release: list_my_products, get_product, get_job, get_usage, list_my_brands, create_product, edit_product, redraw_product, show_options, use_option and apply_brand |
Built and powered by Genpire.