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.

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

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`
Archive a campaign	Hides a campaign from active use without deleting it.	"Archive the 'Spring Clearance' campaign, I'm done selling it for now."	`archive-campaign-tool`
Restore an archived campaign	Brings an archived campaign back to active status.	"Bring back the 'Halloween Totes' campaign from the archive."	`unarchive-campaign-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`

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`
Remove a product from a campaign	Detaches a product that's no longer needed on that campaign.	"Remove the tote bag from this campaign — I don't need that variant."	`detach-product-from-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`
Connect a product variant	Links a specific size/color variant to a mockup photo or store listing.	"Link the red XL shirt variant to the red mockup photo."	`update-campaign-variant-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`
Mark where artwork can go	Defines the printarea on a product photo where a design can be placed.	"Mark the front-center of this shirt mockup as the printarea."	`attach-printarea-to-campaign-mockup-tool`
Fine-tune the printarea	Adjusts that printarea's size, position, and rotation.	"Nudge the printarea up 10px and rotate it 5 degrees."	`update-campaign-mockup-printarea-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`

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`

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`

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 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`

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 a campaign	Sends a campaign live to a connected store.	"Publish the 'Dog Mom Hoodie' campaign to my Shopify store."	`publish-campaign-tool`
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 a campaign	Takes a live campaign down from a store.	"Take the 'Spring Clearance' campaign down from my store."	`unpublish-campaign-tool`
Push updates to a live listing	Syncs edits — title, tags, price, images, and more — to a store the campaign is already published on.	"Sync my new price and tags to the live store listing."	`sync-campaign-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: 08/10/2026

Was this article helpful?

Thank you!