Prototyp · Vorschau: alle Server aus der offiziellen Registry, alle 30 Minuten synchronisiert. Mit Google anmelden, um Bewertungen zu schreiben.Prototyp · alle 30 Min. aktualisiert
PopNx MCPMCP-Server für alle, die KI nutzen · in einfachen Worten erklärt

HPSILab Quant Finance

von haiyunskyVersion 0.11.1i★ 1iComputer oder CloudOffizielle Website ↗
Name in der Registryio.github.haiyunsky/hpsilab-quant-finance-mcp

So installierst du es

What it does

Stock & options risk analytics for AI agents: pre-trade risk scan, IV, gamma walls, Monte Carlo.

  • Connects Computer oder Cloud
  • Account or key Cloud: Works without a key · add Authorization if you have one (often raises limits) · Local: Needs HPSILAB_API_KEY
  • Category Buchhaltung, Finanzen & Steuern

Warum es hier steht

Listen sind nach einem Nutzungswert (von 100) aus diesen Teilen sortiert

Beliebtheit4/80GitHub-Sterne oder wöchentliche Downloads: der größere Wert zählt 60, der kleinere 20
Aktualität12/12Volle Punkte für Release oder Codeänderung in 30 Tagen
Antwortet noch8/8Der Cloud-Endpoint antwortete bei der letzten Prüfung
Nutzungswert24/100

Qualität: 5/5 Basisprüfungen bestanden (angezeigt, nicht zur Sortierung) · Schwung: Noch keine Daten (Nur im Tab Im Trend verwendet)

Installation

Wähle die KI-App, die du nutzt, und kopiere die Einstellungen.

Mit einem Satz von deiner KI installieren lassen

Installiere bitte HPSILab Quant Finance. Folge https://mcp.popnx.com/i/haiyunsky-hpsilab-quant-finance-mcp.md, zeig mir die Befehle und warte auf mein OK, bevor du sie ausführst.

Füge ihn in eine KI ein, die auf deinem Rechner arbeitet (z. B. Claude Code oder Cursor). Sie liest unsere Schritte, zeigt dir die Befehle und wartet auf dein OK. Kein Schlüssel, keine Anmeldung. · Vollständigen Text ansehen

5/5 Prüfungen bestanden · Was du fragst, läuft über den Server des Anbieters (hpsilab.com) · ✓ Befehle geprüft am 13. Nov. 2026

Zuerst: Welche KI nutzt du?

Wähle deine App, dann erscheinen die Schritte unten.

Klappt mit Claude · etwa 2 Min.

Kein Schlüssel, nichts zu installieren · Einmal auf claude.ai oder in der Desktop-App einrichten, dann im Chat nutzen · kostenlose Konten können 1 hinzufügen · bei Team/Enterprise fügt ein Owner ihn hinzu

  1. Öffne die Connectors-Seite von Claude

    CustomizeConnectors

    CustomizeConnectors1Add2https://…3Add4
  2. Klicke „Add“ → „Custom“ → „Web“ und fülle diese 2 Felder aus

    Kopiere jeden Wert in das gleichnamige Feld in Claude und klicke Continue

    Name · NameHPSILab Quant Finance
    Remote MCP server URL · Adressehttps://hpsilab.com/mcp

    Klicke auf der von Claude erkannten Anmelde-Seite auf Continue · wähle bei Authentication, was der Anbieter angibt (Sign in now, Sign in when needed oder No sign in), dann Add

  3. Im Chat einschalten

    +ConnectorsHPSILab Quant Finance

  4. Ausprobieren

    Nutze HPSILab Quant Finance und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Claude sagt, dass es HPSILab Quant Finance nutzt, oder ein Werkzeug von HPSILab Quant Finance in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit ChatGPT je nach Tarif

Volles MCP: ChatGPT Business, Enterprise oder Edu im Web · Pro: verbindet mit Lese-/Abrufrechten, Werkzeuge, die Daten ändern, gehen evtl. nicht · Plus: in der Doku nicht bestätigt; siehst du auf der Plugins-Seite eine Option für eigene MCP-Server, kannst du es versuchen · nur Web

  1. In ChatGPT im Web die Seite zum Hinzufügen von MCP öffnen

    Plugins+Add custom MCP server

    ChatGPTPlugins1+2https://…3Create4
  2. Name und Adresse eintragen

    Namen eingeben, Adresse unter Connection einfügen, Risikohinweis abhaken und Create as a plugin klicken

    Name · NameHPSILab Quant Finance
    Connection · Adressehttps://hpsilab.com/mcp
  3. HPSILab Quant Finance im Chat auswählen

    Neuen Chat öffnen und vor dem Tippen HPSILab Quant Finance aus deinen Plugins wählen

  4. Ausprobieren

    Nutze HPSILab Quant Finance und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn ChatGPT sagt, dass es HPSILab Quant Finance nutzt, oder ein Werkzeug von HPSILab Quant Finance in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von OpenAI abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit Claude Code · etwa 2 Min.

Kein Schlüssel, nichts zu installieren

  1. Terminal öffnen

    Mac: Command+Leertaste drücken und Terminal tippen · Windows: PowerShell öffnen

  2. Diesen Befehl einfügen und Enter drücken

    claude mcp add --transport http --scope user hpsilab-quant-finance https://hpsilab.com/mcp
  3. /mcp in Claude Code eingeben

    HPSILab Quant Finance sollte in der Liste als verbunden erscheinen

  4. Ausprobieren

    Nutze HPSILab Quant Finance und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Claude Code sagt, dass es HPSILab Quant Finance nutzt, oder ein Werkzeug von HPSILab Quant Finance in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit Cursor · etwa 2 Min.

Kein Schlüssel, nichts zu installieren

  1. Mit diesem Button Cursor öffnen

    In Cursor öffnen

    Cursor fragt nach einer Bestätigung; klicke Install

  2. KI-Chat in Cursor im Agent-Modus öffnen

  3. Ausprobieren

    Nutze HPSILab Quant Finance und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Cursor sagt, dass es HPSILab Quant Finance nutzt, oder ein Werkzeug von HPSILab Quant Finance in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Cursor abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit VS Code · etwa 2 Min.

Kein Schlüssel, nichts zu installieren

  1. Mit diesem Button VS Code öffnen

    In VS Code öffnen

    VS Code fragt nach einer Bestätigung; klicke Install

  2. KI-Chat in VS Code im Agent-Modus öffnen

  3. Ausprobieren

    Nutze HPSILab Quant Finance und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn VS Code sagt, dass es HPSILab Quant Finance nutzt, oder ein Werkzeug von HPSILab Quant Finance in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von VS Code abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Andere Apps mit MCP, etwa Windsurf, Zed oder Gemini CLI, fügen Server unterschiedlich hinzu. Sieh in der App-Liste nach

Alle Apps mit MCP ansehen →

Adresse für Apps, die über das Web verbinden

Adressehttps://hpsilab.com/mcp

JSON-Einstellungen stehen unten unter „Für Entwickler“

Hängst du fest? Frag Leute, die HPSILab Quant Finance nutzen💬 Diskussion →
Für Entwickler: Terminal-Befehle und JSON-Einstellungen

Über das Web

Claude Code

claude mcp add --transport http --scope user hpsilab-quant-finance https://hpsilab.com/mcp

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "hpsilab-quant-finance": {
      "url": "https://hpsilab.com/mcp"
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "hpsilab-quant-finance": {
      "type": "http",
      "url": "https://hpsilab.com/mcp"
    }
  }
}

Auf deinem Computer installiert

Claude Code

claude mcp add --scope user hpsilab-quant-finance --env HPSILAB_API_KEY=your-value -- uvx hpsilab-quant-finance-mcp

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "hpsilab-quant-finance": {
      "command": "uvx",
      "args": [
        "hpsilab-quant-finance-mcp"
      ],
      "env": {
        "HPSILAB_API_KEY": "your-value"
      }
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "hpsilab-quant-finance": {
      "command": "uvx",
      "args": [
        "hpsilab-quant-finance-mcp"
      ],
      "env": {
        "HPSILAB_API_KEY": "your-value"
      }
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "hpsilab-quant-finance": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "hpsilab-quant-finance-mcp"
      ],
      "env": {
        "HPSILAB_API_KEY": "your-value"
      }
    }
  }
}

Werte, die du selbst einträgst

  • HPSILAB_API_KEY geheim erforderlich env
    HPSILab-API-Schlüssel, der in den HPSILab-Einstellungen erzeugt und verwaltet wird.
    Englisches Original anzeigenHPSILab API key generated and managed in HPSILab Settings.
  • Authorization geheim HTTP header
    Optional. Clients mit MCP-OAuth können dies weglassen und sich bei HPSILab anmelden; andernfalls einen Bearer-API-Schlüssel aus den HPSILab-Einstellungen senden. Forschungstools benötigen eine der beiden Optionen.
    Englisches Original anzeigenOptional. Clients that support MCP OAuth can omit it and sign in to HPSILab instead; otherwise send a Bearer API key from HPSILab Settings. Research tools need one of the two.

Beschreibungen automatisch übersetzt; Variablennamen bleiben wie im Original. Im Zweifel das Original ansehen.

Diese Einstellungen werden aus dem Registry-Eintrag des Entwicklers erzeugt. Wenn in der README etwas anderes steht, folge der README.

Auf einen Blick

Downloads pro Wochei
76/Wo.
Verbindung
Computer oder Cloud
Transport
stdio, streamable-http
Neueste Versioni
0.11.1
In der Registry veröffentlichti
24. Okt. 2026
Code zuletzt geänderti
13. Nov. 2026
Zuletzt geprüft
18. Nov. 2026
Entwickler
haiyunsky
Pakete
pypi: hpsilab-quant-finance-mcp
Registry-Status
Aktiv

Welche Apps ihn nutzen können

Basierend darauf, wie sich dieser Server verbindet, und auf der eigenen Doku jeder App, geprüft am 10. Nov. 2026.

Verbinden sich über das Internet in

ClaudeChatGPTGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast

Laufen auf deinem Computer in

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

Alle Apps, mit Vor- und Nachteilen →

Was er kann

Tool-Namen und -Beschreibungen genau so, wie der Server sie am 18. Nov. 2026 gemeldet hat. Geschrieben hat sie der Entwickler, nicht wir; wir zeigen sie als reinen Text.

  • register_account

    Register 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 t

  • get_iv_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. Returns spot price, the expiry used, the option quote time (l

  • get_monte_carlo

    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. Returns the price-history date and starting close, mean and median projected close, the 90% range, daily volatility, support

  • get_ai_prediction

    AI 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). Returns the model input date and close next to the latest fetched daily bar, the blended UP probab

  • get_equity_curve

    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:

  • get_option_pressure

    Option-chain pressure map for the nearest weekly/monthly expiry — Max Pain, dealer Gamma Wall, likely weekly high, and an extreme squeeze target. Returns spot, the expiry and days to it, the option quote time (latest trade in the chain, UTC), max pain, gamma/call/put walls, likel

  • analyze_stock

    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. `tool_responses` carries each source's full text (AI p

  • get_pretrade_risk_scan

    Full pre-trade risk scan JSON for a stock. Pro tool ($0.15/call via x402 for anonymous callers; Credits for signed-in accounts). `riskDeltas` compares the SPY benchmark (`beforeValue`) with this stock on its own (`afterValue`). Neither side is a portfolio, so it is not a before/a

  • generate_stock_images

    Generate stock-report PNG images and return their URLs, with the charts attached as PNG image content so the assistant can see them. The JSON (symbol, status, images with url/status, disclaimer) is the same with or without attachments; the image blocks are added after it. Args: s

  • generate_stock_research_report

    Full markdown research report with its most relevant stock-report charts attached as images. 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 generati

Basischecksi

Wir prüfen Informationen, die jeder sehen kann; den Code haben wir nicht gelesen. Checks, die nicht zutreffen, werden nicht mitgezählt. · Geprüft am 19. Nov. 2026

  • ✓ Bestanden

    Entwickler passt zum Repo

    Der Registry-Name wurde mit dem GitHub-Konto haiyunsky bestätigt, dem das Repo gehört

  • ✓ Bestanden

    Wird noch gepflegt

    Code zuletzt geändert: vor 6 Tagen

  • ✓ Bestanden

    Hat eine Lizenz

    Nutzt MIT

  • ✓ Bestanden

    Endpunkt antwortet

    Antwort in 538 ms (HTTP 200)

  • – Nicht zutreffend

    Anmeldung mit OAuth

    Keine Anmeldung nötig

  • ✓ Bestanden

    Keine versteckten Anweisungen in Tool-Beschreibungen

    Wir haben 10 Tool-Beschreibungen gelesen und keine versteckten Anweisungen an die KI gefunden

Veröffentlichte Schwachstellen (OSV.dev)

Keine Einträge auf OSV.dev für hpsilab-quant-finance-mcp@0.11.1

Prüft nur diese Paketversion, nicht alle Abhängigkeiten · geprüft 15. Nov. 2026

Was wir prüfen → · JSON

Entwickler: neue Prüfung anfordern oder falsche Angaben melden
Für Anbieter: Badge ins README

Wenn du das gebaut hast, füge diesen Code in dein README ein. Das Badge verlinkt auf diese Seite.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/haiyunsky-hpsilab-quant-finance-mcp.svg)](https://mcp.popnx.com/en/servers/haiyunsky-hpsilab-quant-finance-mcp)

Diskussion

Fragen, Tipps teilen oder melden, dass etwas nicht geht. Sortiert nach „hilfreich“.

Noch keine Beiträge. Stell die erste Frage oder teile einen Tipp.

Beiträge hier stammen von Nutzern, nicht vom PopNx-Team.

Anmelden, um zu posten

Nutzerbewertungen

Noch keine Bewertungen

Anmelden, um eine Bewertung zu schreiben

Im Vergleich mit anderen in Buchhaltung, Finanzen & Steuerni

  • Mehr Sterne als 87 % der anderen 3440 Server in dieser Kategorie
  • Neuer in der Registry veröffentlicht als 53 % der anderen 3440 Server in dieser Kategorie
  • Basischecks gleich gut wie oder besser als bei 99 % der anderen 3440 Server in dieser Kategorie

Verglichen mit allen aktiven Servern dieser Kategorie in der Registry. Sterne zählen nur, wenn dem Herausgeber das Repo gehört.

Häufige Fragen

Ist HPSILab Quant Finance sicher?

Er hat 5 von 5 zutreffenden Basischecks bestanden. Den Code haben wir nicht gelesen. Bevor du einen Schlüssel oder Token hinzufügst, sieh nach, welche Zugriffe der Server verlangt, und nutze einen Schlüssel, der nur die Berechtigungen hat, die du brauchst.

Welche Schlüssel oder Codes braucht er?

Das musst du eintragen: HPSILAB_API_KEY

Läuft er auf meinem Computer oder in der Cloud?

Beides geht: Installiere ihn auf deinem Computer oder verbinde dich mit der Cloud-Version.

Wird er noch gepflegt?

Das GitHub-Repo wurde zuletzt vor 6 Tagen geändert, und die neueste Version (0.11.1) kam vor 26 Tagen in die Registry.

Welche Apps können ihn nutzen?

Apps, die MCP unterstützen, etwa Claude Desktop, Claude Code, Cursor und VS Code. Er verbindet sich per URL und funktioniert daher auch in Apps mit Remote-MCP, etwa ChatGPT im Web (volles MCP ab Business; Pro nur lesend).

Was kann ich stattdessen nutzen?

In derselben Kategorie: SolidInvoice, Signal8, Journalit, Beancount.io, Tapetide - Indian Stock Market MCP

Ähnliche Alternativen

Gleiche Kategorie, andere Entwickler, Befehle bereits geprüft. Offizielle zuerst, dann nach Sternen.

So liest du eine Karte:↓ Downloads pro Wochei★ GitHub-SterneiDrei Säulen: Bewertungen · Checks · NutzungiAktualisiert = neueste Version in der Registry veröffentlichti

SolidInvoice

Create and send invoices and quotes, manage clients, and track payments in SolidInvoice.

von SolidInvoiceWachsend★ 991Aktualisiert vor 10 Tagen

Läuft in der Cloud✓ vom Dienst · solidinvoice.co

Signal8

SEC filings, dilution, insider & institutional ownership, and political-trade data for AI agents.

von signal8aiWachsend↓ 431/Wo.★ 425Aktualisiert vor 10 Tagen

Computer oder Cloud✓ vom Dienst · signal8.ai

Journalit

Trading journal in Obsidian. Ask Claude or ChatGPT about your trades; edits are previewed first.

von CursivezWachsend★ 261Aktualisiert vor 11 Tagen

Läuft in der Cloud✓ vom Dienst · journalit.co

Beancount.io

Query, edit, and reconcile a hosted Beancount ledger: BQL, reports, files, and bank imports.

von bex-coWachsend★ 702 Sterne des ganzen ReposAktualisiert vor 44 Tagen

Läuft in der Cloud✓ vom Dienst · beancount.io
Im Vergleich mit ähnlichen
Dieser
HPSILab Quant Finance
SolidInvoiceSignal8JournalitBeancount.ioTapetide - Indian Stock Market MCP
Läuft woIn der Cloud oder auf deinem RechnerLäuft in der Cloud, keine InstallationIn der Cloud oder auf deinem RechnerLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine InstallationIn der Cloud oder auf deinem Rechner
Braucht SchlüsselJaNeinJaNeinNeinJa
Mit + in Claude hinzufügenNeinNeinNeinNeinNeinNein
Basisprüfungen5/54/65/54/44/45/5
LizenzMITMITMITNOASSERTIONMITMIT
PreisKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im Register

README vom Entwickler

README öffnen

Unverändert aus dem Repo des Entwicklers übernommen. PopNx MCP hat den Inhalt weder geprüft noch empfiehlt es ihn. HTML, Bilder und Skripte wurden entfernt. Links führen von dieser Website weg.

HPSILab Quant Finance MCP Server for Stock & Options Analytics

Stock and options risk analytics for AI agents. Connect one remote MCP endpoint, https://hpsilab.com/mcp, sign in with OAuth (no API key to paste), and your agent can call:

  • a pre-trade risk scan: volatility, beta, drawdown and VaR against SPY with fixed pass/warn/fail limits, plus sizing, sector exposure and correlation checks;
  • options structure: IV level, rank and skew, gamma wall, call/put walls, max pain;
  • a 10-trading-day Monte Carlo price range and odds of finishing higher;
  • analyze_stock for a one-call overview, plus AI prediction and backtests.

Results are structured JSON with machine-readable errors, for US-listed equities, ETFs and supported options. This repository is the open-source Python server (MIT); the hosted endpoint runs the same tool surface.

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

Registry nameio.github.haiyunsky/hpsilab-quant-finance-mcp
Version0.11.1 — a source checkout reports 0.11.1+source
TransportsStreamable HTTP (hosted) · stdio (PyPI package)
Remote endpointhttps://hpsilab.com/mcp
Packagepip install -U hpsilab-quant-finance-mcp
AuthenticationOAuth sign-in or Bearer API key (hosted), HPSILAB_API_KEY (stdio)
Tools10 — nine financial research tools plus register_account

Connect: hosted Streamable HTTP

Recommended, and requires no local installation.

With OAuth sign-in

Clients that support MCP OAuth (Claude Code, Claude.ai and ChatGPT connectors, and others) only need the URL; they open the HPSILab sign-in page on first use.

claude mcp add --transport http hpsilab https://hpsilab.com/mcp

In a connector UI, add a custom connector with the URL https://hpsilab.com/mcp.

With an API key

For clients without OAuth support, or for scripts:

  1. Register a free account, sign in, and generate an API key from Settings.
  2. Add the server to your client's private configuration, replacing hpsi_your_key. Never commit a real key or paste one into chat.

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" } } } }

  1. 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 signed-in account: OAuth or a valid API key. See authentication for key handling and rotation.

Building an agent? examples/agents has one-file risk-check agents for the OpenAI Agents SDK, the Claude Agent SDK and LangGraph. Walkthrough: docs/guide-risk-gate-for-trading-agents.md.

Connect: local stdio

For clients that require a local process:

pip install -U hpsilab-quant-finance-mcp

This 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.

The client discovers tools with MCP tools/list and invokes them with tools/call. See local setup and Python usage, which also covers calling the tool functions directly from Python.

Tools

Nine financial research tools, plus register_account. Tool names and parameter meanings are part of the public compatibility contract.

ToolWhat it returnsBehavior
analyze_stockAggregate directional and quantitative stock analysisRead-only
get_ai_predictionNext-session prediction, confidence, and model consensusRead-only
get_iv_radarIV level, rank, percentile, skew, and regimeRead-only
get_option_pressureMax pain, gamma walls, expected move, and pressure zonesRead-only
get_monte_carlo10-trading-day simulated distribution and probabilitiesRead-only
get_equity_curveStrategy backtests and risk-adjusted performanceRead-only
get_pretrade_risk_scanPosition, exposure, correlation, and risk checksRead-only
generate_stock_imagesHosted stock and options chart artifactsCreates an artifact; not idempotent
generate_stock_research_reportStructured Markdown research report and timestampCreates an artifact; not idempotent
register_accountSigning up from the client with no API key yet, or a fresh key for an existing accountCreates an account and sends email; not idempotent

Research tools accept one exchange ticker such as NVDA, SPY, or BRK.B; company names are not accepted. Live results can change between calls. Artifact tools can consume quota and should not be retried automatically.

Full inputs, outputs, side effects, and tool-selection guidance are in docs/tools.md.

Monte Carlo research example

Example visualization of scenario-based Monte Carlo research output. Results depend on the selected inputs and model assumptions. See get_monte_carlo for tool details.

Copy-ready prompts

Claude
Use HPSILab to analyze NVDA. Summarize the directional signal, AI model

consensus, IV regime, options pressure, 10-day Monte Carlo range, and the three most important risks. Distinguish tool data from interpretation.

Cursor
Use HPSILab's IV radar and option-pressure tools for SPY. Compare IV rank,

percentile, skew, expected move, max pain, gamma wall, and pressure zones. Return a compact table and do not recommend a trade.

ChatGPT
Run the HPSILab pre-trade risk scan for TSLA. Explain every warning or failed

check, preserve unavailable fields as unavailable, and quote the returned reason instead of guessing. Do not execute or recommend a trade.

Setup guidance covers ChatGPT, Claude, Cursor, VS Code, GitHub Copilot, Continue, and Kimi. See the client setup guide for each client's transport and configuration format.

Errors, retries, and limits

Every failure is a structured object with a stable error_code, never prose an agent has to pattern-match. Five refusals matter, because each has a different remedy:

error_codeMeaningWhat resolves it
api_key_requiredNo key is configuredRegistering. Nothing is sent downstream
rate_limitedCalling too fast (429)Waiting — next_actions carries the seconds
insufficient_creditsThe Credit balance is empty (402)Adding Credits, or registering for trial Credits
allowance_exhaustedThe free evaluation ceiling is spent (402)Registering, or verifying an email. Money does not lift it
settlement_unknownA payment whose outcome is unconfirmedReconciliation. Do not retry it and do not pay again

Without a key the package stops locally, before constructing the downstream client or sending a request:

{

"error": "api_key_required", "message": "A free API key is required.", "register_url": "https://hpsilab.com/register", "docs_url": "https://hpsilab.com/developer/v2" }

401 and 402 responses are never retried. A 429 is retried only when it carries a valid Retry-After. Read-only calls use a finite retry budget for timeouts and recoverable 500/502/503/504 responses; artifact-producing calls are not retried automatically. The package also applies one process-local safeguard of 10 requests per rolling minute per API key — burst protection, not a quota, since only the hosted service knows the balance and the plan.

Field-by-field payloads, the Credits circuit breaker, and the reasoning behind each remedy are in docs/authentication.md and docs/python-sdk.md.

Why HPSILab

HPSILab gives assistants typed inputs, structured outputs, ticker validation, machine-readable errors, and dedicated tools instead of invented metrics. It supports US-listed equities, ETFs, and supported options data; coverage and limits depend on the hosted service and plan.

Safety and license

HPSILab is for research and education only. Outputs may be incomplete, delayed, or wrong and are not investment, financial, or trading advice. The MCP server has no brokerage connectivity, order entry, or trade-execution capability.

Licensed under the MIT License. Contributions are welcome; read AGENTS.md and CONTRIBUTING.md before proposing public schema changes.