This article is also available in:

AI Assistant (MCP)

A plain-language rundown of every action available through the Teeinblue AI Assistant (MCP) — for building campaigns, building and organizing your design library, publishing to stores, and handling orders. No coding knowledge needed; just find the job you want done and use the same example prompt.

Getting Started

Connect an MCP-compatible assistant — Claude Desktop, Claude Code, a Claude.ai custom connector, Cursor, or any other client that speaks Streamable HTTP MCP — directly to your TeeinBlue account.

Get an API token. Open your TeeinBlue account's API Tokens settings, create a new token, and grant it the mcp:access ability. That single ability unlocks every tool in this guide. Copy the token now — it's shown once.
Point your client at the endpoint in the portal Ai Assistant MCP, with the token as a bearer header.
Verify. Ask your assistant "What campaigns do I have on TeeinBlue?" — it should call list-campaigns-tool and return your data.

Claude Web

Go to Settings → Connectors → Add → Add custom connector, enter Teeinblue as the name and https://api.teeinblue.com/mcp as the URL, then click Continue.

Select No sign-in, then add a request header: name authorization, value Bearer <YOUR_API_TOKEN>, then click Add.

Claude Desktop

There are two ways to connect. You can use Add custom connector, the same way as Claude Web, or you can use the alternative method below:

Open Settings → Developer → Edit Config, or edit the file directly:
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json
Add the following (Node.js must be installed), then save and restart Claude Desktop.

   {
     "mcpServers": {
       "teeinblue": {
         "command": "npx",
         "args": [
           "mcp-remote",
           "https://api.teeinblue.com/mcp",
           "--header",
           "Authorization: Bearer <YOUR_API_TOKEN>"
         ]
       }
     }
   }

Claude Code

Run this command in your terminal:

   claude mcp add --transport http teeinblue https://mcp.teeinblue.com/mcp --header "Authorization: Bearer <YOUR_MCP_TOKEN>"

Run /mcp inside Claude Code to confirm Teeinblue is connected.

Codex

You can connect through Codex settings or edit its configuration file. Choose one method.

First, go to Teeinblue Portal > AI Assistant (MCP) to get your MCP token and Endpoint URL. Under Add Teeinblue to your AI client > Choose your AI client > Codex, you can also find Teeinblue's configuration guide.

Method 1: Add a connection in Codex

Go to Codex > Settings > Plugins > Add > Add MCP server to add your custom connection.

In Codex > Settings > Plugins > Add > Add MCP server, configure a remote HTTP server named teeinblue using the following values:

URL: the Endpoint URL from Teeinblue Portal > AI Assistant (MCP), such as https://api.teeinblue.com/mcp for production.
Headers: key Authorization, value Bearer <YOUR_MCP_TOKEN>. Replace the placeholder with your token, keeping the space after Bearer.
Bearer token env var: leave empty when using the header above.

Save the connection, then fully quit and restart Codex. The screenshot above uses a staging endpoint; use the endpoint from your own Teeinblue Portal.

To edit an existing connection, go to Codex > Settings > Plugins > MCPs > teeinblue > gear icon, update the same fields, click Save, then restart Codex again.

Method 2: Edit the configuration file

On your computer, open the Codex configuration file in a text editor:
- macOS: ~/.codex/config.toml
- Windows: %USERPROFILE%\.codex\config.toml

Add the following block. Use the Endpoint URL and token from Teeinblue Portal > AI Assistant (MCP). If a [mcp_servers.teeinblue] block already exists, update it instead of adding a duplicate.

[mcp_servers.teeinblue]
url = "https://api.teeinblue.com/mcp"
http_headers = { "Authorization" = "Bearer <YOUR_MCP_TOKEN>" }

Save the file, then fully quit and restart Codex to load the MCP configuration.

Check the connection

In Codex > Settings > Plugins > MCPs, find teeinblue and make sure its toggle is on.

In Codex > a new chat, ask: "What campaigns do I have on Teeinblue?" Codex should use the Teeinblue MCP tools to return your campaigns.

MCP Tool List

Below are all the actions the AI Assistant (MCP) can perform

Guided help

Action	Description	Example prompt	Tool ID
Get a step-by-step guide	Gives the assistant a walkthrough for a common job (create an artwork, fulfill orders, edit a campaign), so it knows what to ask you and which actions to run.	"I want to create a new personalized artwork — can you walk me through it?"	`get-workflow-guide-tool`

Campaigns — create & manage

A "campaign" is a sellable listing — the container that bundles a product, its photos, and its artwork together.

Action	Description	Example prompt	Tool ID
Start a new campaign	Creates a fresh, empty campaign ready to be built out.	"Create a new campaign called 'Fall Pumpkin Mugs.'"	`create-campaign-tool`
Duplicate a campaign	Clones an existing campaign as a starting point for a new one.	"Duplicate my 'Christmas Sweater' campaign as a starting point for Easter."	`clone-campaign-tool`
Edit campaign details	Updates the name, vendor, product type, tags, or how products are displayed.	"Rename this campaign to 'Retro Sunset Tees' and tag it bestseller."	`update-campaign-tool`
Change a campaign's thumbnail	Sets or removes the campaign's main (featured) image, from an image link or a file you upload. On Shopify it becomes the product's first image. Live stores keep the old image until you push updates.	"Use this image as the thumbnail for my 'Retro Sunset Tees' campaign."	`update-campaign-thumbnail-tool`
Change a campaign's store URL	Edits the URL handle (the part after /products/) of a campaign on a Shopify store it's published to. Live stores keep the old URL until you push updates.	"Change the URL of my 'Retro Sunset Tees' campaign on my Shopify store to 'retro-sunset-tee.'"	`update-campaign-handle-tool`
Delete a campaign	Permanently removes a campaign. This cannot be undone.	"Delete the test campaign I made yesterday."	`delete-campaign-tool`
Look up one campaign	Pulls the full picture of a single campaign — products, mockups, artwork, and where it's published.	"Show me everything on the 'Dog Mom Hoodie' campaign."	`get-campaign-tool`
Search all campaigns	Browses or searches your full list of campaigns.	"List all my campaigns tagged 'summer.'"	`list-campaigns-tool`
Archive many campaigns	Hides many campaigns at once without deleting them.	"Archive all my 'Spring Clearance' campaigns."	`bulk-archive-campaign-tool`
Restore many archived campaigns	Brings many archived campaigns back to active status at once.	"Bring back all the Halloween campaigns from the archive."	`bulk-unarchive-campaign-tool`
Convert a campaign to a Boundless product	Copies a campaign (artworks and mockups included) into Boundless platform products. The result is not published until you publish it.	"Convert my 'Retro Sunset Tees' campaign into Boundless products."	`convert-campaign-to-platform-product-tool`

Building a campaign

Adding the product, its photos, and the design onto a campaign — in that order.

Action	Description	Example prompt	Tool ID
Add a product to a campaign	Attaches a base product (a mug, a t-shirt, etc.) to a campaign.	"Add the classic mug to my 'World's Best Grandma' campaign."	`attach-product-to-campaign-tool`
Edit a product's listing details	Changes its display title and ordering within the campaign.	"Change this product's title to 'Ceramic Coffee Mug — 11oz.'"	`update-campaign-product-tool`
Add a product photo	Attaches a mockup image (a photo showing off the product) to a campaign's product.	"Attach this new mockup photo to the mug on my campaign."	`attach-mockup-to-campaign-product-tool`
Edit a product photo's settings	Changes alt text, background color, and similar mockup settings.	"Set this mockup's background to white and add alt text 'mug on wood table.'"	`update-campaign-mockup-tool`
Place a design on the product	Drops an artwork from the library onto the printarea.	"Put the 'Retro Sunset' design onto the printarea on this mug."	`attach-artwork-to-campaign-tool`
Reposition a placed design	Moves or resizes a design that's already sitting on the product.	"Make the design 20% bigger and move it slightly left."	`update-campaign-artwork-tool`
Add variants to many campaigns	Adds a product's variants (sizes/colors) to every campaign that already uses that product — all available variants, or only the ones you choose. Link them to a photo afterwards.	"Add the 3XL size of the classic t-shirt to all my campaigns that use it."	`bulk-attach-variants-to-campaigns-tool`
Remove variants from many campaigns	Takes chosen sizes/colors of a product off every campaign that uses it (or only the campaigns you pick). Previews first. Photos that only those variants used are removed too, unless you keep them. Your product catalog isn't changed. Handy for getting under Shopify's 250-variant limit.	"Remove the 3XL size of the classic t-shirt from all my campaigns, preview first."	`bulk-detach-variants-from-campaigns-tool`
Remove a product from many campaigns	Detaches a product from many campaigns at once.	"Remove the tote bag from these three campaigns."	`bulk-detach-product-from-campaigns-tool`
Add a product photo to many campaigns	Attaches a mockup to many campaigns at once.	"Add the new white-background mockup to all my mug campaigns."	`bulk-attach-mockup-to-campaigns-tool`
Remove product photos from many campaigns	Takes mockups off many campaigns at once.	"Remove the old black-background mockup from every campaign."	`bulk-remove-mockups-from-campaigns-tool`
Add one library image as a campaign photo	Creates a single campaign photo from an image in your mockup library.	"Add this lifestyle image from my mockup library to the mug."	`create-campaign-mockup-tool`
Edit a photo's layers	Moves, resizes, adds, removes or reorders layers on a campaign photo, such as the printarea box or a shadow overlay.	"Add a shadow overlay on top of this mug photo."	`update-mockup-layer-tool`
Link variants to the right photo	Chooses which campaign photo shows for which variants (by color, size, or specific variants).	"Show the red mockup for all red variants, any size."	`bulk-assign-campaign-mockup-variants-tool`
Place a design on many campaigns	Puts an artwork onto printareas across many campaigns at once.	"Add the 'Retro Sunset' design to all my sunset campaigns."	`bulk-attach-artwork-to-campaigns-tool`
See a photo rendered	Shows how a product mockup, or a campaign mockup with its artwork, looks right now. Nothing is saved.	"Show me what the front mockup on this mug looks like."	`render-mockup-tool`
Test how the design prints	Generates a test print file for a campaign using sample personalization (name, photo, etc.), like the portal's Design testing page. Then check progress and view the result.	"Generate a test design for my 'Pet Portrait' campaign with the name 'Bella.'"	`generate-test-design-tool` · `get-test-design-tool`

Design library — find what you've got

These look up what's already in your library — products, photos, artworks, clipart, and fonts. To create or change any of these, see the sections that follow.

Action	Description	Example prompt	Tool ID
Browse & inspect products	Search the product catalog, or pull full detail on one product.	"Show me all mug products in my catalog."	`list-products-tool` · `get-product-tool`
Browse & inspect product photos	Search available mockup images, or pull detail on one.	"Find mockup photos for the classic t-shirt."	`list-mockups-tool` · `get-mockup-tool`
Browse & inspect printareas	Search defined artwork placement areas, or pull detail on one.	"What printareas are defined on this hoodie mockup?"	`list-printareas-tool` · `get-printarea-tool`
Browse & inspect artworks	Search uploaded designs, or pull detail on one.	"Find all my artworks tagged 'Christmas.'"	`list-artworks-tool` · `get-artwork-tool`
Browse artwork categories	Lists how designs are grouped/categorized.	"What artwork categories do I have set up?"	`list-artwork-categories-tool`
Browse clipart	Searches the clipart library and its categories.	"Show me clipart in the 'Animals' category."	`list-cliparts-tool` · `list-clipart-categories-tool`
Browse fonts	Lists fonts available for text-based designs.	"What fonts can I use for text designs?"	`list-fonts-tool`
Browse layered image assets	Lists reusable image layers used inside designs, and the folders they're filed in.	"List the layer images available for my designs."	`list-layer-images-tool` · `list-layer-image-categories-tool`
See a layer image	Shows you an image layer so you can check it.	"Show me that background layer image."	`view-layer-image-tool`
Browse product variants	Lists a product's sizes/colors with SKU, price, weight and availability, with filters.	"List all the unavailable variants of the classic t-shirt."	`list-product-variants-tool`
Browse the mockup library	Lists the background and lifestyle images you can turn into product photos.	"What images are in my mockup library?"	`list-mockup-library-tool`
Search inside artworks	Finds artworks by what they contain — a layer type, a font, a clipart folder, a setting — without opening them one by one.	"Which of my artworks use the 'Pets' clipart folder?"	`search-artworks-tool`

Design your artworks

Create and edit your designs directly — no need to open the artwork editor.

Action	Description	Example prompt	Tool ID
Create a new artwork	Builds a brand-new design from scratch — the canvas size plus the text, photo, and clipart layers that go on it.	"Create a new 12×12 in artwork called 'Custom Pet Portrait' with a photo layer and a name text layer."	`create-artwork-tool`
Edit an artwork	Changes an existing design — its name, size, layers, or settings.	"On my 'Pet Portrait' artwork, make the canvas 16×16 and rename it 'Pet Portrait XL.'"	`update-artwork-tool`
Tweak a single layer	Adjusts just one layer of a design without touching the rest — handy for a quick color or text change.	"Change the name text on my 'Pet Portrait' artwork to gold."	`update-artwork-layer-tool`
Preview a design with sample details	Shows how a design looks once it's filled in with real personalization — a name, a photo, a date.	"Show me what the 'Pet Portrait' artwork looks like with the name 'Bella.'"	`render-design-preview-tool` · `get-design-preview-tool`
Duplicate an artwork	Copies a design as a starting point for a new one.	"Duplicate my 'Pet Portrait' artwork so I can make a cat version."	`duplicate-artwork-tool`
Delete an artwork	Removes a design you no longer need.	"Delete the test artwork I made yesterday."	`delete-artwork-tool`
Archive or restore an artwork	Hides a design from your main list without deleting it, or brings it back.	"Archive my old 'Summer 2024' artwork."	`archive-artwork-tool` · `unarchive-artwork-tool`
Check a design for problems	Looks for errors and warnings in a design before it's saved.	"Check my 'Pet Portrait' artwork for problems."	`validate-artwork-tool`
See your artwork	Shows the design's picture so you can check what you just created or edited.	"Show me the 'Pet Portrait' artwork."	`view-artwork-tool`
See the buyer's form	Shows the personalization form customers will see — each field, in order, with defaults, options and conditions.	"Show me the form buyers see for the 'Pet Portrait' artwork."	`get-form-preview-tool`
Connect layers to each other	Looks up what one layer can automatically fill in from another (for example, a text layer that copies a name typed elsewhere).	"Make the caption text fill itself from the name field."	`list-retrieval-values-tool`
Look up how layers work	Gives the assistant the reference for every layer type and its settings, so it builds designs correctly.	"What can a photo layer do?"	`get-layer-schema-tool`
Edit many artworks at once	Changes layer settings (or the name/folder) across many designs at once, picking them by id or by what they contain. Previews the before/after first, and can be undone with the restore tool.	"Rename 'Cat' to 'Kitten' in the labels of all my 'Pet' artworks."	`bulk-update-artworks-tool`
Upgrade old artworks to Artwork 2.0	Converts older (1.0) designs to the new format. Previews first; designs that can't be converted completely are skipped and listed.	"Convert all my old artworks to Artwork 2.0, preview first."	`bulk-convert-artworks-tool`
Delete many artworks	Removes many designs at once.	"Delete all my test artworks."	`bulk-delete-artworks-tool`
Archive or restore many artworks	Hides many designs from your main list without deleting them, or brings them back.	"Archive all my 'Summer 2024' artworks."	`bulk-archive-artworks-tool` · `bulk-unarchive-artworks-tool` · `bulk-restore-artworks-tool`

As it builds, the assistant checks your design for problems and reads how each layer is put together behind the scenes — you don't need to ask for this.

Manage products & product photos

Set up the base products and the mockup photos that campaigns are built from.

Action	Description	Example prompt	Tool ID
Edit products	Updates product titles, internal names and tags, descriptions, how colors/sizes are displayed, default options, and archive status — for up to 50 products at once. Can preview first.	"Rename the 'Classic Mug' product to 'Ceramic Mug 11oz' and tag it internal-bestseller."	`update-products-tool`
Edit variants in bulk	Changes SKU, color, size, weight, price, compare-at price, cost, or availability for many variants at once, by variant or by color/size.	"Raise the price of all XL variants of the classic t-shirt by $2."	`bulk-update-product-variants-tool`
Delete variants in bulk	Removes many variants from a product.	"Remove the 3XL size from the classic t-shirt."	`bulk-delete-product-variants-tool`
Manage printareas	Creates, resizes, renames or deletes several printareas of a product in one call. Previews first; deleting a printarea that's in use is refused unless you confirm.	"Add a 'Back' printarea of 4000×4000 px to the classic t-shirt."	`bulk-manage-printareas-tool`
Create a product photo	Builds a mockup for a product from a mockup library image.	"Create a mockup for the classic mug from this wood-table image."	`create-mockup-tool`
Edit a product photo	Changes a mockup's alt text, position, default background color and color-as-variant setting, or replaces its whole layer list.	"Set this mockup's background to white."	`update-mockup-tool`
Edit a photo's layers	Moves, resizes, adds, removes or reorders layers on a product mockup, such as the printarea box or a shadow.	"Add a printarea layer to the front of this mug mockup."	`update-mockup-layer-tool`
Look up photo layers	Gives the assistant the reference for mockup layers and their settings.	"What kinds of layers can a mockup have?"	`get-mockup-layer-schema-tool`
Duplicate or delete photos	Copies up to 50 mockups (layers and assigned variants included), or deletes them. Deleting previews first and is refused if campaigns still use the mockup, unless you confirm.	"Duplicate this mockup three times."	`bulk-duplicate-mockups-tool` · `bulk-delete-mockups-tool` · `delete-mockup-tool`
Link variants to the right photo	Decides which mockup shows for which variants, by color and size.	"Use the red mockup for every red variant."	`bulk-assign-mockup-variants-tool`
Push photo changes to campaigns	Copies edits you made on a product photo onto the campaigns that use it (replaces edits made on those campaign photos, so it previews first).	"Push my updated mug mockup to all campaigns that use it."	`bulk-sync-mockups-to-campaigns-tool`

Manage your design library

Add to and tidy up the assets your designs are built from — clipart, layer images, and the folders that hold them.

Action	Description	Example prompt	Tool ID
Add & organize clipart	Upload new clipart, rename or recolor it, remove pieces you don't need, and sort everything into folders.	"Upload these five animal cliparts and put them in a new 'Pets' folder."	`create-clipart-upload-tool` · `confirm-clipart-upload-tool` · `update-clipart-tool` · `delete-clipart-tool` · `create-clipart-category-tool` · `update-clipart-category-tool` · `delete-clipart-category-tool`
Add layer images	Bring reusable image layers into your library — either from a link or by uploading your own files.	"Import this background image from this URL into my layer images."	`upload-layer-image-tool` · `create-layer-image-upload-tool` · `confirm-layer-image-upload-tool`
Organize artworks into folders	Create, rename, or remove the categories your designs are grouped into.	"Make a new artwork folder called 'Winter 2026' and move my snowman design into it."	`create-artwork-category-tool` · `update-artwork-category-tool` · `delete-artwork-category-tool`
Add color swatches, choices and map styles	Adds items that don't need an image file: color swatches, "pick one" choices, and map styles.	"Add red, blue and gold swatches to my 'Frame colors' folder."	`create-clipart-items-tool`
Add fonts to a font folder	Puts fonts you've uploaded into a font folder, so customers can choose them on a text design.	"Add my 'Brush Script' font to the 'Fancy fonts' folder."	`add-font-to-category-tool`
Replace clipart thumbnails	Swaps the preview picture of one clipart, or up to 20 at once, from image links.	"Replace the thumbnails of these cliparts with these images."	`upload-asset-thumbnail-tool` · `bulk-upload-asset-thumbnails-tool`
Add images to the mockup library	Imports an image from a link, or from a file you upload, into your mockup library.	"Import this wood-table photo into my mockup library."	`upload-mockup-library-image-tool` · `create-layer-image-upload-tool` · `confirm-mockup-library-upload-tool`

Upload blocked?

Add teeinblue-cdn.nyc3.digitaloceanspaces.com to your AI assistant's allowed domains (in Claude: Settings > Capabilities > Allow network egress > Additional allowed domains), then try again.

Reusable option fields (Global Options)

A Global Option is a personalization field you set up once and reuse across many artworks — like a "Pet name" text box or a "Breed" picker. Change it in one place and every artwork that uses it updates.

Action	Description	Example prompt	Tool ID
Create a reusable option	Sets up a new shared field you can drop into any artwork.	"Create a global option called 'Pet name' that lets buyers type a name."	`create-global-option-tool`
Edit a reusable option	Updates a shared field. This changes it in every artwork that uses it.	"Update my 'Breed' option to include a few more dog breeds."	`update-global-option-tool`
Duplicate an option	Copies a shared field as a starting point for a new one.	"Duplicate my 'Pet name' option so I can make a 'Pet nickname' version."	`duplicate-global-option-tool`
Delete an option	Removes a shared field you no longer use.	"Delete the old 'Test field' global option."	`delete-global-option-tool`
Browse your options	Lists the shared fields you've set up.	"What global options do I have set up?"	`list-global-options-tool`

Publishing & store sync

Getting a finished campaign live on a store, and keeping it up to date.

Action	Description	Example prompt	Tool ID
Publish many campaigns at once	Bulk-publishes a batch of campaigns to a store in one go.	"Publish all my draft Halloween campaigns to Etsy at once."	`bulk-publish-campaign-tool`
Unpublish many campaigns at once	Takes many live campaigns down from a store in one go.	"Take all my Halloween campaigns down from the store."	`bulk-unpublish-campaign-tool`
Push updates to live listings	Syncs edits — title, tags, price, images, and more — to a store the campaigns are already published on, for one or many campaigns. You can leave out parts you don't want to overwrite (for example, keep the store's description).	"Sync my new price and tags to the live store listings, but don't touch the description."	`bulk-sync-campaign-tool`
Browse Boundless products	Lists and searches your Boundless products (converted from campaigns or created in the portal), by name, artwork used, publish status, or the campaign they came from.	"Which published Boundless products use my 'Retro Sunset' artwork?"	`list-platform-products-tool`
Publish or update Boundless products	Publishes many Boundless products at once, or updates ones already live so they pick up your latest artworks and mockups. Shopify and Etsy products must be published in the portal.	"I edited the 'Retro Sunset' artwork — update all the live Boundless products that use it."	`bulk-publish-platform-products-tool`
See where a campaign is published	Lists which connected stores carry a given campaign.	"Which stores is my 'Retro Sunset Tees' campaign live on?"	`list-campaign-instances-tool`
See all connected stores	Lists every store this account is connected to.	"What stores do I have connected to Teeinblue?"	`list-instances-tool`

Orders & fulfillment

Once a customer buys — checking orders, fixing designs, and handling shipping.

Action	Description	Example prompt	Tool ID
Browse & inspect orders	Search orders by store, status, or date, or pull full detail — pricing, customer, shipping, and each item's design — on one.	"Show me pending orders from last week, then pull up order #10493."	`list-orders-tool` · `get-order-tool`
Re-render a design	Regenerates one design that failed to render, or a batch of them, and can bump each to its artwork's latest version.	"Regenerate all failed designs from this week using the latest artwork."	`regenerate-design-tool` · `bulk-regenerate-designs-tool`
Download print-ready files in bulk	Queues a zip of completed designs across many orders, then checks when it's ready to download.	"Bundle up print files for today's orders and tell me when it's ready."	`bulk-download-order-designs-tool` · `get-bulk-download-status-tool`
Export orders to a spreadsheet	Exports order line items to CSV — using a fulfillment partner's format or your own saved template.	"Export this week's orders to CSV using my Printful template."	`export-orders-tool` · `list-export-templates-tool`
Save shipment tracking	Records a tracking number and carrier against an order item.	"Add tracking number 1Z999 for this order via UPS."	`update-order-item-tracking-tool`
Send tracking to the store	Pushes saved tracking info to the store platform so the customer can see it.	"Push that tracking number to Shopify so the customer sees it."	`sync-order-item-tracking-tool`

Updated on: 04/11/2026

Was this article helpful?

Thank you!