PigmentaLab

npx add-mcp 'https://mcp.pigmentalab.io/mcp'

Start in two steps

Credits are bought on the web, never inside a chat.

1. Add the server to your agent. Paste https://mcp.pigmentalab.io/mcp as a custom connector or MCP server.
2. Sign in and press Allow. Your agent opens PigmentaLab: sign in with Google and allow the connection — the page speaks 14 languages. Credit is added at pigmentalab.io/app/api: USD 10 = 1,000 credits; PigmentaLab PRO plans include 1,000 API credits every month.

Prefer a key? Create one at pigmentalab.io/app/api and send it as an X-API-Key header, or paste it at mcp.pigmentalab.io/conectar to get a personal link that already carries it.

Connect your client

With OAuth there is no key to copy: you sign in and allow. Never paste a key into a chat.

Claude web, desktop and mobile

1. Claude → Settings → Connectors → Add custom connector → paste https://mcp.pigmentalab.io/mcp.
2. Connect → sign in to PigmentaLab → Allow.

ChatGPT on the web, Business or Enterprise

1. Plugins → + → Add custom MCP server → the URL https://mcp.pigmentalab.io/mcp → OAuth → Create as a plugin.
2. Sign in to PigmentaLab → Allow.
3. In a new chat, type @ and pick PigmentaLab.

Images you attach in ChatGPT go straight to the tools. ChatGPT lets you add your own MCP server only on the web, with Business or Enterprise; with Pro it runs just the tools that don’t spend credits.

Claude Code

claude mcp add --transport http pigmentalab https://mcp.pigmentalab.io/mcp

Then run /mcp in Claude Code and sign in. With a key instead, add --header "X-API-Key: plb_live_...".

Or install the plugin, which adds the server and a DTF print-prep skill:

claude plugin marketplace add bykarlos/pigmentalab-mcp
claude plugin install pigmentalab@pigmentalab

Cursor ~/.cursor/mcp.json

Add to Cursor Cursor opens and asks to install it. Or add it by hand:

{
  "mcpServers": {
    "pigmentalab": {
      "url": "https://mcp.pigmentalab.io/mcp"
    }
  }
}

Cursor shows the server as needing a login: click it, sign in and allow. With a key instead, add "headers": { "X-API-Key": "plb_live_..." }.

VS Code.vscode/mcp.json

Install in VS Code VS Code opens and asks to install it. Or add it by hand:

{
  "servers": {
    "pigmentalab": {
      "type": "http",
      "url": "https://mcp.pigmentalab.io/mcp"
    }
  }
}

VS Code asks you to sign in the first time a tool runs.

Gemini CLI extension

gemini extensions install https://github.com/bykarlos/pigmentalab-mcp

The extension adds the server and the print-prep instructions. Or only the server, in ~/.gemini/settings.json:

{
  "mcpServers": {
    "pigmentalab": {
      "httpUrl": "https://mcp.pigmentalab.io/mcp"
    }
  }
}

Sign in with /mcp auth pigmentalab. With a key instead, add "headers": { "X-API-Key": "plb_live_..." }.

OpenClaw ~/.openclaw/openclaw.json

Put the key in the PIGMENTALAB_API_KEY environment variable.

{
  mcp: {
    servers: {
      pigmentalab: {
        url: "https://mcp.pigmentalab.io/mcp",
        transport: "streamable-http",
        headers: { "X-API-Key": "${PIGMENTALAB_API_KEY}" },
      },
    },
  },
}

Any other MCP client

Server URL https://mcp.pigmentalab.io/mcp (Streamable HTTP). Clients with MCP OAuth sign in by themselves (OAuth 2.1 with PKCE; dynamic registration and client ID metadata documents). Otherwise send the header X-API-Key: plb_live_... — Authorization: Bearer plb_live_... works too — or, if the client cannot send headers, use your personal link from /conectar as the URL.

Tools & prices

1 credit = USD 0.01. Images over 25 megapixels cost double. Charged only when the result is delivered.

Tool	What it does	Price
inspect_image_for_print	Can this image print at N cm? Real pixels, largest size at 300 and 150 dpi, transparency, ink and a verdict.	Free
remove_background	Transparent PNG, ready for a garment.	1 cr · $0.01
upscale_image	Enlarge to a print height in cm at 300 dpi, with clean edges.	1 cr · $0.01
knockout_color	Make black, white or one chosen color transparent.	0.5 cr · $0.005
halftone_image	Artistic or garment-aware halftone dots.	0.5 cr · $0.005
improve_image	Colors, denoise, logo cleanup or face restoration.	0.5–1 cr
create_gangsheet	Nest many designs on a roll with as little waste as possible.	5 cr + 3 cr/m
pigmenta_create_upload	A short-lived upload page, in the person’s language, for files the agent cannot forward.	Free
pigmenta_guide · print_size_for_garment · print_advice	What the PigmentaLab Bot knows: which tool for which job, print sizes by garment and size, and print advice by technique.	Free
pigmenta_job_status · pigmenta_account · pigmenta_pricing	Job results, balance and the live price list.	Free

Credit packs: USD 10 = 1,000 · USD 100 = 12,500 · USD 500 = 71,400. Live prices: api.pigmentalab.io/v1/pricing.

Any language

Ask in your own words. The agent answers in your language; the tools don’t care which one.

EnglishCan this logo print at 30 cm tall? If not, upscale it.

EspañolSacale el fondo y armame una lámina de 58 cm con 10 copias de 8 cm.

简体中文把这张图的背景去掉，然后放大到 30 厘米高。

हिन्दीक्या यह डिज़ाइन 25 सेमी पर ठीक से प्रिंट होगा?

العربيةأزل الخلفية من هذه الصورة وجهّزها للطباعة.

PortuguêsFaz um meio-tom desse desenho para camiseta preta.

Good to know

No key in the chat

With OAuth you only sign in and allow; the connection shows up as “Agente · …” among your keys at pigmentalab.io/app/api, where you can revoke it. A key, if you use one, travels in a header and is never shown to the model.

Files expire

Upload links last 30 minutes and download links 4 hours. Full-resolution files never travel inside the chat.

Long jobs don’t time out

Heavy tools return a job_id; the agent polls pigmenta_job_status and is not charged twice.

Same key, REST too

The Developer API at api.pigmentalab.io/v1 uses the same key and the same credits.

Support

Write to [email protected], in any language, or use the chat inside the web app. A person answers. Tell us the tool and roughly when it ran; never send your API key.