Katman MCP: the method as tools for your AI coding agent

1. Step 1

   Research

   What do your customers type into ChatGPT and Google, who do assistants recommend today, and what is your one sentence?

   tools: katman_start · katman_research · katman_keywords · katman_visibility_run · katman_manual_check

   output: .katman/research.md

2. Step 2

   Plan

   Katman reads your code and your live site the way AI crawlers do, then decides which pages to write, at which URLs, and what to fix first.

   tools: katman_scan_code · katman_audit_site · katman_plan · katman_page_brief

   output: .katman/plan.md

3. Step 3

   Build

   Your AI coding tool does the work one prompt at a time. Every task has an acceptance criterion; the next task waits until it passes.

   tools: katman_prompt · katman_generate · katman_lint_content

   output: .katman/log.md

4. Step 4

   Verify

   Katman checks each criterion on the live site, tells Google, Bing and IndexNow what changed, and asks the same questions again 14 days later.

   tools: katman_audit_site · katman_indexnow · katman_report · katman_setup_monitoring

   output: .katman/report.md

Every tool except katman_account needs your KATMAN_KEY. It comes with Audit Week or Katman Pro: buy one, create the key in your account (katman.pro/app → MCP) and put it where the snippets below show km_live_... or KATMAN_KEY.

{
  "mcpServers": {
    "katman": {
      "command": "npx",
      "args": [
        "-y",
        "katman-mcp"
      ],
      "env": {
        "KATMAN_KEY": "km_live_...",
        "OPENROUTER_API_KEY": "sk-or-..."
      }
    }
  }
}

claude mcp add katman -e KATMAN_KEY=km_live_... -e OPENROUTER_API_KEY=sk-or-... -- npx -y katman-mcp

claude mcp add katman -e KATMAN_KEY=km_live_... -- npx -y katman-mcp

{
  "inputs": [
    {
      "type": "promptString",
      "id": "katman-key",
      "description": "Katman key from katman.pro/app (required)",
      "password": true
    },
    {
      "type": "promptString",
      "id": "openrouter-key",
      "description": "OpenRouter API key (optional, only for visibility runs)",
      "password": true
    }
  ],
  "servers": {
    "katman": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "katman-mcp"
      ],
      "env": {
        "KATMAN_KEY": "${input:katman-key}",
        "OPENROUTER_API_KEY": "${input:openrouter-key}"
      }
    }
  }
}

{
  "mcpServers": {
    "katman": {
      "command": "npx",
      "args": [
        "-y",
        "katman-mcp"
      ],
      "env": {
        "KATMAN_KEY": "km_live_...",
        "OPENROUTER_API_KEY": "sk-or-...",
        "KATMAN_PROJECT_ROOT": "/absolute/path/to/your/project"
      }
    }
  }
}

{
  "mcpServers": {
    "katman": {
      "command": "npx",
      "args": [
        "-y",
        "katman-mcp"
      ],
      "env": {
        "KATMAN_KEY": "km_live_...",
        "OPENROUTER_API_KEY": "sk-or-..."
      }
    }
  }
}

[mcp_servers.katman]
command = "npx"
args = ["-y", "katman-mcp"]
env_vars = ["KATMAN_KEY", "OPENROUTER_API_KEY"]

{
  "mcpServers": {
    "katman": {
      "command": "npx",
      "args": [
        "-y",
        "katman-mcp"
      ],
      "env": {
        "KATMAN_KEY": "$KATMAN_KEY",
        "OPENROUTER_API_KEY": "$OPENROUTER_API_KEY"
      }
    }
  }
}

Then ask your agent, in plain words: “Use Katman to check https://your-site.com.” It calls katman_start first and tells you the next step.

Don’t have a key yet? Start with Audit Week ($3 once, 7 days)

Reads

Files under your project root. It skips node_modules, .git and build output, and never reads .env*, .dev.vars*, *.pem, *.key, *.p12 or files with “secret” or “credential” in the name.

Writes

Only the .katman/ folder, which is safe to commit and never holds secrets. The exceptions are katman_generate and katman_setup_monitoring when you pass write: true, and they never overwrite a file unless you pass overwrite: true.

Network

Only when a tool is called: your own site; openrouter.ai for visibility runs (with your key, after a cost estimate); api.indexnow.org (katman_indexnow with dry_run: false); suggestqueries.google.com (katman_keywords, at most 40 requests); katman.pro for the licence check and katman_sync (next item).

What goes to katman.pro

Without KATMAN_KEY, Katman never contacts katman.pro. With it, the MCP checks your plan at most once a day (it sends the key and the MCP version) and keeps working offline for 7 days after the last check; katman_sync sends a project summary (gate counts, visibility rates, plan progress, issue titles, dates) only when you call it. Code, file contents, AI answers and your OpenRouter key never leave your machine. No usage tracking.

Your key

The OpenRouter key is read from OPENROUTER_API_KEY (or KATMAN_OPENROUTER_API_KEY). It is never written to disk and never printed.

No chat-app automation

Katman never drives the ChatGPT, Claude or Perplexity apps with a headless browser. App answers are recorded with katman_manual_check, where you paste them.

• Audit Week

  $3 once, for 7 days

  The audit and recommendation tools for 7 days: code scan, live-site audit, research, keywords, the page plan, content check, AI-visibility runs and the report. It finds what’s wrong and tells you what to do; it doesn’t build pages or write files in your site. One per account, and it doesn’t renew.

• Katman Pro

  $29/month or $290/year

  Everything in Audit Week, plus the tools that do the work: prompts P0–P14 with acceptance checks, page briefs, file generation (robots.txt, llms.txt, JSON-LD), IndexNow, monitoring and dashboard sync. Plus the full course and an invite to the private community. Founding price for the first 100 customers, kept for as long as your subscription stays active. After that, Pro is $49/month.

• The book and the workbook (PDF)

  $14 each, $20 together

  Sold on their own, not part of Audit Week or Pro: the Katman book and the 30-day GEO workbook, each in English and Turkish. One-time payment, yours to keep.

Visibility runs use your own OpenRouter key: about $2.4 per run on the default panel (range $1.2–3.7), paid by you to OpenRouter, shown before anything runs and capped at $3 by default. This cost is separate from Audit Week and Pro. No ranking guarantees.

Visibility-run panels

Measured against live OpenRouter pricing on 30 September 2026; search results are billed as input tokens. The exact estimate is shown before anything runs, and runs stop at $3 by default. API answers are a proxy for the consumer apps: studies in 2026 found 15–32% overlap in the brands they name, so katman_manual_check records the apps’ own answers when you paste them in.

Full pricing: Audit Week and Pro compared