Fundamental Analysis
Read-only financial ratio calculators with formulas, inputs and caveats shown
- 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-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"fundamental-analysis-mcp": {
"command": "npx",
"args": [
"-y",
"fundamental-analysis-mcp"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"fundamental-analysis-mcp": {
"command": "npx",
"args": [
"-y",
"fundamental-analysis-mcp"
]
}
}
}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

Solana MCP by Vybe
MCP serverRemote MCP server exposing the Vybe Solana API to AI clients and code editors
- 44 tools
- Remote
- 2.8K GitHub stars
- Finance and payments

Tapetide - Indian Stock Market MCP
MCP serverIndian NSE and BSE stock market data for AI assistants through 48 MCP tools
- 17 tools
- Remote
- Freemium
- 150 GitHub stars
- Finance and payments
Budget Tracker
MCP serverLocal MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling
- 14 tools
- Remote
- Freemium
- 2 GitHub stars
- Finance and payments

Quantivex Research
MCP serverStock scores, what a price assumes, earnings quality and quiet profit revisions
- 11 tools
- Remote
- Free
- Finance and payments

Provyan
MCP serverBacktested crypto signal results on 94 coins, with luck odds and sources
- 4 tools
- Remote
- Free
- Finance and payments
TribuJus
MCP serverRead-only access to UK bank accounts, cards and transactions via TrueLayer Open Banking
Not checked yet- 5 tools
- Remote
- Open source
- Legal and government