MCP Server

CostPad ships a local Model Context Protocol server so assistants like Claude and Cursor can read your pricing model and run scenarios in their own flow — fully offline, no account.

npx @costpad/mcp

The server is auth-free and reads the model you already have open in the app. Point your assistant's MCP config at it and ask it to audit COGS, compare pricing scenarios, or explain a margin.

Beyond tools, the server exposes MCP prompts (workflow skills like "what should I charge for Pro?") and resources (your live model + reference docs an assistant can read without spending a tool call).

How it connects

Your assistant talks to the local MCP server, which reads the same model the app works with — everything stays on your machine.

A typical scenario request flows like this:

Connect

Add the server to your assistant's MCP config. For Claude or Cursor, point it at the @costpad/mcp command:

{
  "mcpServers": {
    "costpad": {
      "command": "npx",
      "args": ["@costpad/mcp"]
    }
  }
}

Add "--read-only" to args to expose only the read & analyze tools (no changes to your model).

Presets and configuration

Boot from a realistic sample dataset instead of the built-in defaults:

npx @costpad/mcp --preset b2b-saas

Available presets: b2b-saas and usage-based-api. Mid-session, the load_preset tool loads any preset and reset_state returns to defaults.

Configuration resolves high → low: CLI flag (--preset, --read-only, --config) → environment (COSTPAD_PRESET, COSTPAD_READ_ONLY, COSTPAD_CONFIG) → JSON config file → built-in defaults. --preset and --read-only are independent — you can boot a preset in read-only mode.

Reference

• Tools — all 23 tools, their parameters, and which are available in read-only mode.
• Prompts — workflow "skills" and ecosystem recipes the server registers.
• Resources — your live model, saved scenarios, and reference docs, readable without a tool call.
• Desktop bridge — how the server connects to a running CostPad Desktop for live mutations and pulling the user's real product.