AI Assistant Setup

Connect Claude Desktop, Claude Code, or ChatGPT to your live store data over MCP.

Generate an API key and add the Keelvia MCP server to your AI assistant — it can then read your profit summary, P&L, unit economics, and marketing performance to answer questions with real numbers.

MCP API key

No key yet. Generate one to connect an AI assistant.

MCP endpoint

https://your-keelvia-host/api/mcp

Accepts JSON-RPC 2.0 over POST. Authorize with Authorization: Bearer <key>.

Claude Desktop

Add to claude_desktop_config.json, then restart Claude Desktop.

{
  "mcpServers": {
    "keelvia": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://your-keelvia-host/api/mcp",
        "--header",
        "Authorization: Bearer <YOUR_API_KEY>"
      ]
    }
  }
}

Claude Code

Run in your terminal to register the server.

claude mcp add keelvia --transport http https://your-keelvia-host/api/mcp \
  --header "Authorization: Bearer <YOUR_API_KEY>"

Generic HTTP (curl)

Any client that speaks JSON-RPC 2.0 over HTTPS can connect.

curl -s https://your-keelvia-host/api/mcp \
  -H "Authorization: Bearer <YOUR_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Available tools

get_profit_summaryProfit & sales vs targets, this month
get_pnlProfit & loss by month (trailing 12)
get_unit_economicsAOV, CAC, LTV, LTV:CAC
get_marketingChannel spend, ROAS, profit after costs