Kunaki MCP — Automação de Mídia Física
surfnoirworld/kunaki-mcp
Automação completa para manufatura sob demanda de mídia física
Ver no GitHubMCP server + automação de navegador para gerenciar fabricação e fulfillment de CDs, DVDs, vinis e fitas cassete via Kunaki. Integra criação de produtos (upload de áudio + artwork) com fulfillment de pedidos, quotas de envio e rastreamento — tudo sem APIs públicas para criar produtos.
Instalação
npx convez-ai surfnoirworld/kunaki-mcp1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Criar e publicar discos sob demanda sem estoque mínimo
- Automatizar fulfillment de pedidos de CDs/DVDs/vinis
- Gerenciar quotas de envio, tracking e links de compra
- Integrar com Claude para orçamentos e status de pedidos
Veredito

Solução robusta para quem precisa automatizar produção de mídia física. Combina browser automation (criação) + API XML (fulfillment) com elegância; bem documentada, mas requer conhecimento de variáveis de ambiente e caminhos absolutos.
README
A tradução para o português deste README ainda está na fila.
Kunaki MCP + Automation
Automate physical media (CD / DVD / vinyl / cassette) manufacturing and fulfillment through Kunaki — print-on-demand discs with no minimums and ~24h turnaround.
Kunaki exposes a small HTTP/XML API for order fulfillment only — there is no public API for creating products. This project covers both halves:
| Half | Tool | How |
|---|---|---|
| Create a product (upload audio + artwork → get a Product ID) | kunaki_create_product.py | Headless browser automation (nodriver) driving Kunaki's web uploader |
| Fulfill orders for an existing product (quotes, orders, tracking, images, buy links) | server.py (MCP server) | Kunaki's HTTP API |
| Collect Product IDs Kunaki assigns after production | kunaki_sync_products.py | Reads your Products List, updates the registry |
| Prep artwork to exact specs | kunaki_prep_artwork.py | Pillow resize → JPG/300DPI |
| Web UI wrapping create + prep | app.py | Local Flask app |
Quick start
python -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
cp .env.example .env # fill in your Kunaki credentials
requirements.txt installs mcp, httpx, pydantic (server), nodriver
(automation), Pillow (artwork), and flask (UI). No Playwright needed.
The MCP server (fulfillment)
Five tools, none of which expose credentials as parameters (they come from env):
| Tool | Auth | Description |
|---|---|---|
kunaki_get_shipping_options | none | Shipping options + costs for a product/destination |
kunaki_place_order | env | Place a manufacturing order (supports test_mode) |
kunaki_get_order_status | env | Status + tracking for an order |
kunaki_get_product_images | none | All product image URLs (front/back/spine/disc/box) |
kunaki_get_buy_link | none | Hosted PayPal buy-page URL |
Add to an MCP client (Claude Desktop / Claude Code) — use the venv's Python,
not a bare python, so the deps resolve:
{
"mcpServers": {
"kunaki": {
"command": "/absolute/path/to/kunaki-mcp/.venv/bin/python",
"args": ["/absolute/path/to/kunaki-mcp/server.py"],
"env": {
"KUNAKI_USER_ID": "you@example.com",
"KUNAKI_PASSWORD": "your-password"
}
}
}
}
Kunaki's HTTP service wants repeated
ProductId/Quantityquery params for multi-product requests (not indexedProductId[0]), and replies with a<Response>…<Option>…</Option></Response>XML envelope.server.pyhandles both; a malformed request returns "XML Response cannot be loaded".
Creating a product
1. Prep artwork
python kunaki_prep_artwork.py --check my_album.json # report sizes
python kunaki_prep_artwork.py --config my_album.json --output prepped/
All artwork is JPG, 300 DPI, RGB. CD jewel-case specs:
| Slot | Size (px) |
|---|---|
| disc | 1394 × 1394 |
| front | 1423 × 1411 |
| back (inside insert) | 1423 × 1411 |
| tray (incl. spines) | 1772 × 1385 |
(See templates/ for vinyl and cassette specs.)
2. Write a config
Copy a template from templates/, fill in your paths, title, artist and
publisher. Example: templates/cd_jewel_template.json.
3. Run the creator
python kunaki_create_product.py --config my_album.json # visible browser
python kunaki_create_product.py --config my_album.json --headless # no window
python kunaki_create_product.py --config my_album.json --dry-run # validate only
The creator logs in, uploads each artwork and audio track (Kunaki uploads one
file at a time via XHR, with a progress bar), fills product info, and submits.
Kunaki then transmits the product to production and assigns the Product ID a
few hours later, by email — so a successful run reports a SubmissionId, and
the PX… Product ID is collected afterward by the sync (below).
The login "403" gotcha. Kunaki's login page is Referer-gated (IIS anti-hotlinking) — navigating to it directly returns 403 Forbidden. The automation reaches it by clicking the homepage login link so the browser sends a Referer. This is not bot detection; switching browser engines does not help. The login submit is also a JS
MySubmit()call, not a form submit.
4. Collect the Product ID
python kunaki_sync_products.py # logs in, reads Products List
Updates kunaki-products.json (_catalog maps every PX… ID → title). Run it
after a creation once Kunaki has finished transmitting.
Web UI
python app.py # opens http://localhost:5000
Pick a product type, point at your audio + artwork, and it preps and creates in one flow (wraps the scripts above).
Pricing (2026)
CD jewel $2.00 · CD jacket $1.50 · disc-only $0.75 · DVD $2.00 · Vinyl 12" $36 · Vinyl 7" $15 · Cassette $5 — flat per unit, plus shipping. Free UPS Ground on US single-address orders over $400.
Status
- ✅ MCP fulfillment server — verified against the live API
- ✅ CD jewel-case creation — verified end-to-end (login → 14 uploads → submit → Product ID)
- ✅ Registry sync
- ⬚ DVD / vinyl / cassette creation — the submission forms differ per format;
map each in
ARTWORK_WIDGETS/FORMAT_NAVinkunaki_create_product.pyagainst the live page (the CD flow is the template).
License
MIT — see LICENSE.