Financial Health Scores

This pulls Altman Z-Scores and Piotroski F-Scores for public companies through Octagon MCP. You get bankruptcy risk assessment (Z-Score above 3.0 means safe, below 1.8 means distress) and a nine-point financial strength grade that checks profitability, leverage, and efficiency. It's built for value investing screens and credit analysis, though the documentation notes these metrics work better for mature manufacturers than financials or early-stage companies. The real utility is getting both scores at once since Z-Score catches leverage problems while Piotroski spots deteriorating operations. Saves you from manually calculating ratios when you need a quick read on whether a stock is genuinely cheap or just broken.

skills.sh installs: 269
GitHub stars: 130
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add octagonai/skills --skill financial-health-scores --agent claude-code

Installs into .claude/skills of the current project.

Files

Financial Health Scores

Retrieve financial health scores including Altman Z-Score and Piotroski Score for public companies using Octagon MCP.

Prerequisites

Ensure Octagon MCP is configured in your AI agent (Cursor, Claude Desktop, Windsurf, etc.). See references/mcp-setup.md for installation instructions.

Query Format

Retrieve financial health scores for <TICKER>, including the Altman Z-Score and Piotroski Score.

MCP Call:

{
  "server": "octagon-mcp",
  "toolName": "octagon-agent",
  "arguments": {
    "prompt": "Retrieve financial health scores for TSLA, including the Altman Z-Score and Piotroski Score"
  }
}

Output Format

The agent returns health scores with supporting metrics:

Altman Z-Score: 16.84 (calculated using working capital, total assets, retained earnings, EBIT, and market cap). A score above 3.0 indicates low bankruptcy risk.

Piotroski Score: 6 (out of a maximum 9). This score assesses profitability, leverage, liquidity, and operating efficiency.

Supporting Financial Metrics:

SKILL.md on GitHub