# connect palletism

palletism is a read-only mcp server of taste packs: art direction, palette,
prompt recipe and reference images that give a project one illustration style.

## ask the user for a key

- keys start with plt_. the user makes one at https://palletism.adityalogs.xyz/profile/mcp
- never invent a key, never print it back, never commit it.

## server

- url: https://palletism.adityalogs.xyz/mcp
- transport: streamable http
- header on every request: Authorization: Bearer <key>

## add it with the command for the client you run in

claude code:

```sh
claude mcp add --transport http palletism https://palletism.adityalogs.xyz/mcp --header "Authorization: Bearer <key>"
```

codex (put the export line in the shell profile too):

```sh
export PALLETISM_KEY=<key>
codex mcp add palletism --url https://palletism.adityalogs.xyz/mcp --bearer-token-env-var PALLETISM_KEY
```

droid:

```sh
droid mcp add palletism https://palletism.adityalogs.xyz/mcp --type http --header "Authorization: Bearer <key>"
```

cursor (~/.cursor/mcp.json) and other clients, an mcpServers entry:

```json
{
  "mcpServers": {
    "palletism": {
      "url": "https://palletism.adityalogs.xyz/mcp",
      "headers": {
        "Authorization": "Bearer <key>"
      }
    }
  }
}
```

## check

the server loads when the agent starts. ask the user to restart it, then call
tools/list and expect 8 tools and 1 prompt.

- 401: the key is wrong, expired or revoked. ask for a new one.
- 429: today's calls are used (200 on free, 3,000 on hobby). they reset at 00:00 utc.

## then

read the project's theme colors, call match_taste with them and a one-line
product description, and tell the user in one line which pack fits.