English Français العربية

All Paint Colours

السجل الرسمي التجارة الإلكترونية

Every UK paint colour, matched across brands by ΔE and priced; palettes, planner projects, trends.

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http all-paint-colours 'https://mcp.allpaintcolours.co.uk/mcp'
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "all-paint-colours": {
            "type": "http",
            "url": "https://mcp.allpaintcolours.co.uk/mcp"
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. All Paint Colours — API & MCP server
  2. What it answers
  3. MCP quick start
  4. REST quick start
  5. Tiers
  6. Notes on the data
  7. Licence

All Paint Colours — API & MCP server

Programmatic access to every paint colour from every major UK manufacturer: 5,300+ colours from 14 retail brands, plus the RAL Classic and BS 4800 reference systems, with cross-brand colour matching (CIEDE2000), prices, technical finish specs, a room-by-room paint planner, and market trend data.

This repository is the public documentation for the API — the OpenAPI schema, the MCP tool catalogue, the planner project format, and worked examples. Issues and questions are welcome here.

What it answers

  • "What's the closest Dulux colour to Farrow & Ball Railings?"
  • "Same colour, but cheaper" — visually equivalent paints from other brands, ranked by £/m² saving (fairer than £/L, since coverage differs by brand)
  • "What paint matches this hex from a photo or a brand palette?"
  • "What's the retail equivalent of RAL 7016 / BS 4800 18 B 25?"
  • "My bedroom is 4m × 3.2m — how many tins, which primer, what's the cost?"
  • "What's trending in greens this month, and who's changed prices?"

MCP quick start

claude mcp add --transport http apc https://mcp.allpaintcolours.co.uk/mcp

In Claude (desktop or web): Settings → Connectors → Add custom connector → paste https://mcp.allpaintcolours.co.uk/mcp. ChatGPT (developer mode) and Cursor take the same URL. Sign-in happens through OAuth in your browser on first connect — no API keys to handle.

See MCP_TOOLS.md for the full tool catalogue.

REST quick start

Create a key at https://allpaintcolours.co.uk/account/, then:

curl -H "Authorization: Bearer apc_live_..." \
  "https://allpaintcolours.co.uk/api/v2/search?query=railings"

curl -H "Authorization: Bearer apc_live_..." \
  -H "Content-Type: application/json" \
  -d '{"colours": ["#45494C"], "limit": 3}' \
  "https://allpaintcolours.co.uk/api/v2/match"

More in examples/.

Tiers

FreeHome (£12/mo or £120/yr inc. VAT)Pro (£60/mo or £600/yr inc. VAT)
Colour research & ΔE matching✓✓✓
Price data + cheapest alternatives—✓✓
Saved palettes1UnlimitedUnlimited
Planner projects—UnlimitedUnlimited
Market data (trends, rankings, changes)——✓
Calls/month (MCP + API pooled)2002,50025,000

Full details, the plan comparison and FAQs: https://allpaintcolours.co.uk/pricing/ — monthly plans cancel any time. | Commercial use in customer-facing products | — | — | ✓ |

Every tool is visible at every tier; above-tier calls return a structured requires_tier error with an upgrade link rather than a bare failure.

Notes on the data

Colour data is factual information gathered from public manufacturer sources. Hex values are sRGB approximations of physical paint — always check a sample pot before committing. Prices are indicative and change; coverage figures are the manufacturers' own. Trend data is a relative 0–100 interest index derived from site engagement, not industry sales.

All Paint Colours is not affiliated with or endorsed by any paint manufacturer; brand names identify their products.

Licence

The documentation in this repository is CC0. The colour data served by the API is subject to the terms at https://allpaintcolours.co.uk/developers/ — no bulk redistribution.

الأسئلة الشائعة

ما هو All Paint Colours؟

Every UK paint colour, matched across brands by ΔE and priced; palettes, planner projects, trends.

كيف أثبّت All Paint Colours؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http all-paint-colours 'https://mcp.allpaintcolours.co.uk/mcp'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج All Paint Colours إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل All Paint Colours مفتوح المصدر؟

شيفرته علنية على GitHub، لكن المستودع لا يعلن ترخيصًا قياسيًا.

من يصون All Paint Colours؟

ينشره hwam91. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.