• DATA
  • MATCH
  • SEARCH
  • HUMAN

How to retrieve product variant IDs with your AI

Connect Printful to your AI client once. After that, you can pull exact technical IDs and specific product combinations without leaving your workspace.

Ask AI about this page

Short answer

How do I get Printful variant IDs?

Ask your AI to look up a product to see its available options. It will pull the exact IDs for every color and size combination you need. You'll get the raw data required for your code or orders.

The technical data you need.

Where your data lands.

Your AI handles the heavy lifting of digging through the Printful catalog.

DATA

Exact variant IDs

The AI pulls the unique identifiers for every specific product option. You get the precise IDs needed for programmatic orders.

MATCH

Color and size pairs

It maps specific colors to specific sizes. This ensures you aren't guessing which ID belongs to a Large Blue T-shirt.

SEARCH

Product lookups

The AI finds the right product in your catalog first. It then drills down into the specific variants you're looking for.

HUMAN

Manual verification

You review the list of IDs and combinations. You decide which ones to use in your code or your next order.

The workflow

What your AI does when you ask for IDs.

The AI acts as a bridge between your chat interface and the Printful catalog.

  1. Locate the product

    The AI searches your Printful catalog to find the specific item you're interested in.

    get_product

  2. Extract variant details

    Once the product is found, the AI pulls the specific technical details for every available option.

    get_variant

  3. Map combinations

    The AI organizes the data so you can see which ID corresponds to which color and size.

    get_variant

  4. Deliver the IDs

    The AI presents the final list of IDs and attributes directly in your chat window.

    get_variant

Try it

Copy these to start.

Use these prompts to get moving immediately.

Starting points

Replace the bracketed text with your actual product names or IDs.

Printful Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_NGJxJlhUO2p0rCjSBqjrP9tiM0SG5QRplqcJWZso/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — Printful capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "printful-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_NGJxJlhUO2p0rCjSBqjrP9tiM0SG5QRplqcJWZso/mcp"
    }
  }
}
Copy into chat04

  • Get the variant IDs for the 'Unisex Heavy Blend Hoodie' product.

  • List all color and size combinations for product ID [insert_id_here].

  • Find the specific variant ID for a Large, Black version of my t-shirt.

  • Show me all available variants for the 'Eco-Friendly Tote Bag'.

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Start here

Connect Printful once, then ask.

One connection gives your AI access to your Printful catalog. Your credentials stay encrypted and secure on our end.

Connect Printful to your AI

FAQ

How this task behaves

  • 01

    Can the AI change my product prices?

    No. The tools only allow the AI to read product and variant data.

  • 02

    Can I use this to create new products?

    No. This specific task is for retrieving existing variant information.

  • 03

    Will the AI delete any of my items?

    No. The AI has no capability to delete products or variants.

  • 04

    Do I need to provide the product ID every time?

    Not necessarily. If you provide a clear product name, the AI can find it using the product lookup tool.

  • 05

    Can the AI place an order for me?

    No. The AI retrieves the IDs you need to place orders, but it does not execute the orders itself.

  • More questions about Printful? See everything the Printful Connector can do

Connect Printful to Claude, Cursor, ChatGPT & more