io.github.wizard-exe/stoxly

Stoxly MCP Server

Free stock, ETF and crypto analysis for AI agents, powered by Stoxly.

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) — any US-listed ETF against 10 fund criteria (expense ratio, fund size, fund age, holdings, concentration, volatility, 1/3/5-year returns) — and any crypto-asset listed on CoinGecko or CoinPaprika against 10 crypto criteria (market cap, market cap rank, 24h volume/market cap, exchange count, supply issued, project age, developer commits, volatility, 1/3-year returns). Each analysis returns a 0–10 score, a descriptive verdict, every underlying metric and a link to the full analysis page.

Available as a remote MCP server (Streamable HTTP, nothing to install) and as a stdio server (server.js, for clients and platforms that run MCP servers as a local process — e.g. Glama, Docker).

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_crypto - Analysis of a crypto-asset (coin or token). Returns a 0-10 crypto 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

analyze_crypto

Analysis of a crypto-asset (coin or token). Returns coin name, price, the 10-point score, verdict, per-criterion checks (market cap, market cap rank, 24h volume/market cap, exchange count, supply issued, project age, developer commits, volatility, 1-year and 3-year returns), all metric values and the canonical analysis URL. Unknown symbols return an error.

Parameters:

• symbol (string, required): Crypto ticker symbol, e.g. BTC, ETH, SOL (a -USD suffix is accepted)

Setup

Local stdio server

git clone https://github.com/wizard-exe/Stoxly-mcp.git
cd Stoxly-mcp
npm ci
node server.js

Or with Docker:

docker build -t stoxly-mcp .
docker run -i --rm stoxly-mcp

MCP client config (stdio):

{
  "mcpServers": {
    "stoxly": {
      "command": "node",
      "args": ["/path/to/Stoxly-mcp/server.js"]
    }
  }
}

The stdio server fetches the scored analysis from https://www.stoxlyonline.com/api/analyze (type=stock|etf|crypto, same 30 requests per IP per hour limit). No API key or environment variables are required.

Claude Code

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

{
  "mcpServers": {
    "stoxly": {
      "url": "https://www.stoxlyonline.com/api/mcp"
    }
  }
}

Example

"Analyze AAPL's fundamentals"

The agent calls analyze_stock with {"symbol": "AAPL"} and receives:

{
  "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). Crypto market, supply and developer data comes from CoinGecko with CoinPaprika as fallback; crypto price history from Yahoo Finance. Scoring thresholds are documented at stoxlyonline.com/about and in llms-full.txt.

Disclaimer

For educational purposes only — not financial advice. Data may be delayed.