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.

MCP endpoint
https://mcp.genpire.com/mcp

At a glance

ItemValue
MCP endpointhttps://mcp.genpire.com/mcp
TransportStreamable HTTP, stateless, POST only
Authorization serverhttps://mcp.genpire.com (OAuth 2.1)
Scopesgenpire.read, genpire.design, genpire.quote (+ offline_access for refresh)
Server infoname: "genpire", title: "Genpire", version: "1.0.0"
Tools defined26 (21 available, 5 coming soon); each caller sees the subset for its host
UIOne MCP Apps resource: ui://genpire/product-v1.html (the Genpire card)
Supported hostsChatGPT; Claude (claude.ai, Desktop, mobile); Claude Code
Supportsupport@genpire.com

1. Endpoint and transport

  • URL: https://mcp.genpire.com/mcp.
  • Method: POST with a JSON-RPC body (at most 1 MB). GET, DELETE and other methods answer 405 with Allow: POST and 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 _meta envelope, including the client's capabilities, is read on every call) and the earlier 2025 revisions in stateless mode.
  • Host and Origin: the Host header must be mcp.genpire.com. A request that carries an Origin header must come from the server's own origin; anything else answers 403 ("Forbidden host" / "Forbidden origin"). Hosts call the server from their own servers, without an Origin.
  • Cache hints (2026-07-28): tools/list, server/discover, resources/list and resources/read carry 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.

2. Authorization

Genpire runs its own OAuth 2.1 authorization server at https://mcp.genpire.com. Every /mcp request needs a bearer access token issued by it for the resource https://mcp.genpire.com/mcp.

2.1 Discovery

A request without a valid token answers 401 with a WWW-Authenticate: Bearer challenge that carries resource_metadata="https://mcp.genpire.com/.well-known/oauth-protected-resource/mcp" and the scopes genpire.read genpire.design genpire.quote.

Protected-resource metadata (RFC 9728) — GET /.well-known/oauth-protected-resource/mcp (also served at /.well-known/oauth-protected-resource):

Protected-resource metadata (RFC 9728)
{
  "resource": "https://mcp.genpire.com/mcp",
  "authorization_servers": ["https://mcp.genpire.com"],
  "scopes_supported": ["genpire.read", "genpire.design", "genpire.quote"],
  "bearer_methods_supported": ["header"],
  "resource_name": "Genpire",
  "resource_documentation": "https://www.genpire.com/integrations/ai-assistants"
}

Authorization-server metadata (RFC 8414) — GET /.well-known/oauth-authorization-server:

Authorization-server metadata (RFC 8414)
{
  "issuer": "https://mcp.genpire.com",
  "authorization_endpoint": "https://mcp.genpire.com/oauth/authorize",
  "token_endpoint": "https://mcp.genpire.com/oauth/token",
  "registration_endpoint": "https://mcp.genpire.com/oauth/register",
  "revocation_endpoint": "https://mcp.genpire.com/oauth/revoke",
  "response_types_supported": ["code"],
  "response_modes_supported": ["query"],
  "grant_types_supported": ["authorization_code", "refresh_token"],
  "code_challenge_methods_supported": ["S256"],
  "token_endpoint_auth_methods_supported": [
    "none",
    "private_key_jwt",
    "client_secret_post"
  ],
  "token_endpoint_auth_signing_alg_values_supported": ["RS256", "ES256"],
  "revocation_endpoint_auth_methods_supported": [
    "none",
    "private_key_jwt",
    "client_secret_post"
  ],
  "scopes_supported": [
    "genpire.read",
    "genpire.design",
    "genpire.quote",
    "offline_access"
  ],
  "client_id_metadata_document_supported": true,
  "authorization_response_iss_parameter_supported": true,
  "service_documentation": "https://www.genpire.com/integrations/ai-assistants",
  "op_policy_uri": "https://www.genpire.com/privacy",
  "op_tos_uri": "https://www.genpire.com/terms"
}

Both documents are static JSON, cached for one hour. GET /.well-known/openai-apps-challenge serves OpenAI's domain verification token.

2.2 Client identity: CIMD first, DCR as the fallback

Client ID Metadata Documents (CIMD) are the main path. The client_id is the https URL of the client's published metadata document. Genpire accepts these exact documents:

Clientclient_id (metadata document URL)Authentication at the token endpoint
ChatGPThttps://chatgpt.com/oauth/client.jsonprivate_key_jwt
Claude (claude.ai and apps)https://claude.ai/oauth/mcp-oauth-client-metadatanone
Claude (confidential)https://claude.ai/oauth/mcp-oauth-client-metadata/confidential_clientprivate_key_jwt (ES256)
Claude Codehttps://claude.ai/oauth/claude-code-client-metadatanone

Rules: the document is fetched over https with no redirects (5 seconds, at most 5 KB) and cached for one hour; its client_id must equal its URL; token_endpoint_auth_method must be none or private_key_jwt, and a private_key_jwt client's jwks_uri must be on chatgpt.com or claude.ai. Any other URL, including look-alikes on the same hosts, is refused.

Dynamic Client Registration (RFC 7591) is the fallback — POST /oauth/register with a JSON body:

FieldRules
redirect_urisRequired, 1–5 URIs. Every one must be on the redirect allowlist (§2.3) and all must belong to ONE host
token_endpoint_auth_methodnone (default) or client_secret_post
grant_typesauthorization_code, refresh_token
response_typescode
Others acceptedapplication_type (web / native), client_name, client_uri, logo_uri, tos_uri, policy_uri, scope, contacts, software_id, software_version

Unknown fields are refused (invalid_client_metadata); a redirect problem answers invalid_redirect_uri. A success answers 201 with a client_id of the form dcr_… and, for client_secret_post, a client_secret that does not expire. The consent page warns the person that the connection "registered itself".

2.3 Redirect URIs

A redirect is matched as the exact string the client sent (no normalisation):

RedirectWho may use it
https://chatgpt.com/connector_platform_oauth_redirectChatGPT
https://chatgpt.com/connector/oauth/<id>ChatGPT
https://claude.ai/api/mcp/auth_callbackClaude
http://localhost:<any port>/<path>, http://127.0.0.1:<any port>/<path>Claude Code's CIMD only, at the paths its document lists (RFC 8252 §7.3)

In production, loopback redirects are refused for every other client, including self-registered (DCR) ones. So Claude Code connects with its published identity, and local tools such as MCP Inspector cannot connect to the production server.

2.4 Authorization request

GET /oauth/authorize (a browser navigation):

ParameterRules
response_typecode
client_idA CIMD URL from §2.2 or a dcr_… id
redirect_uriMust be one of the client's redirects AND on the allowlist (§2.3)
code_challengeRequired, 43–128 characters (A–Z a–z 0–9 - . _ ~)
code_challenge_methodS256 only (PKCE)
resourceRequired: exactly https://mcp.genpire.com/mcp (RFC 8707)
scopeOptional, space-separated subset of the three scopes. Absent or empty = all three. offline_access is accepted and ignored. Any other scope = invalid_scope
stateOptional, ≤ 2048 characters, returned unchanged

Each parameter must appear once. Errors found before the client and the redirect are known answer a plain 400 page; later errors redirect back with error, error_description, state and iss.

What happens next:

  1. The request is held for 10 minutes, bound to a per-request secure cookie in the browser that started it.
  2. The browser goes to Genpire's consent page on www.genpire.com. The person signs in (if needed) and sees the app, the app type, where sign-in returns, the permissions asked for, and a warning for self-registered apps or apps on this computer. They choose Allow or Cancel.
  3. The browser returns through https://mcp.genpire.com, which checks that it is the same browser AND the one-time approval. The decision must be used within 2 minutes.
  4. The client's redirect_uri receives code, state and iss (RFC 9207 — always https://mcp.genpire.com), or error=access_denied.

2.5 Token endpoint

POST /oauth/token — form-urlencoded or JSON; each parameter once.

Client authentication — a client must use exactly the method it registered:

MethodWhat to send
noneclient_id in the body; no secret, no assertion
private_key_jwtclient_assertion_type=urn:ietf:params:oauth:client-assertion-type:jwt-bearer and client_assertion: RS256 or ES256, kid from the client's JWKS, iss = sub = the client_id, aud = the token endpoint or the issuer, exp at most 5 minutes ahead, a jti used once
client_secret_postDCR clients only: client_id + client_secret in the body

HTTP Basic is not supported (401 invalid_client).

grant_type=authorization_code: code, redirect_uri (required, identical to the authorization request), code_verifier (43–128 characters), and optionally resource (must match). A code lives 60 seconds and works once. Using a code a second time revokes every token it produced. Five failed attempts on a code burn it.

grant_type=refresh_token: refresh_token, and optionally scope (a subset of the granted scopes). Refresh tokens rotate on every use. If a retry repeats the same refresh within 60 seconds, the first successor is revoked and a new pair is issued; any later use of a replaced refresh token revokes the whole token family.

Success (200, Cache-Control: no-store):

Token response
{
  "access_token": "gpm_at_…",
  "token_type": "Bearer",
  "expires_in": 3600,
  "refresh_token": "gpm_rt_…",
  "scope": "genpire.read genpire.design genpire.quote"
}

Tokens are opaque: never parse them. Genpire stores only their sha256 digest. The gpm_at_ / gpm_rt_ prefixes are there so secret scanners can find a leaked token.

Lifetimes

WhatLifetime
Authorization request10 minutes
Consent decision → resume2 minutes
Authorization code60 seconds, single use
Access token1 hour (expires_in: 3600)
Refresh tokenEach one up to 30 days without use; the family ends 90 days after the first sign-in
Refresh retry grace60 seconds

Errors (RFC 6749 JSON, Cache-Control: no-store):

StatuserrorWhen
400invalid_requestA parameter repeated, or the body is not flat strings
400unsupported_grant_typeAny grant other than the two above
401invalid_clientClient authentication failed (wrong method, bad secret or assertion, unknown client)
400invalid_grantEvery code or refresh failure: unknown, expired, used, wrong client, PKCE or redirect mismatch, revoked, person no longer able to connect. The reason is never given
400invalid_targetresource does not match
400invalid_scopeThe refresh asked for a scope the grant does not hold
429temporarily_unavailableMore than 10 refreshes a minute for one token family (with Retry-After)
429slow_downA DCR client over 60 token or revoke requests a minute
503temporarily_unavailableSign-in is briefly unavailable

2.6 Revocation

POST /oauth/revoke (RFC 7009), authenticated like the token endpoint, with token. A refresh token revokes its whole family; an access token revokes that token. The answer is always 200 for an authenticated client, also for unknown tokens or another client's tokens (which are left unchanged).

The person can also disconnect from Genpire (Settings › Connected AI apps). That revokes the grant and every token of that app at once.

2.7 Scopes

ScopeConsent wordingTools
genpire.readSee your products, brands and plan usagelist_my_products, get_product, get_job, get_usage, list_my_brands
genpire.designMake and change products for you. This uses part of your plan usage.Every design tool (§6.2–§6.6)
genpire.quoteSend quote requests for your productsprepare_quote_request, send_quote_request

Each tool's _meta.securitySchemes names its scope: [{ "type": "oauth2", "scopes": ["<scope>"] }].

Step-up. A call to a tool whose scope the token does not hold is refused:

  • ChatGPT gets an isError result with the text "This needs another Genpire permission. Reconnect Genpire to allow it." and _meta["mcp/www_authenticate"] holding an insufficient_scope challenge (the scopes the token holds plus the tool's, and the protected-resource metadata URL).
  • Other hosts get HTTP 403 insufficient_scope with the same challenge in WWW-Authenticate.

2.8 Using the token on /mcp

Send Authorization: Bearer gpm_at_…. The token must be an unexpired, unrevoked access token for https://mcp.genpire.com/mcp, its grant must still be live, and the person must be able to connect. Every failure answers 401 invalid_token with the discovery challenge from §2.1; the reason is never given.

3. Hosts and what each one gets

Genpire works out the host from the token's client, never from anything the client sends:

HostHow Genpire knowsProfileResults shown asWaits up to (default)Quote send
ChatGPTChatGPT's CIMD (or a ChatGPT redirect)chatgptThe Genpire card40 secondsIn the card
Claude (claude.ai, Desktop, mobile)Claude's CIMD (or Claude's redirect)claudeThe Genpire card150 secondsFrom the product in Genpire
Claude CodeClaude Code's CIMDclaudeLinks150 secondsFrom the product in Genpire
Other MCP clients (test server only, such as MCP Inspector)A local (loopback) redirect, accepted only on Genpire's test serverotherCard if the request declares MCP Apps UI, else links40 secondsFrom the product in Genpire
  • The claude profile 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_pantone and make_print_files have no image input; Studio images offer 32 of 35 styles (no Lifestyle, Campaign creative or UGC lifestyle) and no notes; product videos (coming soon) offer 11 of 15 styles and no notes. The narrowed schemas are what Claude sees in tools/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_request shows 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:

HostListed todayAvailable todayWith every tool on
ChatGPT24 (23 the model can call + send_quote_request, app-only)2126
Claude (claude.ai, Desktop, mobile)212023
Claude Code212023

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".

5. Background work and get_job

  • 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) with state: "running", and the work keeps going in Genpire.
  • Call get_job with the j_ handle after pollAfterSeconds to read its state and its finished images, documents and usage.
  • The Genpire card polls get_job by itself every 5 seconds, for up to 120 polls (10 minutes). A new tool result restarts the budget.
  • get_job has its own rate-limit bucket (§9), so polling never uses up the bucket of the other tools.
  • get_job only opens jobs started from the same assistant (ChatGPT, or Claude). get_product shows busyElsewhere: true when 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.

6. Tools

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.

ToolWhat it doesScopeHostsStatus
list_my_productsList my productsLists 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
  • ChatGPT
  • Claude
  • Claude Code
Available
get_productGet a productShows 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
  • ChatGPT
  • Claude
  • Claude Code
Available
get_jobGet job statusShows the status and results of background work on a Genpire product, such as views being drawn or a tech pack being prepared.genpire.read
  • ChatGPT
  • Claude
  • Claude Code
Available
get_usageGet usage leftShows how much of the person's Genpire plan is left to use, as a percentage.genpire.read
  • ChatGPT
  • Claude
  • Claude Code
Available
list_my_brandsList my brand stylesLists the person's personal brand styles (Brand DNA) in Genpire and which one is active.genpire.read
  • ChatGPT
  • Claude
  • Claude Code
Available
create_productCreate a productCreates 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
  • ChatGPT
  • Claude
  • Claude Code
Available
edit_productEdit a productChanges a product's design as described, for the whole product or one of its views.genpire.design
  • ChatGPT
  • Claude
  • Claude Code
Available
redraw_productRedraw a productDraws a product again, or redraws one of its views.genpire.design
  • ChatGPT
  • Claude
  • Claude Code
Available
show_optionsShow 3 optionsDraws three alternative looks for a product from three short descriptions, for the person to choose from.genpire.design
  • ChatGPT
  • Claude
  • Claude Code
Available
use_optionUse an optionKeeps option 1, 2 or 3 of a product's alternative looks as its design and draws its full sheet.genpire.design
  • ChatGPT
  • Claude
  • Claude Code
Available
apply_brandApply a brand styleRestyles a product in one of the person's Genpire brand styles, or in their active one.genpire.design
  • ChatGPT
  • Claude
  • Claude Code
Available
make_tech_documentsMake tech documentsMakes a product's technical documents: the technical details (size guide and specs), one of them, or the full tech pack.genpire.design
  • ChatGPT
  • Claude
  • Claude Code
Available
suggest_coloursSuggest coloursSuggests numbered colour ideas for a product, with a swatch of each in the Genpire card.genpire.design
  • ChatGPT
  • Claude
  • Claude Code
Available
make_colour_previewsPreview coloursShows one of the suggested colour ideas on the product, or all of them.genpire.design
  • ChatGPT
  • Claude
  • Claude Code
Available
use_imageUse my imageUses 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
  • ChatGPT
Coming soon
write_descriptionWrite a descriptionWrites a sales description of a product in Genpire.genpire.design
  • ChatGPT
  • Claude
  • Claude Code
Available
make_photosMake product photosMakes 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
  • ChatGPT
Available
explore_ideasExplore product ideasSuggests 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
  • ChatGPT
  • Claude
  • Claude Code
Available
make_moodboardMake a moodboardBuilds 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
  • ChatGPT
  • Claude
  • Claude Code
Available
match_pantoneMatch Pantone coloursFinds 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
  • ChatGPT (image: coming soon)
  • Claude (no image)
  • Claude Code (no image)
Available
make_print_filesMake print filesMakes 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
  • ChatGPT (image: coming soon)
  • Claude (no image)
  • Claude Code (no image)
Available
make_studio_imagesMake Studio imagesMakes images of a product in one of Genpire Studio's styles for creative shots, ads, social posts, prints, logos and retail displays.genpire.design
  • ChatGPT
  • Claude (32 styles)
  • Claude Code (32 styles)
Available
make_product_videoMake a product videoStarts a short video of a product in one of Genpire Studio's video styles; the video is made in the background.genpire.design
  • ChatGPT
  • Claude (11 styles)
  • Claude Code (11 styles)
Coming soon
make_3d_modelMake a 3D modelStarts a 3D model of a product from its views; it is made in the background and saved with the product in Genpire.genpire.design
  • ChatGPT
  • Claude
  • Claude Code
Coming soon
prepare_quote_requestPrepare a quote requestPrepares 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
  • ChatGPT
  • Claude
  • Claude Code
Coming soon
send_quote_requestSend the quote requestSends 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
  • ChatGPT (app-only)
Coming soon

6.1 Look things up (genpire.read)

Every read tool: RO true · DX false · ID true · OW false. Reads change nothing in the person's account.

list_my_products — List 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.

Card: yes. Needs a product: no.

InputTypeRequiredRules
cursorc_ handlenoThe nextCursor of the previous page
limitintegerno1–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.

get_product — Get 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.

Card: yes.

InputTypeRequired
productp_ handleyes

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?.

get_job — Get 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.

Card: yes. Own rate-limit bucket.

InputTypeRequired
jobj_ handleyes

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.

get_usage — Get usage left

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.

list_my_brands — List my brand styles

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 }.

6.2 Design (genpire.design)

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_product — Create a product

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".

InputTypeRequiredRules
briefstringone of3–2000. The person's description
idead_ handleone ofAn idea from explore_ideas
namestringno1–120. Not with idea
brandb_ handlenoA 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.

edit_product — Edit a 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".

InputTypeRequiredRules
productp_ handleyes
changestringyes1–500
viewenumnofront · back · side

Output: ProductResult (a new design revision).

redraw_product — Redraw a product

Draws a product again, or redraws one of its views. Uses part of the person's Genpire plan usage.

DX false. Card: yes.

InputTypeRequiredRules
productp_ handleyes
viewenumnofront · back · side — redraw that view
drawAgainbooleannoDraw the same design again
promptstringno1–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.

show_options — Show 3 options

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).

InputTypeRequiredRules
productp_ handleyes
variantsarray of stringyesExactly 3, each 10–600

Output: ProductResult with options [{ n: 1 }, { n: 2 }, { n: 3 }] and the option images (kind: "option").

use_option — Use an 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.

InputTypeRequiredRules
productp_ handleyes
optionintegeryes1–3

Output: ProductResult. Options that are no longer current answer stale.

apply_brand — Apply a brand style

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.

InputTypeRequiredRules
productp_ handleyes
brandb_ handlenoAbsent = the person's active brand style

Output: ProductResult (a new revision).

6.3 Documents (genpire.design)

make_tech_documents — Make tech documents

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…".

InputTypeRequiredRules
productp_ handleyes
kindenumyestechnical_details (size guide + specs) · size_guide · specs · tech_pack
redobooleannoOnly with technical_details or tech_pack

Output: ProductResult with documents (DocCard). The tech pack usually runs as a job.

write_description — Write a description

Writes a sales description of a product in Genpire.

DX false. Card: yes.

InputTypeRequiredRules
productp_ handleyes
redobooleannoWrite it again

Output: product (ProductCard), description (≤ 2000).

6.4 Ideas, colours and moodboards (genpire.design)

explore_ideas — Explore product ideas

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".

InputTypeRequiredRules
productp_ handlenoGiven = variations of this product
focusstringno1–300
category, audience, season, material, tierstringno1–60 each
rangeenumnofocused (2 ideas) · balanced (3, the default) · wide (4)
morebooleannoMore 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.

suggest_colours — Suggest colours

Suggests numbered colour ideas for a product, with a swatch of each in the Genpire card.

DX false. Card: yes.

InputTypeRequiredRules
productp_ handleyes
stylestringno1–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.

make_colour_previews — Preview colours

Shows one of the suggested colour ideas on the product, or all of them.

DX false. Card: yes.

InputTypeRequiredRules
productp_ handleyes
colourk_ handleone ofOne colour idea from suggest_colours
alltrueone ofPreview every suggested colour

Give exactly one of colour or all. Output: ProductResult with colour previews (kind: "colour").

match_pantone — Match Pantone colours

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.

InputTypeRequiredHostsRules
productp_ handlenoallIts saved colours
coloursarray of stringnoall1–8 HEX codes, #RRGGBB or RRGGBB
imageChatGPT file objectnoChatGPTSee use_image
uploadu_ handlenoChatGPT, otherSet 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.

make_moodboard — Make 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.

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".

InputTypeRequiredRules
productp_ handleno
directionstringno1–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.

6.5 Images and print files (genpire.design)

use_image — Use my image (coming soon)

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.

InputTypeRequiredRules
productp_ handleunless use is new_product
imageChatGPT file objectone of{ download_url (https), file_id (1–200), mime_type? (1–100), file_name? (1–255) }
uploadu_ handleone ofSet by the server after it stores image
useenumyeslogo · patch · print · fabric · wash · component · reference · new_product
fieldsobjectnoUp to 8 of position, size, coverage, scale, attachMethod, action, target, view, wash (each 1–60)
instructionsstringno1–500
matchenumnoinspired · 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).

make_print_files — Make print files

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.

InputTypeRequiredHostsRules
productp_ handleyes, except a vector from an image (ChatGPT)all
modeenumyesallprint_file · pattern · embroidery · vector
placementenumnoallplaced · all_over; only with print_file
imageChatGPT file objectnoChatGPTOnly with embroidery or vector
uploadu_ handlenoChatGPT, otherSet 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.

make_photos — Make 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. Uses part of the person's Genpire plan usage.

Hosts: ChatGPT and other clients; not Claude. DX false. Card: yes.

InputTypeRequiredRules
productp_ handleyes
styleenumyeswhite_background · lifestyle · on_model · campaign
countintegerno1–3 (a campaign makes 3 unless count is given)
lookenumnostreet · studio · nature · home; only with campaign
scenestringno1–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.

make_studio_images — Make 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. 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.

InputTypeRequiredHostsRules
productp_ handleyesall
styleenumyesallOne of the styles below (Claude: 32)
countintegernoall1–3 (default 1)
aspectRatioenumnoall1:1 · 2:3 · 3:2 · 3:4 · 4:3 · 9:16 · 16:9 · 21:9 (default: the style's own)
notesstringnoChatGPT, other1–300

Output: ProductResult — the images (kind: "photo", captions "Studio image n"), or a job.

StyleLabelClaude
creative_hero_shotHero shotYes
creative_detail_closeupDetailYes
creative_lifestyle_shotLifestyleNo
creative_studio_lightingStudioYes
creative_luxury_showcaseLuxuryYes
ads_instagram_postInstagram postYes
ads_story_reelStoryYes
ads_pinterest_pinPinterest pinYes
ads_facebook_adFacebook adYes
ads_promotional_bannerBannerYes
ads_campaign_creativeCampaign creativeNo
social_ig_carouselCarousel slideYes
social_tiktok_verticalTikTok frameYes
social_story_stickerStory stickerYes
social_twitter_cardSocial cardYes
social_pinterest_pinPinterest pinYes
social_ugc_lifestyleUGC lifestyleNo
print_floral_printFloral printYes
print_hand_drawnHand-drawn printYes
print_abstract_printAbstract printYes
print_geometric_textileGeometric printYes
print_vintage_surfaceVintage surfaceYes
print_fabric_textureFabric textureYes
logo_wordmarkWordmarkYes
logo_monogramMonogramYes
logo_emblemEmblemYes
logo_icon_markIcon markYes
logo_combination_markIcon and textYes
logo_minimalist_brandMinimal logoYes
display_on_shelfOn a shelfYes
display_storefrontStorefront windowYes
display_on_tableOn a tableYes
display_on_billboardBillboardYes
display_bus_stop_boardBus stop boardYes
display_pop_up_standPop-up standYes

On Claude, every request is product-only (no people, no hands or body parts), and Claude sends no free text to Studio.

6.6 Coming soon (genpire.design)

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.

make_product_video — Make a product video (coming soon)

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.

InputTypeRequiredHostsRules
productp_ handleyesall
scenarioenumyesallOne of the 15 styles below (Claude: 11)
seconds6 · 8 · 10noallDefault: the style's own. A length the style doesn't offer is refused before any usage is used
aspectRatioenumnoall9:16 (default) · 16:9
resolutionenumnoall720p · 1080p (default) · 4k
notesstringnoChatGPT, other1–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.

make_3d_model — Make a 3D model (coming soon)

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.

InputTypeRequiredRules
productp_ handleyes
qualityenumnohd (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.

6.7 Factory quotes (genpire.quote) — coming soon

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.

prepare_quote_request — Prepare 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.

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.

InputTypeRequiredRules
productp_ handleyes
quantityintegeryes1–100000 (1–3 = a sample, 4 or more = a bulk order)
sizesarray of stringnoUp to 12, each 1–20
destinationCountrystringyes2–60: an ISO 3166-1 alpha-2 code or a country name
evenWithoutTechPackbooleannoAsk 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.

send_quote_request — Send the quote request

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.

InputTypeRequiredRules
confirmationstringyesThe card's 22-character token (A–Z a–z 0–9 _ -)
optionstringyes1–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?.

7. Errors

7.1 Tool errors

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:

CodeDefault sentence
not_foundI can't find that product in this Genpire account.
team_productThis is a team product: it is read-only here. Open it in Genpire through its link to change it.
busyGenpire is still working on this product. Try again when the current work is done.
out_of_usageThis needs more Genpire plan usage. The person can compare plans in Genpire.
daily_limitThe daily limit for Genpire actions from this app is reached. Try again tomorrow.
refused_ruleThis conflicts with one of the person's saved 'don't' rules in Genpire.
refused_contentThis request can't be made in Genpire.
invalidThat request is not valid for this product.
staleThose options are no longer current. Show new options first.
line_artThis product is black and white. Colour it in Genpire first.
needs_moreDescribe the change more clearly.
unavailableThis isn't available in Genpire right now.
needs_tech_packThis product needs a tech pack before a quote can be requested.
needs_shipping_profileThe person needs to complete their shipping address and phone in Genpire first.
not_entitledThis needs another Genpire plan.
failedGenpire 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:

CodeSentenceWhen
invalidWhich product? Use list_my_products first.A product tool called without a product
busyGenpire is still working on this product (started outside this chat). Try again later.Work started elsewhere
invalidThat brand style isn't in this Genpire account. Use list_my_brands first.Unknown b_
invalidTwo brand styles share this name. Rename one in Genpire.
invalidThat colour idea isn't current. Use suggest_colours first.Stale k_
invalidThat idea isn't current. Use explore_ideas again.Stale or foreign d_
not_foundThat image isn't available any more. Attach it again.A stored attachment that is gone
invalidOnly the technical details or the tech pack can be made again.redo on another kind
invalidThis product needs its front view first. Draw it with redraw_product.Studio images, video
invalidA 3D model needs the product's views. Draw them with redraw_product first.3D model
invalidThat length isn't offered for this video style. Use 6, 8 or 10 seconds as the style allows.Video length
invalidThat style shows people, which isn't available in this app. Pick another style.People style from a Claude client
invalidPrint files are made for clothing, shoes and hats only.Print files
invalidThis product has no print or logo to make a file from. Add one with edit_product first.Print files
invalidThose HEX codes are not valid. Use six-digit codes.Pantone
invalidThat quote is no longer waiting for confirmation.Quote send
invalidConfirm in the Genpire card.Quote send without the MCP Apps UI capability
not_entitledStudio images come with a Genpire plan. · Product videos come with a Genpire plan. · A campaign shoot comes with a Genpire plan.Paid features
failedGenpire couldn't find ideas for that right now. Try a different focus. · Genpire couldn't build that moodboard. Try again.Ideas, moodboard

7.2 Errors from the server itself

CodeSentenceWhen
unavailableToo many requests — try again in a minuteA rate limit (§9)
unavailableGenpire is not available right now. Please try again in a few minutes.Genpire could not be reached
failedSomething went wrong in Genpire. Please try again.An unexpected answer, or a result that failed the model-data check
unavailableThis needs another Genpire permission. Reconnect Genpire to allow it.Missing scope (§2.7)
unavailableUsing an attached image works in ChatGPT. Upload the image in Genpire instead.An image from a host other than ChatGPT
unavailableUsing attached images isn't available yet. Upload the image in Genpire instead.Image downloads not enabled
invalidThat file can't be used. Attach the image again.Not an OpenAI file link
invalidThe image is too large (10 MB at most).
invalidAttach a PNG, JPEG or WebP image.
unavailableThe image couldn't be read right now. Try again.Download failed or timed out
refused_contentThat 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.

7.3 Protocol-level answers

AnswerWhen
401 + WWW-AuthenticateNo token, or the token is not valid for this server (§2.8)
403 insufficient_scopeMissing 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

8. The Genpire card (MCP Apps)

Most tools render one UI resource:

ItemValue
URIui://genpire/product-v1.html
MIME typetext/html;profile=mcp-app
SizeOne self-contained HTML file, ≤ 150 KB
CSPImages from Genpire's storage origins only; connectDomains: [], frameDomains: [], baseUriDomains: [] — the card has no network of its own
BorderprefersBorder: true
HostsChatGPT 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):

KeyContent
imagesUp to 12 { n, url } — the pictures for the ImageRefs with the same n
thumbnailsUp to 20 { product, url } — product list thumbnails
editorUrlThe product in the Genpire editor ("Open in Genpire")
coloursUp to 6 { colour (k_), hex } — colour-idea swatches
swatchesUp to 8 { n, hex } — Pantone swatches
confirm{ token, optionId } — the quote confirmation (only where the card confirms)
previewsUp to 4 short-lived previews of the person's attached images
filesUp to 12 { n, label, url, mime } — print files (and 3D files, coming soon)
linksUp to 9 { title, url, kind: "picture" | "genpire" } — moodboard pictures and the Genpire moodboards page
videosUp 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.

9. Rate limits

Per person and host (each person has separate buckets for ChatGPT, for Claude — Claude Code shares Claude's — and for other clients):

BucketLimitApplies to
All tools60 per 5 minutesEvery tool except get_job
Design actions20 per 5 minutesEvery genpire.design tool (on top of "All tools")
Media6 per 10 minutesmake_studio_images, make_product_video, make_3d_model, shared (on top of the two above)
Jobs120 per 5 minutesget_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:

EndpointLimit
/.well-known/*600 per 5 minutes
POST /oauth/register300 per hour
GET /oauth/authorize and the resume step30 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.

10. Privacy rules built into the server

  • 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.

11. Versioning and changes

  • Server: genpire 1.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/list depends on the host and on which tools Genpire has switched on. Always read tools/list rather 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/list and 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

DateChange
2026-11-18make_product_video and make_3d_model deployed, switched off (coming soon); get_job reads their jobs once they are on
2026-11-17Switched 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-16Added: make_tech_documents, suggest_colours, make_colour_previews, write_description, make_photos and use_image (ChatGPT; attached images coming soon)
2026-11-12First 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.