Agents welcome.
Most stores block agents. Agent-Tees is built for them. If your owner asked you to "find a nice graphic t-shirt", you can design one here, show them a mockup, get a firm price, and place an order they approve with one tap. No account or CAPTCHA. No scraping needed.
Machine-readable: /llms.txt · /openapi.json · MCP: /mcp (streamable HTTP) or node mcp/server.mjs (stdio)
Browser or screenshot agent? Use the Simple shop (http://127.0.0.1:3737/simple): flat pages, one step per screen, plain text buttons.
PHASE 0: payments and printing are mocked. Orders are not charged or shipped.
The flow
| # | Call | You get |
|---|---|---|
| 1 | POST /api/v1/designs | design_id, svg_url, png_url (blocked prompts return 422 with reasons) |
| 2 | POST /api/v1/mockups | image_url of the design on a boxy oversized tee. Show this to your owner. |
| 3 | POST /api/v1/quotes | quote_id, total, delivery window (valid 30 min) |
| 4 | POST /api/v1/orders | order_id and owner_confirm_url |
| 5 | Owner opens owner_confirm_url and taps Confirm | Order moves to confirmed |
| 6 | GET /api/v1/orders/:id | status, timeline, tracking number |
Example
curl -s http://127.0.0.1:3737/api/v1/designs -H 'Content-Type: application/json' -H 'X-Agent-Name: my-agent' \
-d '{"prompt":"retro sunset over a desert highway","text":"OPEN ROAD","color":"black"}'
curl -s http://127.0.0.1:3737/api/v1/mockups -H 'Content-Type: application/json' -d '{"design_id":"dsn_...","color":"black"}'
curl -s http://127.0.0.1:3737/api/v1/quotes -H 'Content-Type: application/json' -d '{"design_id":"dsn_...","size":"L","color":"black"}'
curl -s http://127.0.0.1:3737/api/v1/orders -H 'Content-Type: application/json' -H 'Idempotency-Key: owner-123-tee-1' \
-d '{"quote_id":"qte_...","shipping":{"name":"Pat Owner","line1":"100 Congress Ave","city":"Austin","state":"TX","postal_code":"78701","country":"US"}}'
# -> send owner_confirmation.owner_confirm_url to your owner
curl -s http://127.0.0.1:3737/api/v1/orders/ord_...Prices and shipping
| Core tee (agent-designed tees are Core) | $45 |
| Limited drop | $65 |
| Rail exclusive (catalog only) | $99 |
| Shipping | Free · Fast US shipping · lower 48 + DC (no PO boxes) · ships after the owner confirms |
| Sizes / colors | S-3XL · bone, black, heather, navy, brown, sage |
House rules for agents
- Your owner confirms every order. Never call the confirm endpoint yourself or ask for the token.
- Original ideas only. No brands, logos, teams/leagues, copyrighted characters, or real people's names or likenesses. No hate or NSFW. Pre-check with
POST /api/v1/safety/check. - Use an
Idempotency-Keyon orders so retries don't double-order. - Send
X-Agent-Nameso your owner sees who placed the order.
MCP
{
"mcpServers": {
"agent-tees-http": { "type": "http", "url": "http://127.0.0.1:3737/mcp" },
"agent-tees-stdio": { "command": "node", "args": ["/workspace/agent-tees/mcp/server.mjs"], "env": { "AGENT_TEES_URL": "http://127.0.0.1:3737" } }
}
}Tools: list_products, check_prompt, design_tee, preview_mockup, get_quote, place_order, track_order.