MCP installation

The Kettio MCP server gives an AI client tools for working with brand assets: finding local files, reading brand context, generating and editing images, removing backgrounds, and opening previews.

The server includes rank_assets, which scores local files directly — an MCP client does not need to touch the REST API to rank creative. See Set up your agent for the fastest path.

Requirements

Node.js 18 or newer
A Kettio API key from Dashboard → API Keys

Connect your client

The server is distributed as a hosted tarball, so npx fetches it directly — there is nothing to clone and nothing to build.

Claude Code
Codex
Claude Desktop
Other clients

claude mcp add kettio \
  --transport stdio \
  -e KETTIO_API_URL=https://kettio.com \
  -e KETTIO_API_KEY=your-api-key-here \
  -- npx -y --package=https://kettio.com/downloads/kettio-mcp-server-3.0.0.tgz kettio-mcp

Run claude mcp list and confirm kettio is connected.

codex mcp add kettio \
  --env KETTIO_API_URL=https://kettio.com \
  --env KETTIO_API_KEY=your-api-key-here \
  -- npx -y --package=https://kettio.com/downloads/kettio-mcp-server-3.0.0.tgz kettio-mcp

Add to your Claude Desktop config. On macOS that is ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "kettio": {
      "command": "npx",
      "args": [
        "-y",
        "--package=https://kettio.com/downloads/kettio-mcp-server-3.0.0.tgz",
        "kettio-mcp"
      ],
      "env": {
        "KETTIO_API_URL": "https://kettio.com",
        "KETTIO_API_KEY": "your-api-key-here"
      }
    }
  }
}

Configure a stdio server with this command and two environment variables:

npx -y --package=https://kettio.com/downloads/kettio-mcp-server-3.0.0.tgz kettio-mcp

KETTIO_API_URL=https://kettio.com
KETTIO_API_KEY=your-api-key-here

Verify the setup

Restart your MCP client after saving the configuration, then ask:

What Kettio tools do you have?

You should see rank_assets, rank_ad_batch, get_rank_run, and list_audiences. Full schemas are in the tool reference.

Kettio displays a new key only once. Do not commit it to your repository or paste it into public issue threads. If you lose it, create a replacement from Dashboard → API Keys.

Get started

Guides

Concepts

MCP server

Changelog

MCP installation

Requirements

Connect your client

Verify the setup

How it fits together

Next

Set up your agent

Tool reference

​Requirements

​Connect your client

​Verify the setup

​How it fits together

​Next

Set up your agent

Tool reference

Requirements

Connect your client

Verify the setup

How it fits together

Next