Allpaintcolours Api MCP Server

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.

• Website: https://allpaintcolours.co.uk
• MCP server: https://mcp.allpaintcolours.co.uk/mcp
• REST API: https://allpaintcolours.co.uk/api/v2 (interactive docs · OpenAPI)
• Sign up / API keys: https://allpaintcolours.co.uk/account/
• Pricing & terms: https://allpaintcolours.co.uk/developers/

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

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.