PerlerBeadAI

PerlerBeadAI

MCP Server — Connect Your AI Client

MCP Server — let your AI client use PerlerBeadAI tools

MCP (Model Context Protocol) connects Claude Code, Cursor, Claude Desktop, Codex and other AI clients directly to our bead-pattern tools: convert images into bead patterns, generate pattern art, look up every Perler / Hama / Artkal color, and estimate bead costs — without leaving your AI chat.

Available tools

Tool What it does Rate limit
pba_convert Convert an image (URL or base64) into a bead pattern: color-quantized grid, per-color bead counts, rendered chart PNG. Board 2–120 beads, 4 brands. 30/min per key
pba_generate Generate bead-pattern-style art from a text prompt (gpt-image-2, ~1–4 min render). Two-step: submit with prompt → poll with job_id every ~15 s. Result is hosted here and opens straight in the AI editor. Uses your account quota: 3 free AI generations/day, then 1 credit each — the same pool as the website generator. account quota (3 free/day + credits)
pba_color_chart Full color chart of a brand — Perler 103, Hama 92, Artkal-S 199, Artkal-C 174 (code, name, hex). Interactive version: /colors/. 60/min per key
pba_convert_color Nearest bead colors across brands for a brand+code or any hex, using CIEDE2000 (grades: excellent <2, good <4, approximate <7, poor ≥7). 60/min per key
pba_estimate_cost Turn per-color bead counts (e.g. from pba_convert) into bag counts and a reference cost estimate. Prices are labeled reference values, not live shop prices. 60/min per key

All tools require a free account API key (member feature). Your key ties calls to your account: usage stats on your account page, and pba_generate shares your daily free quota and credit balance with the website.

Connection details

Server URL https://perlerbeadai.com/wp-json/pba/v1/mcp
Transport Streamable HTTP (JSON responses)
Auth Authorization: Bearer <your API key> — required for every tool. OAuth 2.1 (PKCE, S256) is also available: discovery at /.well-known/oauth-authorization-server/wp-json/pba/v1/mcp. Check a key any time: GET /wp-json/pba/v1/key/whoami.

Setup — 2 steps

  1. Create your key. Register a free account (5 bonus credits included), then open your account page → API Keys & MCP card and click Create key. The key (pba_uk_…) is shown once — copy it. Regenerate or revoke any time from the same card.
  2. Add the server to your AI client (configs below), restart the client, done.

Claude Code

claude mcp add --transport http perlerbeadai 
  https://perlerbeadai.com/wp-json/pba/v1/mcp 
  --header "Authorization: Bearer pba_uk_…"

Cursor / Claude Desktop

{
  "mcpServers": {
    "perlerbeadai": {
      "url": "https://perlerbeadai.com/wp-json/pba/v1/mcp",
      "headers": {
        "Authorization": "Bearer pba_uk_…"
      }
    }
  }
}

Cursor: Settings → MCP → Add server. Claude Desktop: claude_desktop_config.json. Restart the client after saving.

Codex (OpenAI CLI)

[mcp_servers.perlerbeadai]
url = "https://perlerbeadai.com/wp-json/pba/v1/mcp"
http_headers = { "Authorization" = "Bearer pba_uk_…" }

Fair use

  • Rate limits: 30 calls/min for pba_convert, 60/min for the other reference tools, one pba_generate submit per 15 s.
  • pba_generate consumes your account quota (3 free/day, then 1 credit per render — provider-failed renders are refunded automatically). Credits never expire; top up here.
  • Prompts with copyrighted characters/brands are rejected automatically; image URLs are SSRF-checked (public hosts only, max 10 MB).
  • Keep your key private — it works like a password. Regenerate or revoke it instantly from your account page.
  • Calls are audit-logged (timestamp, key, tool, latency) for abuse prevention; your own recent activity is visible on your account page.

More free tools: Pattern Editor · AI Pattern Generator · Bead Color Chart · Free Patterns

AI Generator