HPSILab Quant Finance MCP server
online · 96% uptimeio.github.haiyunsky/hpsilab-quant-finance-mcp·v0.11.1·1 starsStock & options risk analytics for AI agents: pre-trade risk scan, IV, gamma walls, Monte Carlo.
1 stars176 downloads/wk
Reviews
Write oneNobody has reviewed HPSILab Quant Finance yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
HPSILab Quant Finance tools (10)
write = sends, deletes, buys or postsanalyze_stockFreeAggregate all quant tools into one JSON stock analysis. The tool reuses the existing MCP tools as its data sources, then derives a direction signal, direction score, bullish factors, bearish factors and plain-English summary. If one underlying tool is gated, unavailable or raises an error, the remaining tools still contribute to the final result (status "partial"); if every underlying tool fails, the whole call fails (status "error", isError=True) instead of a misleadingly "successful" empty analysis. Args: symbol: Stock symbol, e.g. "NVDA". refresh: Request fresh IV Radar data instead of using the backend's fresh IV cache. Defaults to False. lang: Language for `summary`, `bullish_factors` and `bearish_factors` - "en" (default), "zh" or "ja"; regional forms like "zh-CN" are accepted. Everything else in the response, `signal` included, is language-independent, so an existing caller that omits this gets byte-identical output to before.
generate_stock_imagesFreeGenerate stock-report PNG images and return their URLs. This is intentionally separate from analyze_stock so the JSON analysis stays fast and light. The backend reuses the same Growth Engine image generators used by email/social publishing. Args: symbol: Stock symbol, e.g. "RXRX". force: Regenerate images instead of using cached PNGs. Defaults to True so manually requested images reflect the latest available data. types: Optional subset of chart types. Allowed values are "ai_prediction", "iv_radar", "option_pressure", "monte_carlo", and "equity_curves". Omit to generate every chart type.
generate_stock_research_reportFreeFull markdown research report with five stock-report charts. Pro tool ($0.35/call via x402 for anonymous callers; free within plan limits for signed-in accounts, subject to a monthly report quota). Runs analyze_stock and stock-report image generation concurrently, then renders a presentation-ready markdown report (direction, direction score, bullish / bearish factors, source-tool status, and the five chart embeds). The markdown is returned for display and the same data is mirrored in structured JSON. Signed-in hpsilab users call this within their plan's free rate limits. Anonymous / tokenless agents pay per call via x402 (USDC on Base) when payments are enabled — send the x402 payment in the request _meta. Args: symbol: Stock symbol, e.g. "RXRX". refresh: Bypass the backend's fresh IV cache for the IV-driven modules. Defaults to False. force_images: Force a fresh image render instead of reusing the backend's image cache. Defaults to False.
get_ai_predictionFreeAI next-day prediction: probability the stock closes UP, a paper-trading buy/watch/sell lean (research only, not a trade instruction), and how strongly the models agree (consensus). Available to every authenticated plan (Free / Pro / Enterprise); subject to the caller's plan requests/day and requests/minute limits. Args: ticker: Stock symbol, e.g. "TSLA".
get_equity_curveFreeBacktest performance of the quant strategy across your watchlist: Sharpe ratio, max drawdown, win rate and total return per symbol. Available to every authenticated plan (Free / Pro / Enterprise); subject to the caller's plan requests/day and requests/minute limits. Args: ticker: Optional symbol to show just one row, e.g. "SPY". Leave blank for all.
get_iv_radarFreeImplied-volatility (IV) structure for a stock: how expensive options are, whether volatility is being squeezed, and whether traders are paying up for upside (calls) or downside (puts). Available to all signed-in users. Args: ticker: Stock symbol, e.g. "NVDA". refresh: Bypass the backend's fresh IV cache and request the latest option-chain pull. Defaults to False.
get_monte_carloFreeMonte Carlo price simulation for the next ~10 trading days: thousands of random price paths estimate a likely price range and the odds of finishing higher. Args: ticker: Stock symbol, e.g. "AAPL".
get_option_pressureFreeOption-chain pressure map for the nearest weekly/monthly expiry — Max Pain, dealer Gamma Wall, likely weekly high, and an extreme squeeze target. Args: ticker: Stock symbol, e.g. "SPY".
get_pretrade_risk_scanFreeFull pre-trade risk scan JSON for a stock. Pro tool ($0.15/call via x402 for anonymous callers; Credits for signed-in accounts). Signed-in hpsilab users (including Free, on its trial Credits) spend Credits from their balance at this tool's catalog price — each tool is priced differently; see GET /api/credits/catalog. Anonymous / tokenless agents pay per call via x402 (USDC on Base) when payments are enabled — send the x402 payment in the request _meta. Args: symbol: Stock symbol, e.g. "NVDA".
register_accountFreeRegister a free hpsilab account for yourself, with no human involvement, and receive an API key immediately. Call this when the user has no API key yet and asks to sign up from here, or when a refusal's `next_actions` names register_account and the user agrees. This is the only tool that works without an API key. You do not need a password, a wallet, or a web browser. The account is bound to you server-side, so calls you make after this are metered as your account even though you cannot change your own Authorization header. The account is created unverified, with only a capped evaluation allowance and no trial Credits, until the email address is confirmed; confirming it grants the one-time 100-Credit Registered Trial (14 days). Ask the human you are working with to click the link in the email that will arrive. Calling again from the same caller returns the same account with a fresh key; an address that belongs to another account is refused. A valid user email address is required. Do not call this tool with an empty or fabricated email address. If the user's email is unavailable, ask the user to provide it before calling register_account. Args: email: The real user email address that will receive verification.
Public scan report
scanner v0.1.10 · 2026-10-30 · same rubric, same numbers if you re-run it
- Code scan6 source files scanned25/25
- Live reliabilityremote reachable in 1434ms20/20
- Tool poisoning10 tool descriptions checked15/15
- Auth qualityAPI key sent as a header8/15
- Maintenancelast push 5 days ago15/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
How HPSILab Quant Finance compares
Against every graded Finance MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 91/100
- higher than 93% of 1,759 Finance servers
- Tools
- 10
- the typical Finance server has 8
- Tools that change things
- 0%
- typical: 0%. Fewer write tools means less an agent can break
- Uptime
- 96%
- of our recent checks; the typical remote Finance server answers 100%
- Response time
- 410 ms
- faster than 39% of 1,131 Finance servers
- GitHub stars
- 1
- more than 60% of 945 Finance servers
- Downloads a week
- 176
- more than 80% of 422 Finance servers with a package
What its tools let an agent do: 7 read · 3 create
Release history: 5 versions in the registry since 2026-08-28, latest 2026-10-24, typically one every 12 days.
Install HPSILab Quant Finance in Claude Code, Cursor or VS Code
claude mcp add --transport http hpsilab-quant-finance-mcp https://hpsilab.com/mcp
What the publisher says
From the HPSILab Quant Finance repository's README, as published. We do not edit it. Read it on GitHub
HPSILab Quant Finance MCP Server for Stock & Options Analytics
<!-- mcp-name: io.github.haiyunsky/hpsilab-quant-finance-mcp -->
HPSILab is an open-source Python quantitative finance MCP server for research on US equities, ETFs, and supported options. It brings stock signals, implied volatility, options analytics, Monte Carlo simulation, AI prediction, backtesting, and risk analysis into ChatGPT, Claude, Cursor, VS Code, and other MCP clients. Connect once, ask in natural language, and receive structured results that an assistant can compare and explain.
Research and educational use only. HPSILab does not provide investment advice
and does not execute trades.
Get a Free API Key · Pricing · Tool reference · Client setup · Python SDK
Connect: hosted Streamable HTTP
Recommended, and requires no local installation.
generate an API key from Settings.
- Register a free account, sign in, and
hpsiyourkey. Never commit a real key or paste one into chat.
- Add the server to your client's private configuration, replacing
The example below is Claude Code's .mcp.json; other clients use different configuration schemas, all covered in client setup.
{
"mcpServers": {
"hpsilab": {
"type": "http",
"url": "https://hpsilab.com/mcp",
"headers": {
"Authorization": "Bearer hpsi_your_key"
}
}
}
}- Verify the connection:
Use HPSILab to analyze AAPL. Separate observed metrics from interpretation,
identify conflicting signals, and finish with a concise risk summary.All financial research tools require a valid API key. See authentication for key handling and rotation.
Connect: local stdio
For clients that require a local process:
pip install -U hpsilab-quant-finance-mcpThis example uses the mcpServers schema supported by Claude and Cursor; VS Code and GitHub Copilot use a servers schema instead.
{
"mcpServers": {
"hpsilab": {
"command": "hpsilab-quant-finance-mcp",
"env": {
"HPSILAB_API_KEY": "hpsi_your_key"
}
}
}
}Then verify it through the MCP client:
Use HPSILab to get the AI prediction for NVDA and summarize the model consensus.Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
HPSILab Quant Finance: common questions
- Is HPSILab Quant Finance MCP server safe?
- Yes, by our scan: it is graded A (91/100). Read the HPSILab Quant Finance safety report
- How do I install HPSILab Quant Finance?
- It runs remotely at hpsilab.com. Add it to Claude Code, Cursor, VS Code or Claude Desktop with the snippets above, or call it through the mcp.market gateway without installing anything.
- Does HPSILab Quant Finance need an API key?
- Yes. The registry entry asks for
HPSILAB_API_KEY,Authorization. - Is HPSILab Quant Finance maintained?
- The last commit was 11 days ago (2026-10-25). The latest release is v0.11.1.
- Is HPSILab Quant Finance up?
- 96% of our last 28 checks got an answer. We check remote servers about four times a day.
- What can I use instead of HPSILab Quant Finance?
- Servers from other publishers that do the same job: Yahoo Finance MCP server, Tapetide - Indian Stock Market MCP server and AlgoVault — Crypto Quant Trade Calls MCP server. Compare all HPSILab Quant Finance alternatives.
- How does HPSILab Quant Finance compare with other Finance MCP servers?
- safety score 91/100 (higher than 93% of 1,759 Finance servers); tools 10 (the typical Finance server has 8); tools that change things 0% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.
Alternatives to HPSILab Quant Finance
Same job from other publishers: the closest match first, then the best rated.
- Yahoo FinanceAccess Yahoo Finance stock data, news, screeners, options, financials, and charts through MCP.not reviewedEstablishedA
- Tapetide - Indian Stock Market MCP48 tools for ~8,000 NSE & BSE stocks: quotes, screener, financials, filings, FII/DII, optionsnot reviewedEstablishedA
AlgoVault — Crypto Quant Trade CallsThe Brain Layer for AI Trading Agents — quant calls + cross-venue arb across perp venues via MCP.not reviewedEstablishedA- MoneyMatterPersonal finance tracker: accounts, transactions, budgets, investments and analytics over OAuth.not reviewedGrowingA
- Yahoo FinanceReal-time Yahoo Finance data: quotes, history, financials, analyst ratings, options, and news.not reviewedGrowingA