Skip to main content
Glama

Startup Finance Metrics (MCP-Server)

Ein MCP-Server (Model Context Protocol) zur Analyse der finanziellen Gesundheit von Startups und zur lokalen Erstellung von Kennzahlenberichten.

🔒 DATENSCHUTZ & SICHERHEIT AN ERSTER STELLE:

  • Kein Cloud-Risiko: Dieses Tool läuft zu 100 % lokal auf Ihrem Rechner/Server.

  • Keine externen Datenübertragungen: Finanzdaten werden NIEMALS an externe APIs, Cloud-Anbieter oder Drittanbieter (einschließlich SlickBooks) gesendet.

  • Keine Datenspeicherung: Der Server verarbeitet Eingaben im Arbeitsspeicher und gibt die Kennzahlen direkt an den MCP-Client zurück. Es werden keine Daten gespeichert, zwischengespeichert oder protokolliert.

  • Streng schreibgeschützt: Dieser Server führt KEINE Änderungen am Finanzstatus durch. Es handelt sich um eine rein lesende mathematische Engine.

  • Streng lokale Verarbeitung: Lässt sich sicher in Claude Desktop, Cursor, Glama und andere MCP-Clients integrieren, während die volle Datenhoheit über Ihre sensiblen Finanzdaten gewahrt bleibt.

Warum gibt es dieses Tool?

Wenn Sie als Startup-Gründer Kapital aufnehmen oder sich auf eine Vorstandssitzung vorbereiten, werden Investoren Sie oft kurzfristig nach Kennzahlen wie MRR, Burn Rate, Bruttomarge, LTV:CAC und Runway fragen. Die meisten Gründer verfolgen diese entweder nicht konsistent oder verbringen Stunden damit, Zahlen aus Kontoauszügen und Tabellenkalkulationen zusammenzusuchen, bevor sie eine Finanzierungsrunde starten.

Dieses Tool verwandelt Ihren rohen Kontoauszug (oder Stripe/QBO-Export) in wenigen Minuten in einen strukturierten Finanzbericht – komplett auf Ihrem eigenen Rechner. Kein Buchhalter für einen ersten Entwurf erforderlich. Keine sensiblen Daten verlassen Ihren Computer.

Related MCP server: plaid-mcp

Was es tut

  1. Datenaufnahme: Akzeptiert Bank-CSVs, Stripe-Export-CSVs, QBO/Xero-Export-CSVs oder eingefügte Werte. (Für beste Ergebnisse stellen Sie mindestens einen 3-monatigen Kontoauszug und aktive Nutzerstatistiken bereit. Beispieldateien finden Sie im Ordner test/).

  2. KI-Transaktionskategorisierung: Die KI klassifiziert jede Banktransaktion basierend auf der Beschreibung in Umsatz, COGS, S&M, Gehaltsabrechnung oder G&A. Dieser Schritt ist KI-gesteuert und kann Fehler machen – z. B. eine Auftragnehmerzahlung fälschlicherweise als Gehaltsabrechnung statt als COGS klassifizieren oder einen mehrdeutigen Posten übersehen. Überprüfen Sie die Kategorisierungen immer, bevor Sie Ergebnisse mit Investoren teilen.

  3. Berechnung der wichtigsten Kennzahlen: Berechnet Net Burn, Runway, Bruttomarge, CAC, LTV, Rule of 40 und mehr – über einen oder mehrere Monate in einem einzigen Vergleichsbericht.

  4. Strenge Validierung: Gibt insufficient_data mit missing_inputs zurück, anstatt Werte zu halluzinieren. Wenn Daten fehlen oder mehrdeutig sind, sagt Ihnen die Engine, was benötigt wird, anstatt zu raten.

  5. Berichterstellung: Erstellt saubere, formatierte Markdown- und HTML-Berichte – einen einheitlichen Bericht, der alle bereitgestellten Monate abdeckt, mit einem direkten Periodenvergleich.


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

Einrichtung & Installation

Option 1: Claude Desktop (Manuelle Installation für Nicht-Entwickler)

Da dieses Tool vollständig auf Ihrem eigenen Rechner läuft, um Ihre Finanzdaten zu schützen, ist eine einmalige manuelle Einrichtung erforderlich. Gute Nachricht: Sie müssen NICHT Python installiert haben! Das Tool, das wir unten verwenden (uv), lädt automatisch alles, was es benötigt, unsichtbar im Hintergrund herunter.

Schritt 1: uv installieren Dieser Server verwendet uv (einen schnellen Python-Manager), um lokal zu laufen. Falls Sie es noch nicht installiert haben:

  • Mac/Linux: Öffnen Sie Ihr Terminal und führen Sie aus: curl -LsSf https://astral.sh/uv/install.sh | sh

  • Windows: Öffnen Sie PowerShell und führen Sie aus: powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Schritt 2: Claude-Konfiguration öffnen

  1. Öffnen Sie die Claude Desktop App.

  2. Klicken Sie im Menü oben links auf Claude -> Settings (oder Preferences).

  3. Klicken Sie in der linken Seitenleiste auf den Tab Developer.

  4. Klicken Sie auf die Schaltfläche Edit Config. Dies öffnet eine Datei namens claude_desktop_config.json in Ihrem Standard-Texteditor.

Schritt 3: Server hinzufügen Ersetzen Sie den Inhalt dieser Datei durch den folgenden Code (wenn Sie bereits andere Server haben, fügen Sie einfach den startup-finance-metrics-Block in Ihre bestehenden mcpServers ein):

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

Schritt 4: Claude neu starten Speichern Sie die Datei, schließen Sie sie und starten Sie Claude Desktop vollständig neu. Sie werden nun ein neues "Hammer"-Symbol (Tools) in Ihren Claude-Chats sehen!

Option 2: Claude Code, Glama oder benutzerdefinierte Cursor-Einrichtung

Für CLI-Agenten wie Claude Code oder wenn Sie Glama und Cursor manuell konfigurieren möchten, verwenden Sie den uvx-Befehl:

Für Claude Code:

claude mcp add startup-finance -- uvx startup-finance-mcp

Für Glama / Cursor (benutzerdefinierte MCP-Konfiguration):

uvx startup-finance-mcp

Option 3: Lokale Entwicklung

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

# Run the server directly
startup-finance-mcp

Verfügbare MCP-Tools

Dieser Server stellt dem MCP-Client die folgenden Tools zur Verfügung:

  1. computeFinancialMetrics(inputs_json: str): Berechnet Startup-Finanzkennzahlen (Runway, Bruttomarge, CAC, LTV usw.) aus strukturierten Eingaben. Wird einmal pro Monat aufgerufen, wenn Daten über mehrere Monate analysiert werden.

  2. generateFinancialReport(metrics_json: str, output_dir: str): Erstellt einen einheitlichen HTML- + Markdown-Bericht. Akzeptiert entweder eine Ein-Monats-Payload oder eine Mehr-Monats-Payload {"months": [...]} – und erstellt einen Vergleichsbericht über alle bereitgestellten Zeiträume.

Verwendung als eigenständige KI-Fähigkeit

Wenn Sie nicht den vollständigen MCP-Server verwenden möchten und nur einen einfachen Prompt für Tools wie Claude Code oder OpenClaw suchen, finden Sie den rohen Skill-Prompt in skills/SKILL.md.

Kennzahlen-Referenz

#

Kennzahl

Formel

Erforderliche Eingaben

1

Net Burn

monthly_opex - monthly_revenue

monthly_opex, monthly_revenue

2

Runway

current_cash / net_burn

current_cash; erfordert net_burn > 0 (sonst Rückgabe not_applicable: business is cash flow positive)

3

Bruttomarge

(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

Berechenbar ltv, berechenbar cac

7

Umsatzwachstum

(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)

Berechenbar cac, monthly_revenue, active_customers, berechenbar gross_margin

Lizenz

MIT

Erstellt von SlickBooks

Erstellt von Mayank, Gründer von SlickBooks. SlickBooks bietet verwaltete Buchhaltung, Buchhaltungsautomatisierung, Automatisierung von Finanzprognosen und maßgeschneiderte Finanzagenten.

Available Tools

2 tools
computeFinancialMetricsA

Computes startup financial metrics from structured data.

Args: inputs_json: A JSON string containing financial inputs. Preferred: pre-categorized values like 'monthly_revenue', 'monthly_opex', 'cogs', 'sales_marketing_spend', 'business_type', etc. Also accepts a raw 'bank_csv' blob as fallback (basic totals only). Returns: JSON string containing computed metrics and missing inputs diagnostics.

ParametersJSON Schema
NameRequiredDescriptionDefault
inputs_jsonYes

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

A4.6/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Describes return format and fallback behavior. No annotations, so description covers safety. Lacks details on side effects, but tool is purely computational.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Concise with clear Args/Returns sections. Every sentence adds value.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Covers inputs, outputs (including diagnostics), and usage patterns. Output schema exists, so return values are described appropriately.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters5/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Adds extensive meaning beyond schema: explains JSON structure, lists sample keys, and distinguishes preferred vs fallback formats. Compensates for 0% schema coverage.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

Clearly states it computes startup financial metrics from structured data. Distinct from sibling generateFinancialReport which likely generates reports.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Provides guidance on preferred input formats (pre-categorized vs bank_csv fallback) but does not explicitly contrast with sibling tool.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

generateFinancialReportA

Generates a single unified HTML + Markdown financial report and saves them to disk.

Args: metrics_json: JSON string. Two accepted shapes: 1. Single-month: the direct output from computeFinancialMetrics. 2. Multi-month (preferred when user supplies multiple months of data): { "source": "...", "business_type": "saas", "industry_confidence": "high|medium|low", "industry_reasoning": "Why this industry was chosen, or why uncertain.", "period_label": "March 2026 – May 2026", "months": [ {"period": "March 2026", ...computeFinancialMetrics output for March}, {"period": "April 2026", ...computeFinancialMetrics output for April}, {"period": "May 2026", ...computeFinancialMetrics output for May} ] } Always produce ONE unified report covering all months the user supplied. Do NOT generate one report per month. output_dir: Directory to save reports to. Default is current directory. Returns: JSON with paths to both report files and the markdown content inline.

ParametersJSON Schema
NameRequiredDescriptionDefault
metrics_jsonYes
output_dirNo.

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

A4.7/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations provided, so description carries full burden. It discloses that reports are saved to disk and returns paths with inline content. However, it doesn't mention what happens if the output directory doesn't exist or if overwrite behavior, slightly reducing completeness.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Well-structured with clear sections (main action, args, returns). However, the description is somewhat lengthy and could be more concise by moving some parameter details into the schema description. Still, the front-loaded summary of the main purpose is effective.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool's complexity and the presence of an output schema (signaled), the description covers all necessary aspects: what it does, input format, output format, and usage constraints. No critical information is missing for an AI agent to use it correctly.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters5/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

With 0% schema description coverage, the description fully compensates by explaining the `metrics_json` parameter in great detail, including two accepted shapes and references to `computeFinancialMetrics`. It also clarifies the `output_dir` default. Adds significant meaning beyond the schema.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool generates a unified HTML + Markdown financial report and saves to disk. It distinguishes itself from the sibling tool 'computeFinancialMetrics' by describing the input as its output, and emphasizes producing one report covering all months.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Provides explicit guidance on when to use: after `computeFinancialMetrics`. It explains the two accepted input shapes (single-month vs multi-month) and explicitly warns against generating one report per month, which gives clear usage context.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

  1. 2 tool updatesv1.1.2
    • First observedcomputeFinancialMetrics
    • First observedgenerateFinancialReport

TDQS

A4.5/5.0

Scored across 2 tools

Disambiguation5/5

The two tools have clearly distinct purposes: one computes financial metrics from input data, the other generates a report from those metrics. No overlap or ambiguity.

Naming Consistency5/5

Both tool names follow a consistent verb_noun pattern using camelCase: computeFinancialMetrics and generateFinancialReport. No mixing of conventions.

Tool Count3/5

With only 2 tools, the server is minimally scoped. While the tools cover the core workflow, the count is at the lower boundary of what is reasonable for a finance metrics domain.

Completeness3/5

The tools cover computing metrics and generating reports, but lack operations for data input management, historical tracking, or comparisons. Some notable gaps exist.

Maintenance

ActivityInactive
ResponsivenessNo issues

Related MCP Connectors

Related MCP Servers

  • F
    license
    Not graded
    quality
    D
    maintenance
    An MCP server that reads startup pitch drafts from Notion to provide comprehensive investor-style analysis and scoring. It evaluates key areas like market opportunity and team strength, delivering feedback through a visual dashboard.
    -
  • A
    license
    A
    quality
    D
    maintenance
    A read-only MCP server that enables users to analyze their real bank, credit card, loan, and brokerage data through Plaid. It provides financial analysis tools for transactions, balances, investments, liabilities, and debt while keeping all access tokens and data locally stored.
    24
    MIT
  • A
    license
    Not graded
    quality
    B
    maintenance
    MCP server for analyzing SEC filings (10-K, 10-Q, 8-K) with industry-aware financial extraction and BERT-based NLP.
    1
    MIT
  • A
    license
    Not graded
    quality
    D
    maintenance
    An MCP server that provides deterministic finance tools for SEC filing analysis, enabling LLMs to compute financial ratios, fetch filings, and perform equity research without hallucinated numbers.
    MIT