Skip to content
MCP server

Fundamental Analysis

Read-only financial ratio calculators with formulas, inputs and caveats shown

Runs locallyStatus and history
Pricing
Open source
Platforms
CLI, macOS, Windows
Runs
Locally
Version
0.1.0
Listing updated
3 days ago

About Fundamental Analysis

Fundamental Analysis is an open-source MCP server for finance and payments. It runs locally on your machine and is started by your AI client.

Each answer carries four things: the value, the formula that produced it, the inputs used and caveats to read before acting on it. The server fetches no market data and needs no API key, so the assistant must supply the figures; results are null rather than misleading when an input is zero or negative.

Ten tools cover P/E, discounted cash flow valuation (including terminal value's share and an implied share price when debt, cash and shares are given), the Graham Number, Altman Z-Score for public manufacturers or other firms, return on equity, the Piotroski F-Score with each of its nine signals, profit margins, liquidity ratios, leverage ratios and a single analyze_company call that runs every ratio the data allows.

It runs locally over stdio through npx and wraps the MIT-licensed fundamental-analysis TypeScript library. The library's own site warns that the ratings are generic rules of thumb, not investment advice, and that banks, insurers and REITs are not modelled.

Install

Run in a terminal

claude mcp add fundamental-analysis-mcp -- npx -y fundamental-analysis-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "fundamental-analysis-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "fundamental-analysis-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "fundamental-analysis-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "fundamental-analysis-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "fundamental-analysis-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "fundamental-analysis-mcp"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "fundamental-analysis-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "fundamental-analysis-mcp"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "fundamental-analysis-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "fundamental-analysis-mcp"
      ]
    }
  }
}

Tools this server provides (10)

Taken from the project documentation; the running server may differ.

pe_ratio
Price divided by EPS, with a note when EPS is zero or negative
dcf_valuation
Enterprise value from projected free cash flow, with implied share price when debt, cash and shares are given
graham_number
Graham Number and the price against it
altman_z_score
Z or Z'' score with its zone
return_on_equity
Net income divided by equity
piotroski_f_score
The 0 to 9 score with each of nine signals
profit_margin
Gross, operating, net or free cash flow margin
liquidity_ratio
Current ratio, or quick ratio without inventory
leverage_ratio
Debt to equity, or interest coverage
analyze_company
Every ratio the figures allow, grouped by category

What it does

Valuation tools
Computes P/E, DCF and the Graham Number with caveats.
Distress and quality scores
Returns Altman Z-Score and Piotroski F-Score with component signals.
Profitability and returns
Calculates return on equity and several margins.
Liquidity and leverage
Gives current or quick ratio, debt to equity and interest coverage.
One-call analysis
analyze_company groups every computable metric and names null ones.
Transparent results
Every result lists its formula and inputs.

Good for

  • Check a stock's Graham Number against its price
  • Score a company's financial health with Piotroski and Altman Z
  • Estimate enterprise value from projected cash flow
  • Get a grouped ratio snapshot from pasted statements

Pricing

Open source

MIT-licensed; runs locally via npx

Prices change. Check boffincoders.com before you buy.

Fundamental Analysis FAQ

Does it fetch market data?

No, you or the assistant bring the numbers.

Does it need an API key?

No.

Is it read-only?

Yes, every tool computes and answers without changing anything.

Which companies does it suit?

Not banks, insurers or REITs, where the library says these ratios mislead.

What licence is it under?

MIT.

Is Fundamental Analysis free?

Yes. Fundamental Analysis is open source, so you can use and self-host it for free.

How do I add Fundamental Analysis to Claude Code?

Run this command in your terminal: claude mcp add fundamental-analysis-mcp -- npx -y fundamental-analysis-mcp

What are the best alternatives to Fundamental Analysis?

The closest alternatives to Fundamental Analysis are Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, Budget Tracker, Quantivex Research and Provyan.

Alternatives to Fundamental Analysis

  1. Remote MCP server exposing the Vybe Solana API to AI clients and code editors

    • 44 tools
    • Remote
    • 2.8K GitHub stars
    • Finance and payments
  2. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  3. Budget Tracker

    MCP server

    Local MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling

    • 14 tools
    • Remote
    • Freemium
    • 2 GitHub stars
    • Finance and payments
  4. Stock scores, what a price assumes, earnings quality and quiet profit revisions

    • 11 tools
    • Remote
    • Free
    • Finance and payments
  5. Provyan

    MCP server

    Backtested crypto signal results on 94 coins, with luck odds and sources

    • 4 tools
    • Remote
    • Free
    • Finance and payments
  6. TribuJus

    MCP server

    Read-only access to UK bank accounts, cards and transactions via TrueLayer Open Banking

    Not checked yet
    • 5 tools
    • Remote
    • Open source
    • Legal and government