---
name: "xpay-financial-modeling-prep-getfinancialscores"
description: "Assess a company's financial strength using the Financial Health Scores API. This API provides key metrics such as the Altman Z-Score and Piotroski Score, giving users insights into a company’s overall financial health and stability."
version: "1.0.0"
price: "$0.01/call"
provider: "Financial Modeling Prep"
---

# GetFinancialScores

Assess a company's financial strength using the Financial Health Scores API. This API provides key metrics such as the Altman Z-Score and Piotroski Score, giving users insights into a company’s overall financial health and stability.

**Provider:** Financial Modeling Prep
**Price:** $0.01/call
**Pricing model:** Flat rate per call

## When to Use

Use this tool when you need to assess a company's financial strength using the financial health scores api. this api provides key metrics such as the altman z-score and piotroski score, giving users insights into a company’s overall financial health and stability.. This is part of the Financial Modeling Prep provider on xpay✦.

## MCP Connection

Connect to xpay✦ to access this tool (and 252+ others):

```json
{
  "mcpServers": {
    "xpay": {
      "url": "https://mcp.xpay.sh/mcp?key=YOUR_API_KEY"
    }
  }
}
```

For Claude Code:
```bash
claude mcp add --transport http xpay "https://mcp.xpay.sh/mcp?key=YOUR_API_KEY"
```

## How to Execute

Use the xpay✦ meta-tools to run this tool:

1. **`xpay_details`** — Get full input schema: `xpay_details("financial-modeling-prep/getFinancialScores")`
2. **`xpay_run`** — Execute: `xpay_run("financial-modeling-prep/getFinancialScores", { ...inputs })`

## Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | number | No | Limit on number of results (default: 100, max: 1000) |
| `symbol` | string | Yes | Stock symbol |

## Pricing

- **Cost:** $0.01/call
- **Balance check:** Use `xpay_balance` to check remaining credits
- Get your API key at [xpay.tools](https://xpay.tools/account/settings/api-keys/) — $5 free credits included

## Related Skills

- [Financial Modeling Prep (all tools)](https://xpay.tools/skills/financial-modeling-prep/SKILL.md) — 253 tools
- [SearchSymbol](https://xpay.tools/skills/financial-modeling-prep/searchsymbol/SKILL.md) — $0.01/call
- [SearchName](https://xpay.tools/skills/financial-modeling-prep/searchname/SKILL.md) — $0.01/call
- [SearchCIK](https://xpay.tools/skills/financial-modeling-prep/searchcik/SKILL.md) — $0.01/call
- [SearchCUSIP](https://xpay.tools/skills/financial-modeling-prep/searchcusip/SKILL.md) — $0.01/call
- [SearchISIN](https://xpay.tools/skills/financial-modeling-prep/searchisin/SKILL.md) — $0.01/call

## Links

- Tool page: https://xpay.tools/financial-modeling-prep/getfinancialscores/
- Provider: https://xpay.tools/financial-modeling-prep/
- All tools: https://xpay.tools/explore