For sellers & developers

Connect Printonic to your AI

Printonic runs a hosted MCP (Model Context Protocol) server, so you can connect Claude, Cursor, ChatGPT, or any MCP client and work with your Printonic account in natural language: browse the catalog, review your stores and products, and create listing drafts.

MCP server URL (Streamable HTTP)

https://printonic.com/api/mcp

Authenticate every request with your seller key as a bearer token: Authorization: Bearer psa_live_…

Create a seller API key

In your Printonic dashboard, open Agent Access and create a key. Choose the scopes you want the assistant to have — the read scopes (catalog:read, stores:read, products:read) are enough to browse; add listings:draft to let it create drafts.

The key is shown once. Use a separate key per assistant/workstation so you can rotate one without disrupting the others.

Add the server to your MCP client

Cursor, Claude Code, and other clients with a config file — add Printonic to your mcp.json (paste your real key):

{
  "mcpServers": {
    "printonic": {
      "url": "https://printonic.com/api/mcp",
      "headers": {
        "Authorization": "Bearer psa_live_your_key_here"
      }
    }
  }
}

Claude Desktop, ChatGPT, and other clients that connect to remote servers through their UI — add a custom / remote MCP server with the URL above and an Authorization: Bearer header set to your key.

Clients that only support local (stdio) servers — bridge to the hosted server with mcp-remote:

npx -y mcp-remote https://printonic.com/api/mcp \
  --header "Authorization: Bearer psa_live_your_key_here"

Start working

Your assistant will see the tools below. Ask it to search the catalog, list your stores, or draft a listing — everything is scoped to your account by the key.

Available tools

Tool	Scope	What it does
printonic_list_stores	stores:read	List the stores connected to your seller account.
printonic_search_catalog_products	catalog:read	Search Printonic's catalog and each product's art requirements.
printonic_get_catalog_product_detail	catalog:read	Get one catalog product with variations, SKUs, and print requirements.
printonic_list_seller_products	products:read	List your existing merchant products, optionally by store.
printonic_create_listing_draft	listings:draft	Create an approval-required (unpublished) listing draft. Never publishes or charges.

Safe by design. A key only ever touches your own account. Every tool is limited to the scopes on the key, and printonic_create_listing_draft only creates unpublished, approval-required drafts — it never publishes to a store or submits an order. Review and publish from your dashboard.