hpsilab-mcp 0.5.0

Python SDK for H|psi Quantum Finance APIs.

HPSI Python REST SDK

The hpsilab-mcp Python package currently wraps the hosted hpsilab.com REST API.

The Python SDK currently wraps hosted REST endpoints for the official tool catalog.

Installation

pip install hpsilab-mcp

Quick Start

from hpsilab_mcp import HpsiMcpClient

client = HpsiMcpClient()

calls = {
    "analyze_stock": client.analyze_stock("NVDA"),
    "get_ai_prediction": client.get_ai_prediction("NVDA"),
    "get_iv_radar": client.get_iv_radar("NVDA"),
    "get_option_pressure": client.get_option_pressure("NVDA"),
    "get_pretrade_risk_scan": client.get_pretrade_risk_scan("NVDA"),
    "get_monte_carlo": client.get_monte_carlo("NVDA"),
    "get_equity_curves": client.get_equity_curves("NVDA"),
    "generate_stock_images": client.generate_stock_images("NVDA"),
    "generate_stock_research_report": client.generate_stock_research_report("NVDA"),
}

print(calls["analyze_stock"])

All listed REST SDK methods are callable without an API key. The SDK does not block any method client-side.

Version

import hpsilab_mcp

print(hpsilab_mcp.__version__)

Optional Authenticated Usage

from hpsilab_mcp import HpsiMcpClient

client = HpsiMcpClient(
    api_key="YOUR_API_KEY",
    base_url="https://hpsilab.com",
)

result = client.get_ai_prediction("TSLA")

print(result)

REST SDK Methods

client.get_ai_prediction("NVDA")
client.analyze_stock("NVDA")
client.get_iv_radar("NVDA")
client.get_option_pressure("NVDA")
client.get_pretrade_risk_scan("NVDA")
client.get_monte_carlo("NVDA")
client.get_equity_curve("NVDA")
client.get_equity_curves("NVDA")
client.generate_stock_images("NVDA")
client.generate_stock_research_report("NVDA")

Endpoint mapping:

Method	Endpoint
analyze_stock(symbol)	GET /api/analyze_stock/{symbol}
get_ai_prediction(symbol)	GET /api/ai_prediction/{symbol}
get_iv_radar(symbol)	GET /api/iv_batch?symbols={symbol}
get_option_pressure(symbol)	GET /api/option_pressure/{symbol}
get_pretrade_risk_scan(symbol)	GET /api/pretrade-risk-scan?symbol={symbol}
get_monte_carlo(symbol)	GET /api/monte_carlo/{symbol}
get_equity_curve(symbol)	GET /api/equity_curve/{symbol}
get_equity_curves(symbol)	GET /api/equity_curve/{symbol}
generate_stock_images(symbol)	POST /api/stock_report/{symbol}/images
generate_stock_research_report(symbol)	POST /api/stock_report/{symbol}/research_report

Capability Matrix

Capability	REST API	MCP
analyze_stock	Yes	Yes
get_ai_prediction	Yes	Yes
get_iv_radar	Yes	Yes
get_option_pressure	Yes	Yes
get_pretrade_risk_scan	Yes	Yes
get_monte_carlo	Yes	Yes
get_equity_curve	Yes	No
get_equity_curves	Yes	Yes
generate_stock_images	Yes	Yes
generate_stock_research_report	Yes	Yes

MCP Transport

All official MCP tools now have REST SDK coverage. Use an MCP-compatible client when you specifically need MCP transport, tool discovery, or assistant-native tool calls.

Scope

This package is a REST API wrapper. It does not implement MCP transport, SSE, streaming, tool discovery, Claude integration, or proprietary finance logic.

These tools return research-oriented information. They are not financial advice.

License

MIT. See LICENSE.