Windsurf + Tintly
Give Cascade a color toolkit.
- Windsurf
- A Tintly API key
Connect Windsurf in three steps
Windsurf's Cascade agent reads MCP servers from mcp_config.json. Remote servers use serverUrl.
- 1
Create an API key
Sign in on the developer page and create a key.
- 2
Open the config
Open the MCP settings in Windsurf, or edit ~/.codeium/windsurf/mcp_config.json.
- 3
Add Tintly and refresh
Paste the block below and press Refresh in the MCP panel.
{
"mcpServers": {
"tintly": {
"serverUrl": "https://www.trycolorkit.com/api/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
} 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 Windsurf: if one is rejected, follow its current MCP docs, which only need the address and the Authorization header.
What you need
- Windsurf
- A Tintly API key
Good to know
- Windsurf limits how many tools can be active across servers, so turn off ones you do not need.
First things to ask Windsurf
- 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 Windsurf and Tintly
Which field holds the address?
serverUrl for remote HTTP servers. If your version uses another name, follow its MCP docs: it only needs the URL and the Authorization header.
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.