H
haiyunsky/hpsilab-quant-finance-mcp
Stock and options risk analytics for AI agents.
★ 1·updated 2026-11-12
View on GitHub ↗Direct link · no redirect page
Install & config
Remote endpoint (mcpServers - Claude Desktop / Cursor / Windsurf)
{
"mcpServers": {
"haiyunsky-hpsilab-quant-finance-mcp": {
"url": "https://hpsilab.com/mcp"
}
}
}Paste this into the mcpServers config of Claude Desktop or Cursor. The endpoint comes from public evidence; we do not install or host it. Official Registry record: this endpoint declares a required request header Authorization (Bearer API key generated and managed in HPSILab Settings. All financial research tools require a valid API key.). Using it means bringing your own credentials.
VS Code (.vscode/mcp.json - the key is servers, remote needs type: http)
{
"servers": {
"haiyunsky-hpsilab-quant-finance-mcp": {
"type": "http",
"url": "https://hpsilab.com/mcp"
}
}
}VS Code differs from the other three: the top-level key is <code>servers</code> and a remote endpoint also needs <code>"type": "http"</code>. Paste into .vscode/mcp.json.
Claude Code (command line)
claude mcp add --transport http haiyunsky-hpsilab-quant-finance-mcp https://hpsilab.com/mcp
Claude Code does not read a config file; add the server with this command.
Config file: macOS
~/Library/Application Support/Claude/claude_desktop_config.json, Windows %APPDATA%\Claude\claude_desktop_config.json, Linux ~/.config/Claude/claude_desktop_config.json. Key names differ by client: Clients & CLI- Star count
- 1 ★ · haiyunsky/hpsilab-quant-finance-mcp · read from the GitHub search API · (checked 2026-11-19 20:00:48)
- Source
- collected from the punkpeye/awesome-mcp-servers list · type: MCP server
- Harvest history
- first seen 2026-11-18 · last seen 2026-11-20 · seen 3× · listed by 3 sources
- Score
- score 300 · 1 ★ · 3 sources · mcp
FAQ (answers come from our records)
How do I install it?
We did not find an install command for this repository (our install coverage is only about 4%). Check its README or releases page.
Who is it for?
We filed it under these tags: MCP servers. The tags come from the entry itself, not a taxonomy we imposed.
Who maintains it?
repository
haiyunsky/hpsilab-quant-finance-mcp;first catalogued 2026-11-18;last seen 2026-11-20。There is no official certification or quality rating here — we record sources and dates only.README excerpt (English, untranslated) · Read the full README on GitHub →
# HPSILab Quant Finance MCP Server for Stock & Options Analytics
Excerpted from the repository README (abridged)
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 name | io.github.haiyunsky/hpsilab-quant-finance-mcp |
| Version | 0.11.1 — a source checkout reports 0.11.1+source |
| Transports | Streamable HTTP (hosted) · stdio (PyPI package) |
| Remote endpoint | https://hpsilab.com/mcp |
| Package | pip install -U hpsilab-quant-finance-mcp |
| Authentication | OAuth sign-in or Bearer API key (hosted), HPSILAB_API_KEY (stdio) |
| Tools | 10 — 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.
bash
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.
json
"mcpServers": {
"hpsilab": {
"type": "http",
"url": "https://hpsilab.com/mcp",
"headers": {
"Authorization": "Bearer hpsi_your_key"
3. Verify the connection:
text
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:
bash
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.
json
"mcpServers": {
"hpsilab": {
"command": "hpsilab-quant-finance-mcp",
"env": {
"HPSILAB_API_KEY": "hpsi_your_key"
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 name | io.github.haiyunsky/hpsilab-quant-finance-mcp |
| Version | 0.11.1 — a source checkout reports 0.11.1+source |
| Transports | Streamable HTTP (hosted) · stdio (PyPI package) |
| Remote endpoint | https://hpsilab.com/mcp |
| Package | pip install -U hpsilab-quant-finance-mcp |
| Authentication | OAuth sign-in or Bearer API key (hosted), HPSILAB_API_KEY (stdio) |
| Tools | 10 — 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.
bash
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.
json
"mcpServers": {
"hpsilab": {
"type": "http",
"url": "https://hpsilab.com/mcp",
"headers": {
"Authorization": "Bearer hpsi_your_key"
3. Verify the connection:
text
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:
bash
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.
json
"mcpServers": {
"hpsilab": {
"command": "hpsilab-quant-finance-mcp",
"env": {
"HPSILAB_API_KEY": "hpsi_your_key"
Listed badge (optional)
Copy this line into the README if you want the listing mark. Optional, and it does not affect being listed.
[](https://anclum.com/en/s/haiyunsky-hpsilab-quant-finance-mcp/)
- Source
- awesome · https://github.com/haiyunsky/hpsilab-quant-finance-mcp
- Browse by field
- MCP servers
- Traction
- 1 ★
- Listed by
- 3 independent sources
- added
- today
More MCP servers
Filed under
Every tag opens the full list for that filter. Counts are the live catalogue figures.