Documentation

Everything you need to
run the numbers

Install CostPad, connect the MCP server, and understand the concepts behind every panel. No accounts required to start.

Quick start

Three steps from install to your first margin number.

1

Install the desktop app

Download CostPad for macOS. It runs fully offline — your model never leaves your machine.

Download CostPad
2

Add your costs and tiers

Enter your fixed, per-user, and per-unit costs, then define your pricing tiers. CostPad ships with sensible defaults you can edit in place.

3

Read your blended margin

Set how many users sit in each tier. The blended economics panel shows your real margin — not a best-case single-tier number.

Install

CostPad comes in three forms. Pick the one that fits your workflow.

Desktop app

The full simulator plus the built-in local MCP server. Recommended for most people.

Get it

MCP server npm

Headless server for AI assistants — no GUI required.

$ npx @costpad/mcp

COGS types

CostPad separates cost of goods sold into three kinds so your per-user math stays honest as you scale.

Fixed $/mo

Flat monthly costs that don't move with usage — hosting, databases, base subscriptions.

Per-user $/user

Costs that grow with headcount — seats, email delivery, support tooling.

Per-unit $/op

Metered costs — API calls, LLM tokens, storage, anything billed by quantity.

Categories

Tag each item as Infrastructure, API & Services, Tooling, Support, or Other for a color-coded breakdown.

Tiers & user mix

Tiers define what you sell; the user mix defines how many sit in each. Keeping them separate lets you re-run the same pricing against different audience shapes.

Pricing tier

A name, a monthly price, and the usage it allows (units per user). Color-coded for the charts.

Free · $0Pro · $49

User mix

The count of users in each tier. Revenue and margin update the moment you change a number.

Blended economics

Rather than reporting your best tier, CostPad blends every tier against your user mix into one set of numbers: COGS per subscriber, fees per subscriber, net revenue, and gross margin. Payment fees and free-tier drag are included so the margin is the one you'll actually see.

Growth & scale

Project forward from churn, growth rate, and new subscribers per month to see MRR, ARR, break-even month, and payback period. The "Monthly at Scale" panel models economics across subscriber milestones with a configurable paid-to-free ratio.

Dashboards

A product can hold many dashboards. Each dashboard is a free-form grid of panels you arrange yourself — drag to move, resize from any edge. Product data (costs, tiers, mix) is shared; dashboards only own their layout.

See the dashboard builder

MCP server

CostPad runs a local Model Context Protocol server so assistants like Claude and Cursor can read your model and run scenarios in their own flow. The full tool list, parameters, and return shapes are in the MCP reference.

Open the MCP reference

Your data

On the desktop and web apps, your model is stored locally in your browser or app storage. There are no accounts and no telemetry. The optional Cloud plan adds cross-device sync and multiple products — everything else stays on your machine.

CostPad isn't live yet — these docs describe the product as built. Package names and exact commands may change before launch.

Ready to run the numbers?

Install CostPad and model your pricing in minutes.