# Toolbox POD AI connector

Tell your AI. We print it.

The Toolbox POD connector lets your AI app work in your Toolbox POD account. Ask it for a shirt and it can
design it, show you mockups, price and order it, and (invite-only, coming soon) publish it to your Shopify store. It uses an open standard
called MCP, so the same connector works in ChatGPT, Claude, Claude Code, Codex, Cursor, Hermes and any other app
that supports MCP servers.

Your AI works as you. It can do what you could do on our website, and never more. Nothing is charged until you set
a spending limit.

Step-by-step setup with copy buttons: https://toolboxpod.com/mcp

## Server address

One address for every app:

```
https://mcp.toolboxpod.com/mcp
```

No code and no API key. You sign in to Toolbox POD and click **Allow**.

## Connect your app

### ChatGPT

1. On chatgpt.com, open **Plugins**, click **+**, then **Add custom MCP server**.
2. Name it **Toolbox POD** and paste the server address. Authentication: **OAuth**. Leave the client fields empty.
3. Click **Continue**, then **Create**. Sign in to Toolbox POD and click **Allow**.
4. In a chat, type **@** and pick Toolbox POD.

Adding your own server needs Developer mode, on chatgpt.com.

### Claude

1. In Claude, open **Customize**, then **Connectors**, click **+**, then **Add custom connector**.
2. Name it **Toolbox POD**, paste the server address and click **Continue**.
3. A Toolbox POD page opens. Sign in and click **Allow**.

On a Team or Enterprise plan, an Owner adds the connector for everyone first.

### Claude Code

1. In your terminal:

   ```sh
   claude mcp add --transport http --scope user toolbox-pod https://mcp.toolboxpod.com/mcp
   ```

2. In Claude Code, type `/mcp`, pick **toolbox-pod**, then **Authenticate**.
3. Your browser opens Toolbox POD. Sign in and click **Allow**.

### Codex

1. In your terminal:

   ```sh
   codex mcp add toolbox-pod --url https://mcp.toolboxpod.com/mcp
   codex mcp login toolbox-pod
   ```

2. Your browser opens Toolbox POD. Sign in and click **Allow**.

Codex app: **Settings**, **MCP servers**, **Add server**, **Streamable HTTP**, then paste the server address.

### Cursor

The server entry:

```json
{"mcpServers":{"toolbox-pod":{"url":"https://mcp.toolboxpod.com/mcp"}}}
```

**Cursor app.** Open a project folder, then **Cursor Settings**, **MCP**, **Add**, and paste the entry. Click
**Connect** beside toolbox-pod, sign in and click **Allow**. The setup page also has a one-click **Add to Cursor**
button for the desktop app.

**Cursor CLI.**

1. Save the entry as `.cursor/mcp.json` at the root of a git repo. Outside a repo, the CLI does not see it.
2. In that repo, in your terminal:

   ```sh
   cursor-agent mcp enable toolbox-pod
   cursor-agent mcp login toolbox-pod
   ```

3. Your browser opens Toolbox POD. Sign in and click **Allow**.

Run login once. If it then says "Connection failed", wait a moment: `cursor-agent mcp list` shows it ready.

### Hermes

```sh
hermes mcp add toolbox-pod --url https://mcp.toolboxpod.com/mcp --auth oauth
hermes mcp login toolbox-pod
hermes mcp test toolbox-pod
```

Login opens your browser: sign in and click **Allow**. The test lists the Toolbox POD tools.

### OpenClaw (community-tested)

```sh
openclaw mcp add toolbox-pod --url https://mcp.toolboxpod.com/mcp --transport streamable-http --auth oauth
openclaw mcp login toolbox-pod
```

These steps come from people who use it. Tell us if they change.

### Any other MCP app

Add a remote server (Streamable HTTP) with the server address. Pick OAuth if it asks; there is no API key. The app
finds the sign-in pages by itself.

### Check it works

Ask: "Who am I on Toolbox POD?" If it names your account, you're connected.

## Signing in and approving

When you connect, a Toolbox POD page opens. Sign in (or sign up), check who is asking and which account you are
signed in to, and click **Allow**.

- The connection acts as you, with your role (Owner, Manager or Viewer) and the stores you can use.
- It is re-checked on every request. If your role changes or you are removed from the account, the connection
  follows at once.
- To stop it, click **Disconnect** on the Connections page: https://toolboxpod.com/app/connections. It stops on
  its very next request.

## What you can ask it to do

- **Design.** Describe a design, share a reference image, or both, and Toolbox AI draws it, print ready. Try
  another version, ask for changes, get name ideas. Art you already have works too: upload a PNG or a link to one.
- **Mockups.** See a design on a shirt in any color, on a lay-flat, folded or model photo. Ask for a new scene and
  keep it as a mockup template for your designs.
- **Order.** Get today's prices, a quick estimate, then a draft order with its exact total. It pays only inside the
  limit you set, and checks orders, holds, packages and tracking.
- **Publish to Shopify.** Invite-only, coming soon (request access at toolboxpod.com/shopify). Make a product from an
  approved design with your colors, sizes and retail prices, publish it to your store, or match products you already
  sell. Until your account has access, these tools aren't listed.
- **Import a Shopify store.** Ask it to connect the products you already sell: it lists them, uploads each print
  file, shows you the shirt and the color and size matches, then connects them 25 at a time. Your titles, photos,
  prices and descriptions stay as they are; Toolbox fulfills the connected variants.
- **Manage your WooCommerce listings.** With a WooCommerce store connected: publish a design to it (it shows you a
  preview first and publishes after you say yes), see your products, change them, or take them off the store.
- **Get help.** Open a support request about an order and check on it.

Same prices as the website. No fee to connect and no plan needed to order.

## Limits and safety

- **Nothing paid by default.** Until the account Owner sets a spending limit for the connection on our website, your
  AI can prepare orders and quotes, and you pay for them yourself.
- **ChatGPT and Claude pay on our website.** In ChatGPT and in Claude on the web, your AI never pays for an order: it
  gives you a link to toolboxpod.com, where you sign in, check the total and pay.
- **Your spending limit.** Set a cap per order, a monthly budget, or both, on the Connections page. An order over the
  limit is held with a reason and nothing is charged. Your AI can't raise its own limit.
- **Ask before each order.** On by default when you turn paying on. Each order waits for you to pay it on the
  website, even inside the limit.
- **Only the Owner pays.** Paying needs the account Owner. Managers and Viewers can't spend.
- **Hands off your card.** No tool can see or change saved cards, staff, API keys, spending limits or connections.
- **It asks first.** Tools that change or spend something are marked, so your AI app checks with you before it
  runs them.
- **AI images.** 20 free AI images a month with a card on file, at most 15 a day. Each design version or AI mockup
  background uses one. A Plus or Pro plan adds more: https://toolboxpod.com/pricing
- **Request limits.** Up to 60 requests a minute per connection. If your AI goes faster, it is told to wait a moment.

## Tools

Your AI app only sees the tools your connection allows. These tool names are what your app shows when it calls
one.

### Core tools

Listed on every connection, within what your role and connection allow.

| Tool | What it does |
| --- | --- |
| `whoami` | Your account, role and stores, and whether orders can be paid yet, with the next steps if not |
| `list_garments` | The shirts you can print on: colors, sizes, print areas and artwork rules |
| `get_rates` | Today's prices: one shirt per garment and size, plus the flat shipping fee |
| `create_estimate` | A quick price for a print run, without creating anything |
| `upload_artwork` | Upload a PNG, or a link to one, and check how large it can print |
| `list_artwork` | Your uploaded artwork, newest first |
| `create_design` | Place your artwork on the front, back or both of a shirt |
| `get_design` | One design: its sides, placement, warnings and whether it is approved |
| `list_designs` | Your designs, newest first |
| `activate_design` | Approve a design for printing so it can be ordered |
| `generate_design` | Draw a design with Toolbox AI from a description or a reference image |
| `get_generation_job` | The status and versions of an AI design |
| `use_design_version` | Keep an AI version and make its print file |
| `get_mockup` | Show a design on a shirt in one color and side |
| `list_mockup_looks` | Our model and photo looks for a shirt, with the colors each has |
| `create_order` | A draft order for one US recipient, with its total |
| `update_order` | Change the recipient or lines of an unpaid order |
| `discard_order` | Throw away an unpaid order |
| `purchase_order` | Pay for an order with the account's card, inside your spending limit (not in ChatGPT or Claude on the web) |
| `retry_order` | Try paying for a held order again, never charging twice (not in ChatGPT or Claude on the web) |
| `get_checkout_link` | A link to pay for an order yourself on our website, after checking its total |
| `list_orders` | Your orders, newest first, with their status |
| `get_order` | One order: lines, total, status, any hold reason, packages and tracking |
| `create_support_request` | Send our support team a message about an order |

### More tools

Listed when **More tools** is switched on for the connection on the Connections page. The product and Shopify import
tools are the exception: an account with Shopify access gets them whether More tools is on or off. Selling on Shopify
is invite-only, coming soon (request access at toolboxpod.com/shopify): without access they are not listed. The
WooCommerce tools work the same way for an account with a WooCommerce store, and aren't listed without one.

| Tool | What it does |
| --- | --- |
| `list_spending_limits` | What this connection may spend, and what is left |
| `get_billing` | Charges, refunds, receipts and payment attempts |
| `get_support_request` | One support request and whether our team has it |
| `upload_design_reference` | Upload a reference image for an AI design |
| `try_another_version` | Draw one more version of an AI design |
| `request_design_changes` | Redraw a version with your changes |
| `suggest_design_names` | Up to three name ideas for a design |
| `list_mockup_templates` | The backgrounds a shirt's mockups are drawn on |
| `save_mockup_template` | Keep a background as a mockup template |
| `set_default_mockup_template` | Choose the default template for a shirt's designs |
| `set_design_mockups` | Choose the template for one design |
| `generate_mockup_image` | Draw an empty mockup background with Toolbox AI (not in Claude) |
| `get_mockup_ai_run` | The status and images of an AI mockup background |
| `list_mockup_ai_runs` | Your AI mockup backgrounds, and the AI images left this month |
| `list_products` | Your product drafts, newest first |
| `get_product` | One product draft, its Shopify matches and publishing status |
| `create_product` | A product draft from an approved design: colors, sizes and retail prices |
| `update_product` | Edit a product draft, or change a published product in its Shopify store |
| `list_store_variants` | The variants a Shopify store already sells, their matches, and suggested colors and sizes |
| `refresh_store_variants` | Refresh a Shopify store's variant list (nothing is written to Shopify; a variant deleted in Shopify has its mapping disconnected here) |
| `map_product` | Match products you already sell on Shopify to a design |
| `publish_product` | Publish a product draft to its Shopify store |
| `list_shopify_products` | The products your Shopify store already sells, with photos, and which ones Toolbox fulfills |
| `preview_shopify_import` | Before connecting: the shirt, each variant's color and size match, and the print warnings |
| `import_shopify_products` | Connect existing Shopify products, up to 25 at a time, so Toolbox fulfills them. Their titles, photos and prices don't change |
| `list_woocommerce_products` | The products published to your WooCommerce stores, their state, prices and pages |
| `publish_to_woocommerce` | Publish a design to your WooCommerce store: a preview first, then publish after you say yes |
| `update_woocommerce_product` | Change a published WooCommerce product: title, description, colors, sizes, prices, status, categories, tags |
| `remove_woocommerce_product` | Take a WooCommerce product off your store: back to a draft, or to the store's trash |
| `settle_test_attempt` | Older test connections only: settle a simulated payment |

## Troubleshooting

- **It says it isn't connected, or asks you to sign in again.** Sign in again from your app. If that fails, click
  **Disconnect** on the Connections page, then connect again.
- **"Unauthorized" about an hour after signing in (Cursor CLI).** A second login replaced the first. Run
  `cursor-agent mcp login toolbox-pod` once and finish it, restart any running `cursor-agent`, then disconnect the
  older Cursor connection on the Connections page.
- **A tool is missing.** Your role or the connection doesn't allow it, or it is a More tool: switch on More tools on
  the Connections page, then reconnect your app so its list refreshes.
- **An order is held.** Ask your AI why: it names the fix and the website page for it, such as turning paying on,
  raising the limit or adding a card. After the fix, ask it to try again. Nothing was charged.
- **Out of AI images.** The free allowance resets on the 1st of each month (UTC). A Plus or Pro plan adds more.
- **An older test connection.** Orders through it are simulated and never shipped, and it can't change your Shopify
  store. Connect your app again for real orders and publishing.
- **Connected with the old address** (`https://toolboxpod.com/mcp`)? It still works. Each address keeps its own
  sign-in.

Still stuck? Email support@toolboxpod.com.

## More

- Setup page with copy buttons: https://toolboxpod.com/mcp
- Developers (REST API, keys and webhooks): https://toolboxpod.com/developers
- Privacy policy: https://toolboxpod.com/policies/privacy
- Manage your connections: https://toolboxpod.com/app/connections