Install Palate

Connect Palate to your AI coding agent. You will need a token from app.palatemcp.com.

Claude Code

  1. Sign up at app.palatemcp.com and create a token.
  2. Copy the token (it is shown once, so save it somewhere safe).
  3. Run the command below, replacing YOUR_TOKEN with your real token.
claude mcp add palate --url https://mcp.palatemcp.com/api/mcp --header "Authorization: Bearer YOUR_TOKEN"

Cursor

Add this to .cursor/mcp.json in your project root. 

{
  "mcpServers": {
    "palate": {
      "url": "https://mcp.palatemcp.com/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN"
      }
    }
  }
}

Windsurf

Add this to your Windsurf MCP config file (~/.codeium/windsurf/mcp_config.json). 

{
  "mcpServers": {
    "palate": {
      "serverUrl": "https://mcp.palatemcp.com/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN"
      }
    }
  }
}

v0, Lovable, and other MCP clients

Any client that supports the Model Context Protocol can connect. Point it at the HTTP endpoint with a bearer header. 

URL:    https://mcp.palatemcp.com/api/mcp
Header: Authorization: Bearer YOUR_TOKEN

Verify it works

Once connected, ask your agent to call a tool. For example: 

refs_search { "pageType": "pricing" }

You should see a list of references that have pricing pages. If you get an unauthorised error, check that your token is correct and has not been revoked.

Available tools

Palate exposes ten refs_* tools. Your agent can call any of them once connected.

Tool What it does
refs_search Search the library by facet (vertical, page type, UX pattern, style, and more).
refs_match_brief Match a client brief to the best references and get a binding playbook.
refs_for_business Find references for a specific business type, with honest coverage and a conversion playbook.
refs_get Get a single reference by slug with full detail, notes, and build guidance.
refs_get_tokens Get the extracted design tokens (palette, type scale, radii, easings) for a reference.
refs_get_screenshot Get screenshots of a reference (homepage and captured inner pages).
refs_get_astro_recipe Get the Astro rebuild recipe: islands, motion mapping, token bridge, and pitfalls.
refs_similar Find references similar to a given one, by meaning across the whole library.
refs_list_verticals List every vertical in the library with counts, subtypes, and example slugs.
refs_insights Get corpus-level insights: trends, clusters, playbooks, mechanics, and emotional registers.

Ready to get started?

Create your token