English Français العربية

All Paint Colours

Official registry E-commerce

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

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

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

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  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.

Frequently asked questions

What is All Paint Colours?

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

How do I install All Paint Colours?

It runs as a remote server. In Claude Code: claude mcp add --transport http all-paint-colours 'https://mcp.allpaintcolours.co.uk/mcp'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does All Paint Colours need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is All Paint Colours open source?

Its code is public on GitHub, but the repository does not declare a standard license.

Who maintains All Paint Colours?

It is published by hwam91. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.