Developers

Bring your own AI

Point Claude, ChatGPT, Cursor, or any MCP client at Kiln and let it draft brands, read the catalog, and check demand for you. The REST API and the MCP server are free and public on every plan, paid or not. Reads need no key. Writes act as you once you sign in, or take a key.

MCP connect

live

A real Model Context Protocol server over streamable HTTP, with two doors. Interactive clients sign in with your Kiln account. Scripts and agents use the keyless endpoint and add a key only for writes. Either way your assistant gets eleven tools: generate_drafts, get_catalog, get_demand, search, and fetch, plus the draft and design tools below.

Sign in with Kiln
https://joinkiln.com/mcp

For Claude, ChatGPT, Cursor, VS Code, and any client that can open a sign-in window. Reads and writes act as you. No key to paste.

Keyless, for scripts and agents
https://joinkiln.com/api/mcp

Reads are free with no auth at all. Writes need an api_key minted on this page, or an OAuth bearer token.

Connect your AI

Point the client at the sign-in endpoint. When it asks, sign in with your Kiln account; reads and writes then act as you. There is no key to paste.

Claude.ai and Claude Desktop

sign-in live

Settings, then Connectors, then Add custom connector.

  1. 01Name it Kiln
  2. 02Paste https://joinkiln.com/mcp as the URL and choose Add
  3. 03Choose Connect. A Kiln sign-in window opens
  4. 04Ask Claude to draft you a brand on Kiln
URL
https://joinkiln.com/mcp

Claude Code

sign-in live

In a terminal, then use /mcp inside a session to check the connection.

claude mcp add --transport http kiln https://joinkiln.com/mcp

The Kiln sign-in opens in your browser the first time the server is used.

ChatGPT

sign-in live

Settings, then Connectors, then Advanced, turn Developer mode on, then Create.

  1. 01Name it Kiln
  2. 02Paste https://joinkiln.com/mcp as the URL
  3. 03Authentication: OAuth, then Create
  4. 04In a chat, enable Kiln under Tools
URL
https://joinkiln.com/mcp

ChatGPT's connector requires search and fetch tools. Kiln provides both.

Cursor

sign-in live

One click, or drop the file in your project.

Add to Cursor
.cursor/mcp.json
{
  "mcpServers": {
    "kiln": {
      "url": "https://joinkiln.com/mcp"
    }
  }
}

VS Code (Copilot)

sign-in live

One click, or drop the file in your workspace.

Install in VS Code
.vscode/mcp.json
{
  "servers": {
    "kiln": {
      "type": "http",
      "url": "https://joinkiln.com/mcp"
    }
  }
}

Windsurf

In Windsurf's MCP settings, or edit the config file directly.

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "kiln": {
      "serverUrl": "https://joinkiln.com/mcp"
    }
  }
}

Kiln has not verified the sign-in window in this client yet. If it does not open, use Paste a key.

Gemini CLI

In a terminal.

gemini mcp add --transport http kiln https://joinkiln.com/mcp

Kiln has not verified the sign-in window in this client yet. If it does not open, use Paste a key.

Codex CLI

In a terminal.

codex mcp add kiln --url https://joinkiln.com/mcp

Kiln has not verified the sign-in window in this client yet. If it does not open, use Paste a key.

Zed, Cline, and stdio-only clients

In the client's MCP settings, add a stdio server that runs mcp-remote. It bridges to Kiln over HTTP and handles the sign-in.

npx -y mcp-remote https://joinkiln.com/mcp
as a config entry
{
  "mcpServers": {
    "kiln": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://joinkiln.com/mcp"
      ]
    }
  }
}

Kiln has not verified the sign-in window in this client yet. If it does not open, use Paste a key.

Core tools
  • generate_drafts

    One sentence in, three product brand drafts out, each with real margin math.

  • get_catalog

    Everything Kiln can make one at a time, with margin math at the flat 5% fee.

  • get_demand

    What converts on the network this week, computed nightly.

  • search

    Keyword search across what Kiln exposes, returning ids and snippets. One of the two tools ChatGPT's connector requires.

  • fetch

    Load one search result by id, in full. The other tool ChatGPT's connector requires.

Draft tools
  • refine_draft

    Revise drafts with one plain-words instruction. AI when configured and within the daily budget, deterministic otherwise; the reply says which ran.

  • swap_look

    Deterministic recombination, no AI: keep the product and re-roll the look, or keep the name and move it onto another catalog item.

Design tools
  • get_store_design

    Read a store's current theme by slug, sanitized before it leaves.

  • suggest_store_designs

    Three coherent design directions from a brand's own words. Falls back to deterministic output in the sandbox, labeled.

  • edit_store_design

    One plain-words instruction in, the edited theme and a list of what moved out. Nothing is saved.

  • set_store_designkey

    Keyed. Write a theme to a store you own. Owner-checked and size-capped server side.

On the sign-in endpoint, writes act as you. On the keyless endpoint they take an API key minted on this page. Every theme, whether read, suggested, edited, or saved, passes server-side validation and contrast repair before it touches a store.

REST, five endpoints

Plain JSON over HTTPS with permissive CORS. Four public endpoints need no key. The one keyed write takes a bearer key from below; keys come with the $29 plan.

  • POST
    /api/v1/drafts

    One sentence in, three honest drafts out. Deterministic sandbox output.

  • POST
    /api/v1/theme

    A brand idea in, three storefront themes out, each sanitized so it always reads.

  • GET
    /api/v1/catalog

    Everything Kiln can make one at a time, with real margin math at the flat 5% fee.

  • GET
    /api/v1/demand

    What converts on the network this week, computed nightly.

  • POST
    /api/v1/brandskey

    Keyed. The best draft for your prompt plus the create URL. Keys come with the $29 plan. Programmatic launch lands with keys v2.

curl -X POST https://joinkiln.com/api/v1/drafts \
  -H "Content-Type: application/json" \
  -d '{"prompt": "a candle brand for people who hike"}'

API keys

$29/mo

Keys are minted and signed server side once your store is live. The full key shows once at mint time and is never stored.

Revoking a key is enforced server side: the key stops working at once on the instance that served the revoke and within a minute everywhere else. If a key leaked, revoke it and rotate anything sensitive.

Write access keys come with going live.

$29/mo flat unlocks live checkout, growth studio, channels, priority production, the higher AI cap, and write keys. Reads stay free without it.

Go live · $29/mo