Blueprint Studio

Set an asset's favorite status. Pass favorite (true or false) so a retry lands on the same result; omitting it flips the current state.

favorite_asset

Use this when the user wants an image or visual asset for their brand, business, product or client, especially when it should match their brand (its saved Style, colors or official logo), stay consistent with images they made before, or be saved to their Blueprint Studio library for their team: social posts and ads, website hero images and banners, app icons and UI illustrations, email headers, pitch-deck and slide visuals, product shots, icons and logos. Also use it when the user names Blueprint Studio, or asks to change or make a variation of an image saved there (pass its parentAssetId). Do not use it for casual one-off pictures with no brand, business or library need (a pet portrait, a meme, a phone wallpaper) unless the user asks for Blueprint Studio. Do not use it to edit the user's personal photos or to depict real people. Images attached to this chat can't be used as inputs. Creates the image in the user's Blueprint Studio Asset Generator library, in the Style given by styleId (list_styles); without one, an edit keeps its parent's Style and a new image uses the workspace default. inputs takes ordered official logos (generationInput from list_brand_assets), authorized URLs or saved receipt references. Returns a jobId immediately; get_generation_status in the same workspace reports progress and the result, then show it with show_assets. A polling timeout doesn't mean the job failed; a new request starts a second, separately charged generation.

generate_asset

Use this when the user asks Blueprint Studio for visual asset ideas for a topic or brand before making images. It doesn't read the user's saved brand or Styles. Not for general brainstorming, marketing plans or copywriting. Generate visual asset ideas for a given topic or brand.

generate_ideas

Get image details and the user-authored prompt for a specific asset by ID.

get_asset

Get a brand's details: settings with its default Style, member count, official logo count, what the user's role can do there (canManage, roleHelp), and the brands inside it: its primary brand (isPrimary, primaryBrandId) and its sub-brands. Items with no sub-brand are the primary brand's.

get_brand

Shows a brand setup started with setup_brand: its status, the editable draft (brand name, the logo found on the site, palette with where each color came from, fonts, descriptors, reference images, notes) and the free previews, as one image plus a link per preview. Use after setup_brand until the status is ready or failed; pass waitSeconds (up to 25) to wait for progress between checks. When the status is ready, show the user the previews, the logo and the draft and ask what to change before save_brand_setup.

get_brand_setup

Read the saved generation receipt's user-visible model, parameters, Style version, creator, and reference labels. Missing historical information stays marked missing; protected prompts are not exposed. reuse lists ready-made generate_asset inputs to make something similar: the image itself and its saved inputs.

get_generation_details

Check a generation job returned by generate_asset. Poll this job until completed or failed; do not submit generate_asset again after a timeout. Completed results include the saved asset and Style IDs, a preview image, webUrl (the image in Blueprint Studio Asset Generator), libraryUrl and a full-resolution downloadUrl. nextStep can add one sentence for the user: credits running low (with where to get more), or after their first image, an offer to set up their brand. A failed job's credits are refunded automatically, and its nextStep says how to retry with a new requestId, including how to reword a request the image model's safety filter refused.

get_generation_status

Returns a step-by-step how-to guide for Blueprint Studio Asset Generator, as Markdown. Topics: start (a first image for a new account, from three starters, with what it costs, saved and linked, and which guide fits other jobs), assets (making, editing and delivering one image: prompts, sizes, inputs, uploads, checking it and saving it), asset_set (many matching images in one batch within a budget, checked together, and resuming earlier jobs), brand (setting up a brand from a website or images, saving only what the user approved, plus members and roles), logos (finding, adding, labelling and placing a brand's official logos, from a list_brand_assets logo sheet), styles (building and testing reusable Styles, images placed in a page, and reviewing Style candidates), contract (signing in again, the workspace on each call, generation jobs, checks, retries, credit limits and recovery). Leave topic out for the list. Useful when planning one of these tasks or when a step isn't clear. The guides explain the tools, not a brand's own guidelines (get_workspace_context has those). They are the Blueprint Studio plugin's skills as text, so a host with those skills loaded already has them. Read only.

get_guide

Get a Style, Template, Mockup or Subject: its details, source files, kind, type and keeps line, and its reference images (references: position, imageUrl and mimeType; a Template, Mockup or Subject's also say each one's role, what it keeps, and preservation level). Protected instructions are withheld unless you authored them. A typed Style also says its type, every field of it (empty when unfilled), its own template if it has one, and notes (its own words beside the fields).

get_style

Use this once the user says they've uploaded files through a link from create_upload_link. List the files received on an upload link from create_upload_link, each checked and ready to use: its uploadId goes to add_brand_asset, and its generationInput to generate_asset.inputs. Call it after the user says they've uploaded. A file refused as not an image says why in rejection. source says how each file arrived: page (dropped by the user) or direct (PUT to upload.url).

get_upload_link

Invite people to a brand: an email invite to one address (they get an email with a link that works for that address for 7 days), or a shareable invite link anyone can use to join (type "link"), with optional maxUses and expiresInDays (a link lasts 7 days unless you pass expiresInDays; an admin link also works once unless you pass maxUses or expiresInDays). role member makes images and Styles; admin also manages logos, settings and people. Everyone invited can make images, and each person uses their own credits. Returns inviteUrl to share. Owners and admins only. list_invites shows pending invites and links; revoke_invite cancels one. Invites are rate limited per address and per sender; past a limit the error says how long to wait (retryAfterSeconds).

invite_member

Use this when the user wants to find, review or reuse images they made with Blueprint Studio: "show my recent images", "find the banner we made last week", "make another in the same style as last time" (each result carries its styleId for generate_asset). To show images to the user, pass their IDs to show_assets. Covers Blueprint Studio images only, not images in this chat. Browse compact asset summaries and prompt previews. Use get_asset for the full prompt and details. Responses are size-limited; continue at nextOffset until null, even when fewer than limit assets were returned.

list_assets

Use this when the user wants their official logo, product images or brand artwork in a new image ("put our logo on it", "use our real logo, don't redraw it"), or asks which official logos their brand has. List official versioned logos, artwork, and products in the selected brand. Use generationInput in generate_asset.inputs to preserve official identity and logo instructions. To choose a logo, call it with kind: "logo" and previews: true: you get the logos only, and one logo sheet image with each numbered and named (light logos on a dark swatch); each logo in the JSON gets the matching sheetNumber. Then choose by its labels: form (mark, wordmark or lockup), background (the background it's made for: light, dark or any) and primary (the brand's main logo); with no labels, use the name, variant and the sheet. kind also takes "artwork" or "product"; leave it out to list everything. officialLogos counts the brand's logos; with none, nextStep says how the user adds one (never draw a stand-in). brandAssetsUrl opens Brand assets on the web. Official logos have publicUrl, a public link to the file that doesn't expire (for a page, email or design that shows the logo). To download an official file, the user opens brandAssetsUrl.

list_brand_assets

Use this when the user names one of their brands, companies or clients, or asks which brands they have in Blueprint Studio, to get the brandId that every call in that brand needs. List brands the authenticated user belongs to, each with the brands inside it: its primary brand (isPrimary, primaryBrandId) and its sub-brands. Items with no sub-brand are the primary brand's. The personal library works without a brand.

list_brands

Lists the types a Style can start from: Photography, Illustration, Icons, 3D and Graphic, plus Custom for your own. Each has a template, plain prompt text whose {blanks} are its fields, and a hint for each field. Pick the type that fits the look and pass it to create_style or update_style with its fields: the Style's prompt is written from them. Changes nothing. It lists the types of Templates, Mockups and Subjects too (kind narrows it), with what a Template or Mockup asks for each time it's used (inputs).

list_context_types

List a brand's pending email invites and active invite links (owners and admins): type, email or link name, role, expiresAt (null: no expiry), maxUses and useCount, and inviteUrl on email invites to share again. A link invite's URL isn't shown again: make a new link with invite_member if the user needs one. Pass an id to revoke_invite to cancel one.

list_invites

List members and pending invites for a brand.

list_members

Discover image models, supported settings, defaults, and public credit costs. access says which of these this account can use, and why; defaultImageSize is the size generate_asset makes when imageSize is left out. Generation rechecks live entitlement and availability.

list_models

Use this when choosing the look for a Blueprint Studio image, when the user asks for "our style", "the same style as before" or which Styles they have, and before creating a Style so it fits the existing library. Pass the same Style's id as generate_asset styleId to keep a set of images consistent. Lists the Styles available in a workspace (the brand's saved visual looks, plus built-in ones, isSystem) and their categories, with thumbnails and version metadata. Each Style says its type (list_context_types), or null for one without. In a brand, isBrandDefault marks the brand's default Style: a suggestion, since generate_asset applies no Style without styleId. In a brand with sub-brands, subBrand names the one a Style belongs to. Items with no sub-brand are the primary brand's. Use when choosing a look for an image or visual asset (for a sub-brand, one of its own; for a product line, one in its category), and before creating a Style so it fits the existing library. With kind it lists Templates (a layout whose named slots you fill), Mockups (a scene to place work in) or Subjects (a character, person, product, object or place kept the same in every image); each item says its kind and type. Pass a Template or Mockup as generate_asset styleId, and up to 3 Subjects in subjectIds beside any Style.

list_styles

Use this when the user wants a transparent background or cutout of an image saved in their Blueprint Studio library, such as a logo, icon or product shot made there. Removes the background from a saved asset image and saves the cutout as a new transparent PNG asset linked to the original, which stays unchanged. Use for game sprites, icons, logos, stickers and product shots on a transparent background. Costs 2 credits per image, charged once per operationId and refunded if removal fails. For a new image, generate_asset with background "transparent" does both in one call. Works on assets saved in Blueprint Studio (an assetId from list_assets or get_generation_status) and images in the Library (the id save_to_library returned). Pass an operationId, a unique id you make up (a UUID works); reuse it only to retry or poll the same removal, which never charges again.

remove_background

Remove a member from a brand. Requires admin or owner role. Cannot remove the owner.

remove_member

Revoke a pending email invite or an invite link (owners and admins): its link stops working at once, and people who already joined stay. Take the id from list_invites, or from invite_member's result.

revoke_invite

Saves a brand setup as a brand and Style, applying any edits the user asked for. Creates the brand (named brandName, or the name found on the website) with the Style as its default, saves the logo found on the website as its official logo (logo: false to skip one that looks wrong), keeps the reference images on the Style, and adds the previews to the library as its first images. Pass saveTo: personal to save only the Style to the personal library. Use once get_brand_setup has returned the draft and you've shown it to the user, with any changes they asked for. Saving the same setup again returns the first save. Afterwards, generate_asset with the returned brandId and styleId makes images in that Style.

save_brand_setup

Save an image into the Library of the selected brand (or the personal library without brandId) as a named item in a folder, so the user finds it there later: a screenshot of a website, or a reference image you found or made while working. Upload links (create_upload_link) last 24 hours; a saved item stays. Send exactly one image: uploadId (a file uploaded with create_upload_link, for one on this machine) or url (a public https link to a PNG, JPEG, WebP, AVIF, GIF or SVG image). name is what the Library shows, up to 100 characters: for a screenshot of a site, the site, the part and the date, like "tools.blueprintstudio.ai · Hero · 2026-10-30". folder is a top-level folder by name, made if it isn't there, such as "References"; leave it out for the top level. Needs permission to add to that Library (owners, admins and members with create access). Each call adds a new item, unless the same image is already in that folder (alreadySaved: that item comes back); nothing is charged.

save_to_library

Tell the Blueprint Studio team what went wrong or what the user wanted. Use it when the user reports a problem or asks for something Blueprint Studio Asset Generator can't do, or when you get stuck or confused yourself: an unclear error, unexpected output, a missing capability, or a workflow these tools don't fit. Describe the problem in your own words, and quote what the user wrote only when they asked you to pass it on. Tell them what you sent. Never include generation prompts, image contents, API keys or tokens; put IDs and error codes in context instead. The team reads every message. Send one per issue, not one per retry; limited to 10 per hour.

send_feedback

Use an image generated with a saved Style as that Style's sidebar thumbnail. This updates display metadata only, not its prompt or reference set. Get expectedUpdatedAt from get_style; if the Style changed, refresh before retrying.

set_style_thumbnail

Use this when the user wants Blueprint Studio to learn their brand so later images match it, from their website and/or 1-5 images they like: "set up my brand from acme.com", "use the colors and fonts from my website", "make a brand kit from our site", "make my images look like these". Do not use it to invent a brand name, logo or identity from scratch, to write a brand guidelines document, or to review or redesign a website. Sets up the user's brand from their website and/or 1-5 images they like: reads the site's real logo, colors, fonts, name and images, drafts a brand and a Style from them, and renders up to three free previews in that Style (from the account's free setup previews, which use no credits). Use when the user asks to set up their brand, or wants their images to match their website or brand. Social and link-in-bio pages (Instagram, Facebook, TikTok, Linktree) can't be read: ask for 2 or 3 images instead. Returns a setupId at once; then call get_brand_setup with waitSeconds, show the user the draft and previews, and save it with save_brand_setup. Omit brandId to create a new brand on save (or save to the personal library); pass a brandId to add the Style to that brand.

setup_brand

Makes a public link to one image. Anyone with the link can see the image; the prompt stays hidden. Use it only when the user asks for a link. They can see and turn off their links in Settings, Shared links.

share_asset

Use this to show Blueprint Studio images to the user: after get_generation_status reports completed (pass its assetId, or every assetId of a batch), when the user asks to see images found with list_assets ("show me my last 4 images"), or when get_brand_setup has finished previews (pass its setupId instead, in the same workspace). Renders up to 20 images, in order, inline with Open in Asset Generator and Download buttons. Call it once per set of images: the gallery appears as soon as it returns. Display only: it creates, changes and charges nothing. Shows saved Blueprint Studio images and brand setup previews only.

show_assets

Use this when the user wants prompt ideas for one of their saved Blueprint Studio Styles (pass its styleId) before making images. Not for general writing or brainstorming. Generate creative prompt suggestions, optionally based on a style.

suggest_prompts

Use this when the user says which of their official logos is which, so the right one is used in later images ("that one is our wordmark", "this is the version for dark backgrounds", "make this our main logo"). Label an official logo, artwork or product image in the selected brand so the right one is chosen for each image (owners and admins): form (mark, wordmark or lockup; logos only), background (light, dark or any: the background it's made for) and primary (the brand's main logo; setting it unsets the previous one). Fields left out keep their value; null clears form or background. To change the file itself, use add_brand_asset with replaceAssetId.

update_brand_asset

Update brand settings: the default Style (the web app starts new images with it; agents see it as the brand's suggested Style) and the prompt template. The default Style must be a built-in (system) Style or one of this brand's own Styles, as listed by list_styles. Requires admin or owner role.

update_brand_settings

Change a member's role in a brand: member (makes images and Styles) or admin (also manages logos, settings and people). Only the brand owner can change roles. Either role can make images, so this also gives create access to a member who could only view the brand.

update_member_role

Update a custom style. Cannot modify system styles. addInputs adds reference images (create_style's input forms) and removeReferenceImages removes saved ones (get_style references); a Style keeps up to 5. All the changes save together, or none do. To change a typed Style, or give one a type, pass type, fields, template or notes with expectedUpdatedAt from get_style, and its prompt is written again. A stylePrompt sent on its own replaces the prompt and makes the Style plain.

update_style

Use this once per session before making images or brand assets with Blueprint Studio Asset Generator, and when the user asks what they have there ("which brands do I have", "how many credits are left", "what can Blueprint Studio make"). Returns the user's Blueprint Studio account: plan and credits (welcome credits included; canAffordImage and nextStep say when they run out), what a default image costs, their brands and library (defaultBrandId when they have exactly one brand), brand-guide sources, permissions, available modules, and a gettingStarted plan for new accounts. Read only: it doesn't switch brands. Not needed for requests that don't involve Blueprint Studio.

get_workspace_context