# HPSILab Quant Finance MCP server

Quant finance tools: stock analysis, options IV, Monte Carlo, AI prediction, risk scan, backtests.

## Links
- Registry page: https://www.getdrio.com/mcp/io-github-haiyunsky-hpsilab-quant-finance-mcp
- Repository: https://github.com/haiyunsky/hpsilab-quant-finance-mcp
- Website: https://hpsilab.com

## Install
- Command: `uvx hpsilab-quant-finance-mcp`
- Endpoint: https://hpsilab.com/mcp
- Auth: Auth required by registry metadata

## Setup notes
- Remote header: Authorization (required; secret)
- Package: Pypi hpsilab-quant-finance-mcp v0.8.2
- Environment variable: HPSILAB_API_KEY (required; secret)
- The upstream registry signals required auth or secrets.
- Remote endpoint: https://hpsilab.com/mcp
- Header: Authorization

## Tools
- register_account (Register a Free Account) - Register a free hpsilab account for yourself, with no human involvement,
    and receive an API key immediately.

    Call this when you are hitting anonymous daily limits and want a higher
    allowance. 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.

    Registering keeps the anonymous daily allowance until the email address is
    confirmed; confirming it unlocks the full Free plan. Ask the human you are
    working with to click the link in the email that will arrive.

    Args:
        email: A real email address to own the account. Use the human's
            address if you have it - the verification link goes there, and an
            address nobody reads leaves the account stuck at the anonymous
            allowance forever.
     Endpoint: https://hpsilab.com/mcp
- get_iv_radar (Implied Volatility Radar) - Implied-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.
     Endpoint: https://hpsilab.com/mcp
- get_monte_carlo (Monte Carlo Simulation) - Monte 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".
     Endpoint: https://hpsilab.com/mcp
- get_ai_prediction (AI Prediction) - AI next-day prediction: probability the stock closes UP, a plain
    buy/watch/sell-lean signal, 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".
     Endpoint: https://hpsilab.com/mcp
- get_equity_curve (Strategy Backtest) - Backtest 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.
     Endpoint: https://hpsilab.com/mcp
- get_option_pressure (Options Pressure Map) - Option-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".
     Endpoint: https://hpsilab.com/mcp
- analyze_stock (Stock Analysis) - Aggregate 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.
     Endpoint: https://hpsilab.com/mcp
- get_pretrade_risk_scan (Pre-Trade Risk Scan) - Full pre-trade risk scan JSON for a stock. Pro tool ($0.15/call via x402
    for anonymous callers; free within plan limits for signed-in accounts).

    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. "NVDA".
     Endpoint: https://hpsilab.com/mcp
- generate_stock_images (Stock Chart Generator) - Generate 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.
     Endpoint: https://hpsilab.com/mcp
- generate_stock_research_report (Stock Research Report) - Full 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.
     Endpoint: https://hpsilab.com/mcp

## Resources
Not captured

## Prompts
Not captured

## Metadata
- Owner: io.github.haiyunsky
- Version: 0.8.2
- Runtime: Pypi
- Transports: STDIO, HTTP
- License: Not captured
- Language: Not captured
- Stars: Not captured
- Updated: Aug 4, 2026
- Source: https://registry.modelcontextprotocol.io