Give your AI agents a color system.

MCP (Model Context Protocol) is an open standard that lets AI assistants call tools on other services. GetColors runs an MCP server, so Claude, Cursor and other MCP clients can use its color tools directly, and with Pro, work with your saved palettes.

How to connect an AI agent to GetColors

  1. Copy the server URL shown on this page. It is the /mcp address on this site, and it uses the Streamable HTTP transport.
  2. In Claude Code, run claude mcp add --transport http getcolors with that URL. In Cursor, add the server to .cursor/mcp.json. Other MCP clients need the URL and the transport.
  3. Ask your agent to use the tools, for example "Check if #6842C2 text on #F1EEF6 passes AA" or "Build a color system from #6842C2".
  4. For the Pro library tools, create a connection token in Connections, choose its permissions, and send it as a Bearer token in the Authorization header.

What your agent can do

  • Nine free tools

    Audit a codebase, generate palettes, check contrast, build Tailwind and contrast-targeted scales, build a color system, generate palettes with constraints, make chart colors and read the colors of a website.

  • No token for the free tools

    They need no account or token. They are stateless, nothing is saved, and requests are rate-limited per IP address.

  • Pro library tools

    With Pro, an agent can list, read, create, update, delete and restore your palettes and read their history.

  • Scoped, revocable tokens

    A connection has its own read, write and delete permissions, tokens expire, and you can revoke one at any time.

  • Safe edits

    Updating or deleting a palette needs its current version, so an agent cannot overwrite a change it has not seen.

  • shadcn registry for agents

    An agent can add a WCAG-checked shadcn theme or a Tailwind v4 scale to a project with a single command, with no key.

Frequently asked questions

What is MCP?

MCP, the Model Context Protocol, is an open standard that lets AI assistants call tools on other services. An MCP server lists its tools, and the assistant calls them when a task needs them.

Which AI assistants can use GetColors?

Claude, Cursor and other MCP clients that can connect to a server over Streamable HTTP. This page has setup steps for Claude Code, Cursor and other clients.

Is the GetColors MCP server free?

The nine color tools are free and need no account or token. The library tools, which read and change your saved palettes, are part of GetColors Pro and need a connection token.

Are there rate limits?

Yes. The free tools are rate-limited per IP address. All connections on one Pro account share a limit of 120 MCP requests per minute, and the server answers with HTTP 429 and a Retry-After header when it is reached.

Does the server support OAuth?

Not yet. To use the Pro library tools your client must be able to set a custom Authorization header. Clients that cannot can still use the free tools.