# Fundamental Analysis

> Fundamental Analysis is an open-source MCP server for finance and payments. Read-only financial ratio calculators with formulas, inputs and caveats shown. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, macOS, Windows, Linux
- **Website:** https://boffincoders.com/open-source/fundamental-analysis
- **Repository:** https://github.com/boffincoders/fundamental-analysis/tree/HEAD/mcp
- **MCP Registry name:** io.github.boffincoders/fundamental-analysis-mcp
- **Categories:** finance and payments
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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

## 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

- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [Quantivex Research](https://ai-powered.com/mcp/quantivex-research): Quantivex Research is a free MCP server for finance and payments.
- [Provyan](https://ai-powered.com/mcp/provyan): Provyan is a free MCP server for finance and payments.
- [TribuJus](https://ai-powered.com/mcp/tribujus): TribuJus is an open-source MCP server for legal and government.
- [L2WS](https://ai-powered.com/mcp/l2ws): L2WS is a paid MCP server for finance and payments.
- [Invoices](https://ai-powered.com/mcp/invoices): Invoices is a paid MCP server for files and documents.

---
Source: https://ai-powered.com/mcp/fundamental-analysis
