startup-valuation 1.0.0

Comprehensive startup valuation library implementing 80+ formulas from the Startup Valuation textbook. Includes Python library, MCP server, and AI-Agent Skills.

Startup Valuation Engine

Comprehensive startup valuation library implementing 80+ formulas from the Startup Valuation textbook. Python library + MCP server + AI-Agent Skills.

Overview

A production-grade Python library for startup valuation, implementing every formula from the Startup Valuation textbook. Designed for developers, financial analysts, and AI agents who need auditable, structured valuation computations.

Three-layer architecture:

1. Python Library — 14 modules, 80+ typed functions, all returning ValuationResult (value + assumptions + sensitivity)
2. MCP Server — 60+ tools for AI agents (Claude, OpenCode, etc.) via stdio/SSE
3. AI-Agent Skills — 5 skill definitions with workflow guidance for valuation domains

Installation

pip install startup-valuation          # library only
pip install startup-valuation[mcp]     # + MCP server
pip install startup-valuation[dev]     # + pytest, ruff, coverage

Quick Start

Python Library

from startup_valuation.core import scorecard_valuation, vc_method_post_money
from startup_valuation.advanced import black_scholes, scenario_analysis
from startup_valuation.types import Scenario

# Scorecard Method (pre-revenue startups)
result = scorecard_valuation(
    average_valuation=1_500_000,
    weights=[0.30, 0.25, 0.15, 0.10, 0.10, 0.05, 0.05],
    scores=[1.25, 1.50, 1.20, 0.75, 1.00, 0.90, 1.00],
)
print(f"Scorecard: ${result.value:,.0f}")  # $1,800,000

# Black-Scholes for real options (startup equity)
result = black_scholes(
    underlying=20_000_000, strike=5_000_000,
    risk_free_rate=0.05, volatility=0.40, time_to_maturity=1.0,
)
print(f"Option value: ${result.value:,.0f}")  # $15,240,000

# Scenario Analysis
scenarios = [
    Scenario("bull", 0.20, 10_000_000),
    Scenario("base", 0.60, 5_000_000),
    Scenario("bear", 0.20, 1_000_000),
]
result = scenario_analysis(scenarios)
print(f"Expected value: ${result.value:,.0f}")  # $5,200,000

MCP Server (for AI Agents)

cd mcp_server && python server.py

Connect with any MCP-compatible AI agent. All 60+ valuation tools available.

AI-Agent Skills

Copy the skills/ directory to your agent's skills folder:

• valuation-core — Scorecard, Berkus, VC Method, Risk Factor Summation
• valuation-advanced — Black-Scholes, Binomial, Monte Carlo, Scenario Analysis
• valuation-industry — SaaS, Biotech, Fintech, Marketplace, Hardware
• valuation-stakeholder — Dilution, OPM, PWERM, Liquidation Preference
• valuation-emerging — SAFE, Crypto (MV=PQ), ESG, Metcalfe's Law

Valuation Methods by Category

Category	Methods	Chapter
Probability	Expected value, joint probability, Poisson	2
Time Value	PV, NPV, annuity	2
CAPM	CAPM, portfolio beta, startup-adjusted	2
Core	Scorecard, Berkus, Risk Factor, VC Method	3
Advanced	Black-Scholes, Binomial, Monte Carlo, Scenario	4
Comparables	P/E, P/S, EV/EBITDA, regression-adjusted	5
SaaS	LTV, CAC, NRR, Magic Number, Rule of 40	11
Biotech	rNPV, decision tree, peak sales, pipeline	11
Fintech	Payment revenue, lending, neobank, network effects	11
Marketplace	GMV, take rate, liquidity, network density	11
Hardware	TRL-adjusted, break-even, P-weighted DCF	11
International	PPP, CRP, currency-adjusted DCF, Damodaran	12
Stakeholders	Dilution, OPM, PWERM, liquidation, synergies	13
Emerging	SAFE, MV=PQ, ESG, Metcalfe's, data moat	14

Why This Library?

• Auditable — Every function returns ValuationResult with value, method, inputs, assumptions, and sensitivity analysis
• Textbook-accurate — All formulas verified against book example values with unit tests
• AI-ready — MCP server and Skills for seamless AI agent integration
• Industry-specific — Dedicated modules for SaaS, biotech, fintech, marketplace, and hardware startups
• Open source — MIT license, extensible, well-documented

Development

# Install dev dependencies
pip install -e ".[dev]"

# Run tests (146 tests, ~6s)
pytest

# Run with coverage
pytest --cov=startup_valuation --cov-report=term-missing

# Lint
ruff check .

# Type check
mypy src/startup_valuation

Documentation

• API Reference: GitHub Pages
• Chapter Index: Maps every function to its textbook chapter
• Examples: Interactive code snippets for each valuation category

Citing This Project

@software{startup_valuation_engine,
  author = {Mak, Simon},
  title = {Startup Valuation Engine},
  year = {2026},
  url = {https://github.com/simonplmak-cloud/startup-valuation},
  license = {MIT},
}

Based on formulas from the Startup Valuation textbook. See output/ for the full textbook source in markdown.

License

MIT — see LICENSE for details.