MCP server overview

The Muro MCP server gives an AI agent real paint colours from 35 manufacturer catalogues (about 51,000 colours) and, with a Muro account or an x402 payment, can repaint a photo of a room, facade or roof.

Endpoints

URL	Transport	Sign-in	Use it for
`https://mcp.usemuro.com/mcp`	Streamable HTTP	None for the free tools. Optional `Authorization: Bearer muro_sk_…` header (a Muro API key) for the paid tools.	Clients that can send headers: CLIs, SDKs, Claude Code, Cursor.
`https://mcp.usemuro.com/account/mcp`	Streamable HTTP	OAuth: the user signs in with their Muro account.	Connectors that cannot send headers, such as claude.ai and ChatGPT. See /auth/oauth/.

Both endpoints expose the same eight tools. The paid tools are always listed so that agents can discover them; they fail with an explanatory message when no payment method is available.

Tools

Tool	What it does	Cost	Reference
`search_paint_colors`	Find colours by name or code across all brands.	Free	/mcp/tools/search-paint-colors/
`get_paint_color`	Look up one colour by brand and exact name or code.	Free	/mcp/tools/get-paint-color/
`find_equivalents`	Closest colours in other brands to a colour or hex value (CIEDE2000).	Free	/mcp/tools/find-equivalents/
`list_brands`	List brands, optionally those sold in a country.	Free	/mcp/tools/list-brands/
`visualize_room`	Repaint a photo in 1 to 12 colours.	Paid: 1 to 3 credits per colour, or x402	/mcp/tools/visualize-room/
`get_visualization`	Fetch the colours of a `visualize_room` job that were not ready yet.	No extra cost	/mcp/tools/get-visualization/
`relight_room`	Relight a finished interior as day, evening or night.	Paid: 1 credit, or x402	/mcp/tools/relight-room/
`get_credits`	Show the credit balance and plan of the connected account.	Needs a Muro key	/mcp/tools/get-credits/

Server card and registry

Server card: https://mcp.usemuro.com/.well-known/mcp.json. JSON with the transport URL, authentication options, rate limits and the full tool list (names, titles, descriptions).
MCP Registry name: com.usemuro/paint-colors (title “Muro Paint Colors”, both endpoints above are listed as streamable-http remotes).
A plain-text description is served at GET https://mcp.usemuro.com/.

Rate limits

Limits are per client IP and approximate.

Traffic	Limit
Requests to `/mcp` without an `Authorization` header	600 per 60 seconds
Requests with an `Authorization` header (keyed calls), `/account/mcp`, and the OAuth endpoints (`/register`, `/authorize`, `/oauth/*`)	60 per 60 seconds

GET /, the server card, and CORS preflight requests are not counted. When a limit is exceeded the server answers HTTP 429 with a Retry-After: 60 header and a JSON-RPC error body:

{
  "jsonrpc": "2.0",
  "id": null,
  "error": { "code": -32000, "message": "Rate limit: 600 requests per minute per client. Retry in 60 seconds." }
}

Paying for the paint tools

The free tools need nothing. visualize_room and relight_room spend money, in one of three ways. The server tries them in this order: a key on the connection, then x402, then it returns an error that says where to get a key.

Muro API key (credits). Create a key at https://app.usemuro.com/ustawienia and send it as Authorization: Bearer muro_sk_…. Painting is charged against the account’s credits: 1 credit per colour in standard, 2 in hd, 3 in ultra; relight_room costs 1. Details: API keys.
OAuth. Connect to https://mcp.usemuro.com/account/mcp and sign in with a Muro account. Same credits as a key. See /auth/oauth/.
x402. An agent without an account pays per call in USDC on Base. Prices: $0.25 (standard), $0.50 (hd) or $0.75 (ultra) per colour, and $0.25 per relight_room. get_visualization is free under x402. get_credits is not sold over x402. See /x402/.