Code editor · Anysphere

Cursor + Tintly

Pick colors with Tintly right inside Cursor.

  • Cursor
  • A Tintly API key

Connect Cursor in three steps

Cursor reads MCP servers from mcp.json. Add Tintly and the agent can choose palettes and verify contrast while it edits your components.

  1. 1

    Create an API key

    Sign in on the developer page and create a key.

  2. 2

    Edit mcp.json

    Open ~/.cursor/mcp.json for every project, or .cursor/mcp.json inside one project. Add the block below.

  3. 3

    Enable the server

    Open Cursor Settings, MCP, and switch Tintly on. A green dot means it connected.

~/.cursor/mcp.jsonjson
{
  "mcpServers": {
    "tintly": {
      "url": "https://www.trycolorkit.com/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Cursor can also read the key from an environment variable with ${env:TINTLY_API_KEY}, which keeps it out of the file.

Server address: https://www.trycolorkit.com/api/mcp. Replace YOUR_API_KEY with a key from the developer page. Field names can change between releases of Cursor: if one is rejected, follow its current MCP docs, which only need the address and the Authorization header.

What you need

  • Cursor
  • A Tintly API key

Good to know

  • Do not commit a project mcp.json that contains a real key.

First things to ask Cursor

  • Make me a calm, trustworthy palette for a banking app and check the text contrast.
  • Which pairs in #0B132B, #1C2541, #5BC0DE, #F4D6B0 and #D97706 are readable as text?
  • Explain what the color #2A9D8F says to people, and where it works best.

Questions about Cursor and Tintly

The server shows red. What now?

Open the MCP log in the Output panel. A 401 means the key is wrong or revoked; a 429 means you went over 60 requests a minute.

Do I need an API key?

Yes. Every request carries your key in the Authorization header. Create one on the developer page: it is free and takes a few seconds.

Can an assistant change my account or my saved palettes?

No. Every Tintly tool only reads or computes: palettes, colors, contrast and descriptions. Nothing here writes to your library or account.

What does it cost?

Nothing. Tintly is free, and so are the API and the MCP server. Each key is limited to 60 requests a minute so it stays fast for everyone.