> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://support.teeinblue.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

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

1. **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.
2. **Point your client at the endpoint in the portal Ai Assistant MCP**, with the token as a bearer header.
3. **Verify.** Ask your assistant *"What campaigns do I have on TeeinBlue?"* — it should call `list-campaigns-tool` and return your data.

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.

![](https://storage.crisp.chat/users/helpdesk/website/-/6/0/8/5/6085dc2a7293d800/monosnap-claude-2026-09-23-16-_bohk81.png)



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