io.github.wizard-exe/stoxly
Free fundamental stock & ETF analysis: 10-point score, verdict and key metrics for any ticker.
Open source Repository Open in the app JSON README (API)
About
Free fundamental stock & ETF analysis: 10-point score, verdict and key metrics for any ticker.
Details
- Kind
- MCP servers
- Topic
- Finance & crypto
- Publisher
- wizard-exe
- Origin
- official
- Category
- ferramentas
- Transport
- http
- Version
- 1.0.0
- Last push
- 2026-08-10T21:39:48Z
- Repository state
- ativo
- Language
- Dockerfile
- License
- MIT
- Added
- 2026-08-29 04:01:40
- Updated
- 2026-08-29 04:01:40
- Origin id
io.github.wizard-exe/stoxly
README
# Stoxly MCP Server
[](https://smithery.ai/servers/stoxlyanalysis/stoxly)
Free fundamental analysis of stocks and ETFs for AI agents, powered by [Stoxly](https://www.stoxlyonline.com).
Stoxly evaluates any publicly traded company against a 10-point fundamental checklist (P/E, PEG, price/book, revenue growth, ROE, operating margin, return on assets, quick ratio, debt/equity, free cash flow yield) — and any US-listed ETF against 10 fund criteria (expense ratio, fund size, fund age, holdings, concentration, volatility, 1/3/5-year returns). Each analysis returns a 0–10 score, a descriptive verdict, every underlying metric and a link to the full analysis page.
This is a **remote MCP server** — nothing to install or run locally.
**Docs:** https://www.stoxlyonline.com/mcp
## Endpoint
```
https://www.stoxlyonline.com/api/mcp
```
- Transport: Streamable HTTP
- Authentication: none
- Rate limit: 30 tool calls per IP per hour
## Tools
- `analyze_stock` - Fundamental analysis of a publicly traded stock. Returns a 0-10 fundamental score, a descriptive verdict, 10 per-criterion checks, all underlying metrics and a link to the full analysis page.
- `analyze_etf` - Analysis of a US-listed ETF. Returns a 0-10 fund score, a descriptive verdict, 10 per-criterion checks, all underlying metrics and a link to the full analysis page.
### analyze_stock
Fundamental analysis of a publicly traded stock. Returns company name, price, the 10-point `score`, a descriptive `verdict`, per-criterion `checks` (P/E, PEG, price/book, revenue growth, ROE, operating margin, return on assets, quick ratio, debt/equity, free cash flow yield), all metric values and the canonical analysis URL. `null` means a metric was unavailable — never treat it as 0.
**Parameters:**
- `symbol` (string, required): Ticker in Yahoo Finance format, e.g. `AAPL`, `BRK-B`, `SAP.DE`
### analyze_etf
Analysis of a US-listed ETF. Returns fund name, price, the 10-point `score`, `verdict`, per-criterion `checks` (expense ratio, fund size, fund age, holdings, concentration, volatility, 1/3/5-year returns), all metric values and the canonical analysis URL.
**Parameters:**
- `symbol` (string, required): Ticker, e.g. `VOO`, `QQQ`, `SCHD`
## Setup
### Claude Code
```bash
claude mcp add --transport http stoxly https://www.stoxlyonline.com/api/mcp
```
### Claude (Desktop / claude.ai)
Settings → Connectors → **Add custom connector** → URL: `https://www.stoxlyonline.com/api/mcp`
### Cursor / other MCP clients
```json
{
"mcpServers": {
"stoxly": {
"url": "https://www.stoxlyonline.com/api/mcp"
}
}
}
```
## Example
> "Analyze AAPL's fundamentals"
The agent calls `analyze_stock` with `{"symbol": "AAPL"}` and receives:
```json
{
"symbol": "AAPL",
"companyName": "Apple Inc.",
"score": "7/10 criteria met",
"verdict": "Strong Fundamentals",
"checks": { "revenueGrowth": true, "peRatio": false, "...": "..." },
"metrics": { "peRatio": 33.2, "roe": 104.2, "...": "..." },
"url": "https://www.stoxlyonline.com/analysis/AAPL"
}
```
## Data & methodology
Data is aggregated from Financial Modeling Prep, Yahoo Finance, Finnhub and Alpha Vantage, plus official regulatory filings (SEC EDGAR for US filers, ESEF/UKSEF via filings.xbrl.org for Europe/UK). Scoring thresholds are documented at [stoxlyonline.com/about](https://www.stoxlyonline.com/about) and in [llms-full.txt](https://www.stoxlyonline.com/llms-full.txt).
## Disclaimer
For educational purposes only — not financial advice. Data may be delayed.