Installation guide

Install the CostPad desktop app or the headless MCP server, and connect your assistant.

CostPad comes in a few forms — pick the one that fits your workflow. Everything runs locally; no account is required to start.

Desktop app

The full simulator plus the built-in local MCP server and Desktop bridge. Recommended for most people. (Download)

The same simulator in the browser at costpad.dev — your model is stored locally in your browser.

A headless server for AI assistants, no GUI required:

npx @costpad/mcp

Add --read-only to expose only the read & analyze tools, or --preset b2b-saas to boot from a sample dataset. See Presets and configuration.

Point your assistant's MCP config at the @costpad/mcp command. For Claude Desktop (claude_desktop_config.json):

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

See the MCP server guide for the full tool, prompt, and resource reference.