Startup Finance Metrics (MCP Server)

An MCP (Model Context Protocol) server for analyzing startup financial health and generating metrics reports locally.

🔒 PRIVACY & SECURITY FIRST: - Zero Cloud Risk: This tool runs 100% locally on your machine/server. - No Data Sent Externally: Financial data is NEVER sent to any external API, cloud provider, or third-party service (including SlickBooks). - No Data Storage: The server processes inputs in-memory and returns the metrics directly to the MCP client. No data is stored, cached, or logged. - Strictly Read-Only: This server executes NO financial state changes. It is a strictly read-only mathematical engine. - Strictly Local Processing: Safely integrates with Claude Desktop, Cursor, Glama, and other MCP clients while maintaining full data sovereignty over your sensitive financial inputs.

Why This Exists

If you're a startup founder raising funds or preparing for a board meeting, investors will ask you for metrics like MRR, burn rate, gross margin, LTV:CAC, and runway — often on short notice. Most founders either don't track these consistently, or spend hours pulling numbers from bank statements and spreadsheets before every fundraise.

This tool turns your raw bank statement (or Stripe/QBO export) into a structured financial metrics report in minutes, entirely on your own machine. No accountant required for a first pass. No sensitive data leaving your computer.

What It Does

Ingests Data: Accepts bank CSVs, Stripe export CSVs, QBO/Xero export CSVs, or pasted values. (For best results, provide a minimum 3-month bank statement and active user stats. Sample files are available in the test/ folder).
AI Transaction Categorization: The AI classifies each bank transaction into revenue, COGS, S&M, payroll, or G&A based on the description. This step is AI-driven and can make mistakes — e.g. misclassifying a contractor payment as payroll vs. COGS, or missing an ambiguous line item. Always review the categorizations before sharing results with investors.
Computes Key Metrics: Calculates Net Burn, Runway, Gross Margin, CAC, LTV, Rule of 40, and more — across one or multiple months in a single comparative report.
Strict Validation: Returns insufficient_data with missing_inputs instead of hallucinating values. If data is missing or ambiguous, the engine tells you what's needed rather than guessing.
Generates Reports: Creates clean, formatted Markdown and HTML reports — one unified report covering all months supplied, with side-by-side period comparison.

--- mcp-name: io.github.MayankTalwar0/startup-finance-metrics

Setup & Installation

Option 1: Claude Desktop (Manual Installation for Non-Developers)

Since this tool runs entirely on your own machine to protect your financial data, it requires a one-time manual setup. Good News: You do NOT need to have Python installed! The tool we use below (uv) will automatically download everything it needs invisibly in the background.

Step 1: Install uv This server uses uv (a fast Python manager) to run locally. If you don't have it installed:

Mac/Linux: Open your Terminal and run: curl -LsSf https://astral.sh/uv/install.sh | sh
Windows: Open PowerShell and run: powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Step 2: Open Claude's Configuration

Open the Claude Desktop App.
In the top left menu, click Claude -> Settings (or Preferences).
Click on the Developer tab in the left sidebar.
Click the Edit Config button. This will open a file named claude_desktop_config.json in your default text editor.

Step 3: Add the Server Replace the contents of that file with the following code (if you already have other servers, just add the startup-finance-metrics block inside your existing mcpServers):

{
  "mcpServers": {
    "startup-finance-metrics": {
      "command": "uvx",
      "args": [
        "startup-finance-mcp"
      ]
    }
  }
}

Step 4: Restart Claude Save the file, close it, and completely restart Claude Desktop. You will now see a new "hammer" (Tools) icon in your Claude chats!

Option 2: Claude Code, Glama, or Custom Cursor setup

For CLI agents like Claude Code, or if you prefer to manually configure Glama and Cursor, use the uvx command:

For Claude Code: ``bash claude mcp add startup-finance -- uvx startup-finance-mcp ``

For Glama / Cursor (Custom MCP config): ``bash uvx startup-finance-mcp ``

Option 3: Local Development

git clone https://github.com/MayankTalwar0/startup-finance-metrics.git
cd startup-finance-metrics
pip install -e .

# Run the server directly
startup-finance-mcp

Available MCP Tools

This server provides the following tools to the MCP client:

computeFinancialMetrics(inputs_json: str): Computes startup financial metrics (runway, gross margin, CAC, LTV, etc.) from structured inputs. Called once per month when analyzing multi-month data.
generateFinancialReport(metrics_json: str, output_dir: str): Renders a unified HTML + Markdown report. Accepts either a single-month payload or a multi-month {"months": [...]} payload — producing one comparative report across all periods supplied.

Using as a Standalone AI Skill

If you don't want to use the full MCP server and just want a simple prompt to use in tools like Claude Code or OpenClaw, you can find the raw skill prompt in skills/SKILL.md.

Metrics Reference

| # | Metric | Formula | Required inputs | |---|---|---|---| | 1 | Net Burn | monthly_opex - monthly_revenue | monthly_opex, monthly_revenue | | 2 | Runway | current_cash / net_burn | current_cash; requires net_burn > 0 (else returns not_applicable: business is cash flow positive) | | 3 | Gross Margin | (monthly_revenue - cogs) / monthly_revenue 100 | monthly_revenue, cogs | | 4 | CAC | sales_marketing_spend / new_customers | sales_marketing_spend, new_customers | | 5 | LTV | (ARPU gross_margin) / logo_churn_rate | monthly_revenue, active_customers, lost_customers, cogs | | 6 | LTV:CAC | ltv / cac | Computable ltv, computable cac | | 7 | Revenue Growth | (monthly_revenue - prev_monthly_revenue) / prev_m... 100 | monthly_revenue, prev_monthly_revenue | | 8 | Logo Churn | lost_customers / active_customers 100 | lost_customers, active_customers | | 9 | Burn Multiple | net_burn / (arr_end - arr_start) | monthly_opex, monthly_revenue, arr_start, arr_end | | 10 | NRR | (start + exp - churn - cont) / start 100 | starting_mrr, expansion_mrr, churned_mrr, contraction_mrr | | 11 | Rule of 40 | revenue_growth_yoy_pct + operating_margin_pct | revenue_growth_yoy_pct, operating_margin_pct | | 12 | CAC Payback | cac / (ARPU gross_margin) | Computable cac, monthly_revenue, active_customers, computable gross_margin |

License

MIT

Built By SlickBooks

Built by Mayank, founder of SlickBooks. SlickBooks provides managed bookkeeping, bookkeeping automation, financial forecast automation, and custom finance agents.

startup-finance-metrics