@kobbe/cli 0.1.0

package/README.md

@@ -0,0 +1,80 @@
+# Kobbe CLI
+
+Kobbe CLI gives you terminal and MCP access to your Kobbe analytics workspace.
+
+## Install
+
+```bash
+npm install -g @kobbe/cli
+```
+
+## Login
+
+Create a personal access token in Kobbe under `Account -> Agent access`, then run:
+
+```bash
+kobbe login --token kbpat_...
+```
+
+You can also avoid writing config by using environment variables:
+
+```bash
+KOBBE_TOKEN=kbpat_... kobbe sites
+```
+
+## CLI Commands
+
+```bash
+kobbe me
+kobbe sites
+kobbe overview --site site_x --range today
+kobbe revenue --site site_x --range today
+kobbe top-pages --site site_x --range today --limit 5
+kobbe sources --site site_x --range today --limit 5
+kobbe next --site site_x --range today
+kobbe setup-health --site site_x
+```
+
+Management commands require write scopes:
+
+```bash
+kobbe create-site --name "My site" --domain example.com
+kobbe update-site --site site_x --name "New name"
+kobbe rotate-token --site site_x
+kobbe delete-site --site site_x --confirm "DELETE example.com"
+kobbe reset-stats --site site_x --confirm "RESET example.com"
+```
+
+Use `--json` for raw API responses, or `--plain` for human output without symbols.
+
+## MCP
+
+Add this server to your MCP client:
+
+```json
+{
+  "mcpServers": {
+    "kobbe": {
+      "command": "kobbe",
+      "args": ["mcp"]
+    }
+  }
+}
+```
+
+For local development:
+
+```json
+{
+  "mcpServers": {
+    "kobbe": {
+      "command": "node",
+      "args": [
+        "/path/to/app.kobbe.io/packages/kobbe-cli/src/cli.js",
+        "mcp"
+      ]
+    }
+  }
+}
+```
+

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "@kobbe/cli",
+  "version": "0.1.0",
+  "description": "Kobbe CLI and MCP server for AI agents.",
+  "type": "module",
+  "license": "UNLICENSED",
+  "homepage": "https://kobbe.io/docs/ai-agent-cli",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/michael-andreuzza/analytics.git",
+    "directory": "packages/kobbe-cli"
+  },
+  "bugs": {
+    "url": "https://github.com/michael-andreuzza/analytics/issues"
+  },
+  "keywords": [
+    "analytics",
+    "kobbe",
+    "cli",
+    "mcp",
+    "model-context-protocol"
+  ],
+  "bin": {
+    "kobbe": "./src/cli.js"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "files": [
+    "src"
+  ]
+}

package/src/cli.js

@@ -0,0 +1,442 @@
+#!/usr/bin/env node
+import { KobbeClient, loadConfig, saveConfig } from "./client.js"
+import { startMcpServer } from "./mcp.js"
+
+function argsToOptions(args) {
+  const out = { _: [] }
+  for (let i = 0; i < args.length; i += 1) {
+    const arg = args[i]
+    if (!arg.startsWith("--")) {
+      out._.push(arg)
+      continue
+    }
+    const key = arg.slice(2)
+    const next = args[i + 1]
+    if (!next || next.startsWith("--")) {
+      out[key] = true
+      continue
+    }
+    out[key] = next
+    i += 1
+  }
+  return out
+}
+
+function printJson(value) {
+  process.stdout.write(`${JSON.stringify(value, null, 2)}\n`)
+}
+
+const icons = {
+  account: "@",
+  sites: "#",
+  money: "$",
+  range: "~",
+  overview: ">",
+  pages: "::",
+  sources: "<",
+  setup: "+",
+  next: ">>",
+  orders: "#",
+  attributed: "=",
+  percent: "%",
+  good: "[ok]",
+  warn: "[!]",
+  quiet: "[-]",
+}
+
+function icon(name, options = {}) {
+  return options.plain ? "" : `${icons[name] || ""} `
+}
+
+function money(amount, currency) {
+  if (amount == null) return "-"
+  const value = Number(amount) / 100
+  if (!currency) return value.toFixed(2)
+  try {
+    return new Intl.NumberFormat("en", {
+      style: "currency",
+      currency,
+    }).format(value)
+  } catch {
+    return `${value.toFixed(2)} ${currency}`
+  }
+}
+
+function rangeLabel(value) {
+  const raw = String(value || "").trim()
+  if (!raw) return "Selected range"
+  const labels = {
+    today: "Today",
+    yesterday: "Yesterday",
+    "7d": "Last 7 days",
+    "30d": "Last 30 days",
+    "90d": "Last 90 days",
+    all: "All time",
+  }
+  return labels[raw] || raw
+}
+
+function optionalPositiveInt(value) {
+  if (value == null || value === true || value === "") return undefined
+  const parsed = Number(value)
+  if (!Number.isInteger(parsed) || parsed < 1) {
+    throw new Error("Pass --limit as a positive number.")
+  }
+  return parsed
+}
+
+function line(label, value) {
+  return `${label.padEnd(18)} ${value ?? "-"}`
+}
+
+function bullet(label, value, iconName, options = {}) {
+  const marker = options.plain ? "-" : icon(iconName, options).trim()
+  return `${marker} ${label}: ${value ?? "-"}`
+}
+
+function printRows(rows, columns) {
+  if (!rows?.length) {
+    process.stdout.write("No results yet.\n")
+    return
+  }
+  const widths = columns.map((column) =>
+    Math.max(
+      column.label.length,
+      ...rows.map((row) => String(column.value(row) ?? "-").length)
+    )
+  )
+  process.stdout.write(
+    `${columns
+      .map((column, index) => column.label.padEnd(widths[index]))
+      .join("  ")}\n`
+  )
+  process.stdout.write(`${widths.map((width) => "-".repeat(width)).join("  ")}\n`)
+  for (const row of rows) {
+    process.stdout.write(
+      `${columns
+        .map((column, index) => String(column.value(row) ?? "-").padEnd(widths[index]))
+        .join("  ")}\n`
+    )
+  }
+}
+
+function siteLabel(site) {
+  if (!site) return "Kobbe"
+  return site.domain || site.name || site.id
+}
+
+function printMe(data, options) {
+  process.stdout.write(`${icon("account", options)}Kobbe account\n\n`)
+  process.stdout.write(line("Workspace", data.workspace?.name || data.workspaceId))
+  process.stdout.write("\n")
+  process.stdout.write(line("Token scopes", data.scopes?.join(", ") || "none"))
+  process.stdout.write("\n")
+}
+
+function printSites(data, options) {
+  process.stdout.write(`${icon("sites", options)}Kobbe sites (${data.sites?.length ?? 0})\n\n`)
+  printRows(data.sites || [], [
+    { label: "Name", value: (row) => row.name },
+    { label: "Domain", value: (row) => row.domain || "-" },
+    { label: "Site ID", value: (row) => row.id },
+  ])
+}
+
+function printRevenue(data, options) {
+  const revenue = data.revenue
+  process.stdout.write(`${icon("money", options)}Money map for ${siteLabel(data.site)}\n`)
+  process.stdout.write(`${icon("range", options)}Range: ${data.range || rangeLabel(options.range)}\n\n`)
+  process.stdout.write(bullet("Orders", revenue.orders, "orders", options))
+  process.stdout.write("\n")
+  process.stdout.write(
+    bullet("Revenue", money(revenue.amount, revenue.currency), "money", options)
+  )
+  process.stdout.write("\n")
+  process.stdout.write(
+    bullet(
+      "Attributed",
+      money(revenue.attributedAmount, revenue.currency),
+      "attributed",
+      options
+    )
+  )
+  process.stdout.write("\n")
+  process.stdout.write(
+    bullet("Match rate", revenue.attributedPercent, "percent", options)
+  )
+  process.stdout.write("\n")
+  if (revenue.multipleCurrencies) {
+    process.stdout.write(
+      `\n${icon("warn", options)}Mixed currencies detected, so totals are raw cents.\n`
+    )
+  } else if (revenue.orders > 0 && revenue.attributedPercent === "100%") {
+    process.stdout.write(
+      `\n${icon("good", options)}Every sale has a trail. Very tidy.\n`
+    )
+  } else if (revenue.orders > 0) {
+    process.stdout.write(
+      `\n${icon("warn", options)}Some sales are missing attribution. Worth a look.\n`
+    )
+  } else {
+    process.stdout.write(`\n${icon("quiet", options)}No revenue in this range yet.\n`)
+  }
+}
+
+function printOverview(data, options) {
+  const overview = data.overview
+  process.stdout.write(`${icon("overview", options)}${siteLabel(data.site)} at a glance\n`)
+  process.stdout.write(`${icon("range", options)}Range: ${overview.range}\n\n`)
+  process.stdout.write(line("Visitors", overview.kpis.visitors))
+  process.stdout.write("\n")
+  process.stdout.write(line("Visits", overview.kpis.visits))
+  process.stdout.write("\n")
+  process.stdout.write(line("Views", overview.kpis.views))
+  process.stdout.write("\n")
+  process.stdout.write(line("Bounce rate", overview.kpis.bounceRate))
+  process.stdout.write("\n")
+  process.stdout.write(line("Session time", overview.kpis.sessionTime))
+  process.stdout.write("\n")
+  process.stdout.write(line("Online now", overview.kpis.online))
+  process.stdout.write("\n\n")
+  process.stdout.write(
+    `Revenue: ${money(overview.revenue.amount, overview.revenue.currency)} from ${overview.revenue.orders} orders (${overview.revenue.attributedPercent} attributed)\n\n`
+  )
+  process.stdout.write(`${icon("pages", options)}Top pages\n`)
+  printRows(overview.topPages.slice(0, 5), [
+    { label: "Path", value: (row) => row.path },
+    { label: "Visitors", value: (row) => row.visitors },
+    { label: "Views", value: (row) => row.views },
+  ])
+}
+
+function printTopPages(data, options) {
+  process.stdout.write(`${icon("pages", options)}Top pages for ${siteLabel(data.site)}\n`)
+  if (data.range || options.range) {
+    process.stdout.write(`${icon("range", options)}Range: ${data.range || rangeLabel(options.range)}\n`)
+  }
+  process.stdout.write("\n")
+  printRows(data.topPages || data.pages || [], [
+    { label: "Path", value: (row) => row.path },
+    { label: "Visitors", value: (row) => row.visitors },
+    { label: "Views", value: (row) => row.views },
+  ])
+}
+
+function printSources(data, options) {
+  process.stdout.write(`${icon("sources", options)}Traffic sources for ${siteLabel(data.site)}\n`)
+  if (data.range || options.range) {
+    process.stdout.write(`${icon("range", options)}Range: ${data.range || rangeLabel(options.range)}\n`)
+  }
+  process.stdout.write("\n")
+  printRows(data.sources || [], [
+    { label: "Source", value: (row) => row.source },
+    { label: "Visitors", value: (row) => row.visitors },
+    { label: "Views", value: (row) => row.views },
+  ])
+}
+
+function printSetupHealth(data, options) {
+  const health = data.setupHealth || data.health
+  process.stdout.write(`${icon("setup", options)}Setup check for ${siteLabel(data.site)}\n\n`)
+  process.stdout.write(line("Tracker", health.trackerInstalled ? "installed" : "missing"))
+  process.stdout.write("\n")
+  process.stdout.write(line("Pageviews", health.pageviewsAllTime))
+  process.stdout.write("\n")
+  process.stdout.write(
+    line("Revenue", health.revenueConfigured ? "connected" : "not connected")
+  )
+  process.stdout.write("\n")
+  process.stdout.write(line("Orders", health.revenueOrdersAllTime))
+  process.stdout.write("\n")
+}
+
+function printNextActions(data, options) {
+  const actions = data.nextActions || data.actions || data
+  process.stdout.write(`${icon("next", options)}Next best moves\n\n`)
+  if (!actions.length) {
+    process.stdout.write(`${icon("quiet", options)}Nothing urgent. Kobbe is calm today.\n`)
+    return
+  }
+  actions.forEach((action, index) => {
+    const marker = action.priority === "high" ? icon("warn", options) : ""
+    process.stdout.write(`${index + 1}. ${marker}${action.priority}: ${action.title}\n`)
+    process.stdout.write(`   ${action.reason}\n`)
+  })
+}
+
+function printCreateSite(data, options) {
+  process.stdout.write(`${icon("good", options)}Site created\n\n`)
+  process.stdout.write(line("Site ID", data.siteId))
+  process.stdout.write("\n")
+  process.stdout.write(line("Tracker token", data.token))
+  process.stdout.write("\n\nStore this token now. Kobbe only shows tracker tokens once.\n")
+}
+
+function printUpdateSite(data, options) {
+  process.stdout.write(`${icon("good", options)}Site updated\n`)
+}
+
+function printRotateToken(data, options) {
+  process.stdout.write(`${icon("warn", options)}Tracker token rotated\n\n`)
+  process.stdout.write(line("New token", data.token))
+  process.stdout.write("\n\nUpdate your site tracker with this token. Kobbe only shows it once.\n")
+}
+
+function printDeleteSite(data, options) {
+  process.stdout.write(`${icon("good", options)}Site deleted\n`)
+  if (data.deleted) process.stdout.write(line("Site ID", data.deleted) + "\n")
+}
+
+function printResetStats(data, options) {
+  process.stdout.write(`${icon("good", options)}Stats reset\n`)
+  if (data.reset) process.stdout.write(line("Site ID", data.reset) + "\n")
+}
+
+function printHuman(command, data, options) {
+  if (command === "me") return printMe(data, options)
+  if (command === "sites") return printSites(data, options)
+  if (command === "overview") return printOverview(data, options)
+  if (command === "revenue") return printRevenue(data, options)
+  if (command === "top-pages") return printTopPages(data, options)
+  if (command === "sources") return printSources(data, options)
+  if (command === "setup-health") return printSetupHealth(data, options)
+  if (command === "next") return printNextActions(data, options)
+  if (command === "create-site") return printCreateSite(data, options)
+  if (command === "update-site") return printUpdateSite(data, options)
+  if (command === "rotate-token") return printRotateToken(data, options)
+  if (command === "delete-site") return printDeleteSite(data, options)
+  if (command === "reset-stats") return printResetStats(data, options)
+  return printJson(data)
+}
+
+function printOutput(command, data, options) {
+  if (options.json) return printJson(data)
+  return printHuman(command, data, options)
+}
+
+function usage() {
+  process.stdout.write(`Kobbe CLI
+
+Usage:
+  kobbe login --token kbpat_... [--api https://app.kobbe.io]
+  kobbe me
+  kobbe sites
+  kobbe overview --site <site-id> [--range today]
+  kobbe revenue --site <site-id> [--range today]
+  kobbe top-pages --site <site-id> [--range today] [--limit 10]
+  kobbe sources --site <site-id> [--range today] [--limit 10]
+  kobbe next --site <site-id> [--range today]
+  kobbe setup-health --site <site-id>
+  kobbe create-site --name "My site" [--domain example.com]
+  kobbe update-site --site <site-id> [--name "New name"] [--domain example.com]
+  kobbe rotate-token --site <site-id>
+  kobbe delete-site --site <site-id> --confirm "DELETE example.com"
+  kobbe reset-stats --site <site-id> --confirm "RESET example.com"
+  kobbe mcp
+
+Add --json to print raw API responses.
+Add --plain to hide icons in human output.
+Use KOBBE_TOKEN and KOBBE_API_BASE for environment-based config.
+`)
+}
+
+async function main() {
+  const [command, ...rest] = process.argv.slice(2)
+  const options = argsToOptions(rest)
+  const client = new KobbeClient()
+
+  if (!command || command === "help" || command === "--help") {
+    usage()
+    return
+  }
+
+  if (command === "login") {
+    if (!options.token) throw new Error("Pass --token kbpat_...")
+    const config = loadConfig()
+    config.token = options.token
+    if (options.api) config.apiBase = options.api
+    saveConfig(config)
+    process.stdout.write("Kobbe token saved.\n")
+    return
+  }
+
+  if (command === "mcp") {
+    await startMcpServer()
+    return
+  }
+
+  if (command === "me")
+    return printOutput(command, await client.me(), options)
+  if (command === "sites")
+    return printOutput(command, await client.sites(), options)
+
+  const site = options.site
+  const range = options.range || "today"
+  const limit = optionalPositiveInt(options.limit)
+  if (command === "overview")
+    return printOutput(command, await client.overview(site, range), {
+      ...options,
+      range,
+    })
+  if (command === "revenue")
+    return printOutput(command, await client.revenue(site, range), {
+      ...options,
+      range,
+    })
+  if (command === "top-pages")
+    return printOutput(command, await client.topPages(site, range, limit), {
+      ...options,
+      range,
+    })
+  if (command === "sources")
+    return printOutput(command, await client.sources(site, range, limit), {
+      ...options,
+      range,
+    })
+  if (command === "setup-health")
+    return printOutput(command, await client.setupHealth(site), options)
+  if (command === "next")
+    return printOutput(command, await client.nextActions(site, range), {
+      ...options,
+      range,
+    })
+  if (command === "create-site") {
+    return printOutput(
+      command,
+      await client.createSite({
+        name: options.name || "My site",
+        domain: options.domain || null,
+      }),
+      options
+    )
+  }
+  if (command === "update-site") {
+    return printOutput(
+      command,
+      await client.updateSite(site, {
+        ...(options.name ? { name: options.name } : {}),
+        ...(Object.prototype.hasOwnProperty.call(options, "domain")
+          ? { domain: options.domain }
+          : {}),
+      }),
+      options
+    )
+  }
+  if (command === "rotate-token")
+    return printOutput(command, await client.rotateToken(site), options)
+  if (command === "delete-site")
+    return printOutput(command, await client.deleteSite(site, options.confirm), options)
+  if (command === "reset-stats")
+    return printOutput(command, await client.resetStats(site, options.confirm), options)
+
+  usage()
+  process.exitCode = 1
+}
+
+main().catch((error) => {
+  process.stderr.write(`${error.message}\n`)
+  if (error.response) {
+    process.stderr.write(`${JSON.stringify(error.response, null, 2)}\n`)
+  }
+  process.exitCode = 1
+})

package/src/client.js

@@ -0,0 +1,164 @@
+import fs from "node:fs"
+import os from "node:os"
+import path from "node:path"
+
+const DEFAULT_API_BASE = "https://app.kobbe.io"
+const CONFIG_DIR = path.join(os.homedir(), ".kobbe")
+const CONFIG_FILE = path.join(CONFIG_DIR, "config.json")
+
+export function loadConfig() {
+  try {
+    return JSON.parse(fs.readFileSync(CONFIG_FILE, "utf8"))
+  } catch {
+    return {}
+  }
+}
+
+export function saveConfig(config) {
+  fs.mkdirSync(CONFIG_DIR, { recursive: true })
+  fs.writeFileSync(CONFIG_FILE, `${JSON.stringify(config, null, 2)}\n`, {
+    mode: 0o600,
+  })
+}
+
+export function apiBase(config = loadConfig()) {
+  return process.env.KOBBE_API_BASE || config.apiBase || DEFAULT_API_BASE
+}
+
+export function apiToken(config = loadConfig()) {
+  return process.env.KOBBE_TOKEN || config.token || null
+}
+
+function queryString(params = {}) {
+  const query = new URLSearchParams()
+  for (const [key, value] of Object.entries(params)) {
+    if (value == null || value === "") continue
+    query.set(key, String(value))
+  }
+  const value = query.toString()
+  return value ? `?${value}` : ""
+}
+
+export class KobbeClient {
+  constructor(options = {}) {
+    const config = loadConfig()
+    this.baseUrl = options.baseUrl || apiBase(config)
+    this.token = options.token || apiToken(config)
+  }
+
+  async request(method, endpoint, body) {
+    if (!this.token) {
+      throw new Error(
+        "Missing token. Run `kobbe login --token kbpat_...` first."
+      )
+    }
+    const init = {
+      method,
+      headers: {
+        authorization: `Bearer ${this.token}`,
+        "content-type": "application/json",
+      },
+    }
+    if (body != null) {
+      init.body = JSON.stringify(body)
+    }
+    const response = await fetch(`${this.baseUrl}${endpoint}`, init)
+    const data = await response.json().catch(() => ({}))
+    if (!response.ok || data.ok === false) {
+      const message = data.error || `HTTP ${response.status}`
+      const error = new Error(message)
+      error.response = data
+      throw error
+    }
+    return data
+  }
+
+  me() {
+    return this.request("GET", "/api/agent/me")
+  }
+
+  sites() {
+    return this.request("GET", "/api/agent/sites")
+  }
+
+  createSite(input) {
+    return this.request("POST", "/api/agent/sites", input)
+  }
+
+  getSite(siteId) {
+    return this.request("GET", `/api/agent/sites/${encodeURIComponent(siteId)}`)
+  }
+
+  updateSite(siteId, input) {
+    return this.request(
+      "PATCH",
+      `/api/agent/sites/${encodeURIComponent(siteId)}`,
+      input
+    )
+  }
+
+  deleteSite(siteId, confirm) {
+    return this.request(
+      "DELETE",
+      `/api/agent/sites/${encodeURIComponent(siteId)}`,
+      { confirm }
+    )
+  }
+
+  overview(siteId, range = "today") {
+    return this.request(
+      "GET",
+      `/api/agent/sites/${encodeURIComponent(siteId)}/overview${queryString({ range })}`
+    )
+  }
+
+  topPages(siteId, range = "today", limit) {
+    return this.request(
+      "GET",
+      `/api/agent/sites/${encodeURIComponent(siteId)}/top-pages${queryString({ range, limit })}`
+    )
+  }
+
+  sources(siteId, range = "today", limit) {
+    return this.request(
+      "GET",
+      `/api/agent/sites/${encodeURIComponent(siteId)}/sources${queryString({ range, limit })}`
+    )
+  }
+
+  revenue(siteId, range = "today") {
+    return this.request(
+      "GET",
+      `/api/agent/sites/${encodeURIComponent(siteId)}/revenue${queryString({ range })}`
+    )
+  }
+
+  setupHealth(siteId) {
+    return this.request(
+      "GET",
+      `/api/agent/sites/${encodeURIComponent(siteId)}/setup-health`
+    )
+  }
+
+  nextActions(siteId, range = "today") {
+    return this.request(
+      "GET",
+      `/api/agent/sites/${encodeURIComponent(siteId)}/next-actions${queryString({ range })}`
+    )
+  }
+
+  rotateToken(siteId) {
+    return this.request(
+      "POST",
+      `/api/agent/sites/${encodeURIComponent(siteId)}/rotate-token`
+    )
+  }
+
+  resetStats(siteId, confirm) {
+    return this.request(
+      "POST",
+      `/api/agent/sites/${encodeURIComponent(siteId)}/reset-stats`,
+      { confirm }
+    )
+  }
+}

package/src/mcp.js

@@ -0,0 +1,230 @@
+import readline from "node:readline"
+import { KobbeClient } from "./client.js"
+
+const client = new KobbeClient()
+
+const tools = [
+  {
+    name: "list_sites",
+    description: "List Kobbe sites in the authenticated workspace.",
+    inputSchema: { type: "object", properties: {} },
+  },
+  {
+    name: "get_overview",
+    description:
+      "Get overview KPIs, top pages, sources, and revenue for a site.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        siteId: { type: "string" },
+        range: { type: "string", default: "today" },
+      },
+      required: ["siteId"],
+    },
+  },
+  {
+    name: "get_revenue",
+    description: "Get revenue totals and attribution health for a site.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        siteId: { type: "string" },
+        range: { type: "string", default: "today" },
+      },
+      required: ["siteId"],
+    },
+  },
+  {
+    name: "get_top_pages",
+    description: "Get top pages for a site by visitors and views.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        siteId: { type: "string" },
+        range: { type: "string", default: "today" },
+        limit: { type: "number", default: 10 },
+      },
+      required: ["siteId"],
+    },
+  },
+  {
+    name: "get_sources",
+    description: "Get top traffic sources for a site by visitors and views.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        siteId: { type: "string" },
+        range: { type: "string", default: "today" },
+        limit: { type: "number", default: 10 },
+      },
+      required: ["siteId"],
+    },
+  },
+  {
+    name: "get_next_actions",
+    description: "Find the next useful actions for a site.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        siteId: { type: "string" },
+        range: { type: "string", default: "today" },
+      },
+      required: ["siteId"],
+    },
+  },
+  {
+    name: "get_setup_health",
+    description: "Inspect tracker and revenue setup health for a site.",
+    inputSchema: {
+      type: "object",
+      properties: { siteId: { type: "string" } },
+      required: ["siteId"],
+    },
+  },
+  {
+    name: "create_site",
+    description: "Create a Kobbe site and return a one-time tracker token.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        name: { type: "string" },
+        domain: { type: "string" },
+      },
+      required: ["name"],
+    },
+  },
+  {
+    name: "update_site",
+    description: "Update a site name or domain.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        siteId: { type: "string" },
+        name: { type: "string" },
+        domain: { type: "string" },
+      },
+      required: ["siteId"],
+    },
+  },
+  {
+    name: "rotate_site_token",
+    description:
+      "Mint a new tracker token for a site. This changes the token used by the tracker.",
+    inputSchema: {
+      type: "object",
+      properties: { siteId: { type: "string" } },
+      required: ["siteId"],
+    },
+  },
+  {
+    name: "delete_site",
+    description:
+      "Delete a site. Requires confirm: DELETE <site domain or name>.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        siteId: { type: "string" },
+        confirm: { type: "string" },
+      },
+      required: ["siteId", "confirm"],
+    },
+  },
+  {
+    name: "reset_site_stats",
+    description:
+      "Delete analytics events for a site. Requires confirm: RESET <site domain or name>.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        siteId: { type: "string" },
+        confirm: { type: "string" },
+      },
+      required: ["siteId", "confirm"],
+    },
+  },
+]
+
+async function callTool(name, args = {}) {
+  if (name === "list_sites") return client.sites()
+  if (name === "get_overview")
+    return client.overview(args.siteId, args.range || "today")
+  if (name === "get_revenue")
+    return client.revenue(args.siteId, args.range || "today")
+  if (name === "get_top_pages")
+    return client.topPages(args.siteId, args.range || "today", args.limit)
+  if (name === "get_sources")
+    return client.sources(args.siteId, args.range || "today", args.limit)
+  if (name === "get_next_actions")
+    return client.nextActions(args.siteId, args.range || "today")
+  if (name === "get_setup_health") return client.setupHealth(args.siteId)
+  if (name === "create_site")
+    return client.createSite({ name: args.name, domain: args.domain || null })
+  if (name === "update_site")
+    return client.updateSite(args.siteId, {
+      name: args.name,
+      domain: args.domain,
+    })
+  if (name === "rotate_site_token") return client.rotateToken(args.siteId)
+  if (name === "delete_site")
+    return client.deleteSite(args.siteId, args.confirm)
+  if (name === "reset_site_stats")
+    return client.resetStats(args.siteId, args.confirm)
+  throw new Error(`Unknown tool: ${name}`)
+}
+
+function send(message) {
+  process.stdout.write(`${JSON.stringify(message)}\n`)
+}
+
+export async function startMcpServer() {
+  const rl = readline.createInterface({ input: process.stdin })
+  rl.on("line", async (line) => {
+    let request
+    try {
+      request = JSON.parse(line)
+    } catch {
+      return
+    }
+    try {
+      if (request.method === "initialize") {
+        send({
+          jsonrpc: "2.0",
+          id: request.id,
+          result: {
+            protocolVersion: "2024-11-05",
+            capabilities: { tools: {} },
+            serverInfo: { name: "@kobbe/cli", version: "0.1.0" },
+          },
+        })
+        return
+      }
+      if (request.method === "tools/list") {
+        send({ jsonrpc: "2.0", id: request.id, result: { tools } })
+        return
+      }
+      if (request.method === "tools/call") {
+        const result = await callTool(
+          request.params?.name,
+          request.params?.arguments || {}
+        )
+        send({
+          jsonrpc: "2.0",
+          id: request.id,
+          result: {
+            content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+          },
+        })
+        return
+      }
+      if (request.id != null) {
+        send({ jsonrpc: "2.0", id: request.id, result: {} })
+      }
+    } catch (error) {
+      send({
+        jsonrpc: "2.0",
+        id: request.id,
+        error: { code: -32000, message: error.message || "Kobbe MCP error" },
+      })
+    }
+  })
+}