All Paint Colours

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

Open source Repository Open in the app JSON README (API)

About

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

Details

Kind: MCP servers
Topic: No topic detected
Publisher: uk.co.allpaintcolours
Origin: official
Category: ferramentas
Transport: http
Version: 1.0.0
Last push: 2026-09-05T22:30:17Z
Repository state: ativo
Added: 2026-09-06 00:00:22
Updated: 2026-09-06 00:00:22
Origin id: uk.co.allpaintcolours/mcp

README

# 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](https://allpaintcolours.co.uk/api/v2/docs) · [OpenAPI](openapi.json))
- **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

```bash
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](MCP_TOOLS.md) for the full tool catalogue.

## REST quick start

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

```bash
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/](examples/).

## Tiers

| | Free | Home (£12/mo or £120/yr inc. VAT) | Pro (£60/mo or £600/yr inc. VAT) |
|---|---|---|---|
| Colour research & ΔE matching | ✓ | ✓ | ✓ |
| Price data + cheapest alternatives | — | ✓ | ✓ |
| Saved palettes | 1 | Unlimited | Unlimited |
| Planner projects | — | Unlimited | Unlimited |
| Market data (trends, rankings, changes) | — | — | ✓ |
| Calls/month (MCP + API pooled) | 200 | 2,500 | 25,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.