SolidInvoice
Create and send invoices and quotes, manage clients, and track payments in SolidInvoice.
ยังไม่มีคำอธิบายภาษาไทย ดูข้อเท็จจริงด้านล่าง หรือเปิดคำอธิบายต้นฉบับจากผู้ทำ
Stock & options risk analytics for AI agents: pre-trade risk scan, IV, gamma walls, Monte Carlo.หน้ารายการเรียงด้วยคะแนนการใช้งาน (เต็ม 100) จากส่วนเหล่านี้
| ความนิยม | 4/80 | ดาว GitHub หรือยอดดาวน์โหลดต่อสัปดาห์ ค่ามากนับ 60 ค่าน้อยนับ 20 |
|---|---|---|
| ความสด | 12/12 | ออกรุ่นหรือแก้โค้ดใน 30 วัน ได้เต็ม |
| ระบบยังตอบ | 8/8 | endpoint บนคลาวด์ตอบตอนตรวจล่าสุด |
| คะแนนการใช้งาน | 24/100 |
คุณภาพ: ผลตรวจเบื้องต้นผ่าน 5/5 ข้อ (แสดงให้ดู ไม่ได้ใช้เรียง) · ความมาแรง: ยังไม่มีข้อมูล (ใช้เรียงเฉพาะแท็บมาแรง)
เลือกโปรแกรม AI ที่คุณใช้ แล้วคัดลอกค่าตั้งไปวาง
ให้ AI ติดตั้งให้ด้วยประโยคเดียว
ติดตั้ง HPSILab Quant Finance ให้หน่อย ทำตาม https://mcp.popnx.com/i/haiyunsky-hpsilab-quant-finance-mcp.md แสดงคำสั่งให้ฉันดูและรอฉันตกลงก่อนรันคัดลอกไปวางในแชตของ AI ที่ทำงานในเครื่องคุณได้ (เช่น Claude Code, Cursor) · AI จะอ่านขั้นตอนจากเรา แสดงคำสั่งให้ดู และรอคุณตกลงก่อน · ไม่ต้องใช้คีย์ ไม่ต้องสมัคร · ดูข้อความเต็มที่ AI จะอ่าน
ผลตรวจผ่าน 5/5 · สิ่งที่คุณถามผ่านเซิร์ฟเวอร์ของผู้ทำ (hpsilab.com) · ✓ ตรวจคำสั่งแล้ว 13 พ.ย. 2569
ขั้นแรก: คุณใช้ AI ตัวไหน
เลือกแอปที่คุณใช้ ขั้นตอนจะขึ้นด้านล่าง
ต่อกับ Claude ได้ · ประมาณ 2 นาที
ไม่ต้องใช้คีย์ ไม่ต้องลงโปรแกรม · ตั้งครั้งเดียวที่ claude.ai หรือแอปบนคอม แล้วใช้ในแชตได้ · บัญชีฟรีเพิ่มได้ 1 ตัว · แผน Team/Enterprise ให้เจ้าของ (Owner) เป็นคนเพิ่ม
CustomizeConnectors
คัดลอกจากที่นี่ไปวางในช่องชื่อเดียวกันบนหน้าจอของ Claude แล้วกด Continue
HPSILab Quant Financehttps://hpsilab.com/mcpกด Continue ผ่านหน้าตรวจการล็อกอินที่ Claude ตรวจเจอ · หัวข้อ Authentication เลือกตามที่ผู้ทำบอก (Sign in now, Sign in when needed หรือ No sign in) แล้วกด Add
+ConnectorsHPSILab Quant Finance
ใช้ HPSILab Quant Finance บอกหน่อยว่าทำอะไรให้ฉันได้บ้าง แล้วลองทำให้ดูหนึ่งอย่าง✓ ถ้า Claude บอกว่ากำลังใช้ HPSILab Quant Finance หรือมีชื่อเครื่องมือของ HPSILab Quant Finance ขึ้นในคำตอบ แปลว่าต่อสำเร็จ
ชื่อเมนูตรวจกับหน้าช่วยเหลือของ Anthropic เมื่อ 11 พ.ย. 2569 · หน้าจอของคุณอาจต่างเล็กน้อยตามรุ่นของแอป
ต่อกับ ChatGPT ได้ ขึ้นกับแผน
MCP แบบเต็ม: ChatGPT Business, Enterprise หรือ Edu บนเว็บ · Pro: ต่อได้ด้วยสิทธิ์อ่านและดึงข้อมูล เครื่องมือที่แก้ข้อมูลอาจใช้ไม่ได้ · Plus: เอกสารยังไม่ยืนยัน ถ้าเห็นเมนูเพิ่ม MCP แบบกำหนดเองในหน้าปลั๊กอิน ลองตามขั้นตอนได้ · ใช้บนเว็บเท่านั้น
Plugins+Add custom MCP server
ใส่ชื่อ แล้ววางที่อยู่ใต้ Connection ติ๊กยอมรับคำเตือน แล้วกด Create as a plugin
HPSILab Quant Financehttps://hpsilab.com/mcpเปิดแชตใหม่แล้วเลือก HPSILab Quant Finance จากรายการปลั๊กอินก่อนพิมพ์
ใช้ HPSILab Quant Finance บอกหน่อยว่าทำอะไรให้ฉันได้บ้าง แล้วลองทำให้ดูหนึ่งอย่าง✓ ถ้า ChatGPT บอกว่ากำลังใช้ HPSILab Quant Finance หรือมีชื่อเครื่องมือของ HPSILab Quant Finance ขึ้นในคำตอบ แปลว่าต่อสำเร็จ
ชื่อเมนูตรวจกับหน้าช่วยเหลือของ OpenAI เมื่อ 11 พ.ย. 2569 · หน้าจอของคุณอาจต่างเล็กน้อยตามรุ่นของแอป
ต่อกับ Claude Code ได้ · ประมาณ 2 นาที
ไม่ต้องใช้คีย์ ไม่ต้องลงโปรแกรม
Mac: กด Command+Space พิมพ์ Terminal · Windows: เปิด PowerShell
claude mcp add --transport http --scope user hpsilab-quant-finance https://hpsilab.com/mcpต้องเห็น HPSILab Quant Finance ในรายการและขึ้นว่าเชื่อมต่อแล้ว
ใช้ HPSILab Quant Finance บอกหน่อยว่าทำอะไรให้ฉันได้บ้าง แล้วลองทำให้ดูหนึ่งอย่าง✓ ถ้า Claude Code บอกว่ากำลังใช้ HPSILab Quant Finance หรือมีชื่อเครื่องมือของ HPSILab Quant Finance ขึ้นในคำตอบ แปลว่าต่อสำเร็จ
ชื่อเมนูตรวจกับหน้าช่วยเหลือของ Anthropic เมื่อ 11 พ.ย. 2569 · หน้าจอของคุณอาจต่างเล็กน้อยตามรุ่นของแอป
ต่อกับ Cursor ได้ · ประมาณ 2 นาที
ไม่ต้องใช้คีย์ ไม่ต้องลงโปรแกรม
ใช้ HPSILab Quant Finance บอกหน่อยว่าทำอะไรให้ฉันได้บ้าง แล้วลองทำให้ดูหนึ่งอย่าง✓ ถ้า Cursor บอกว่ากำลังใช้ HPSILab Quant Finance หรือมีชื่อเครื่องมือของ HPSILab Quant Finance ขึ้นในคำตอบ แปลว่าต่อสำเร็จ
ชื่อเมนูตรวจกับหน้าช่วยเหลือของ Cursor เมื่อ 11 พ.ย. 2569 · หน้าจอของคุณอาจต่างเล็กน้อยตามรุ่นของแอป
ต่อกับ VS Code ได้ · ประมาณ 2 นาที
ไม่ต้องใช้คีย์ ไม่ต้องลงโปรแกรม
ใช้ HPSILab Quant Finance บอกหน่อยว่าทำอะไรให้ฉันได้บ้าง แล้วลองทำให้ดูหนึ่งอย่าง✓ ถ้า VS Code บอกว่ากำลังใช้ HPSILab Quant Finance หรือมีชื่อเครื่องมือของ HPSILab Quant Finance ขึ้นในคำตอบ แปลว่าต่อสำเร็จ
ชื่อเมนูตรวจกับหน้าช่วยเหลือของ VS Code เมื่อ 11 พ.ย. 2569 · หน้าจอของคุณอาจต่างเล็กน้อยตามรุ่นของแอป
โปรแกรมอื่นที่ใช้ MCP ได้ เช่น Windsurf, Zed หรือ Gemini CLI มีวิธีเพิ่มต่างกัน ดูวิธีของแต่ละตัวในหน้ารวมโปรแกรม
ที่อยู่สำหรับโปรแกรมที่ต่อผ่านเว็บ
https://hpsilab.com/mcpค่าตั้งแบบไฟล์ JSON อยู่ในหัวข้อ “สำหรับคนเขียนโค้ด” ด้านล่าง
Claude Code
claude mcp add --transport http --scope user hpsilab-quant-finance https://hpsilab.com/mcpCursor (~/.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"
}
}
}Claude Code
claude mcp add --scope user hpsilab-quant-finance --env HPSILAB_API_KEY='ใส่ค่าของคุณ' -- uvx hpsilab-quant-finance-mcpClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"hpsilab-quant-finance": {
"command": "uvx",
"args": [
"hpsilab-quant-finance-mcp"
],
"env": {
"HPSILAB_API_KEY": "ใส่ค่าของคุณ"
}
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"hpsilab-quant-finance": {
"command": "uvx",
"args": [
"hpsilab-quant-finance-mcp"
],
"env": {
"HPSILAB_API_KEY": "ใส่ค่าของคุณ"
}
}
}
}VS Code (mcp.json)
{
"servers": {
"hpsilab-quant-finance": {
"type": "stdio",
"command": "uvx",
"args": [
"hpsilab-quant-finance-mcp"
],
"env": {
"HPSILAB_API_KEY": "ใส่ค่าของคุณ"
}
}
}
}HPSILAB_API_KEY ความลับ จำเป็น envคำอธิบายแปลอัตโนมัติ ชื่อตัวแปรคงตามต้นฉบับ ถ้าไม่แน่ใจให้ดูต้นฉบับ
ค่าตั้งนี้สร้างจากข้อมูลใน registry ของผู้ทำ ถ้าไม่ตรงกับ README ให้เชื่อ README
pypi: hpsilab-quant-finance-mcpดูจากแบบการต่อของ server ตัวนี้ และเอกสารของผู้ทำโปรแกรมแต่ละตัว ตรวจเมื่อ 10 พ.ย. 2569
ต่อผ่านคลาวด์ได้ใน
ClaudeChatGPTGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast
ติดตั้งบนเครื่องได้ใน
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
ชื่อและคำอธิบายเครื่องมือตามที่ server ตอบมาเมื่อ 18 พ.ย. 2569 ผู้ทำเป็นคนเขียน ไม่ใช่เรา แสดงเป็นข้อความล้วน
register_accountRegister 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_radarImplied-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_carloMonte 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_predictionAI 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_curveBacktest 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_pressureOption-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_stockAggregate 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_scanFull 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_imagesGenerate 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_reportFull 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
เราตรวจจากข้อมูลที่ใครก็เปิดดูได้ ยังไม่ได้อ่านโค้ด ข้อที่ไม่เกี่ยวกับตัวนี้ไม่นับในตัวหาร · ตรวจเมื่อ 19 พ.ย. 2569
ชื่อใน registry ยืนยันด้วยบัญชี GitHub haiyunsky ซึ่งเป็นเจ้าของ repo
มีการแก้โค้ดล่าสุด 6 วันที่ผ่านมา
ใช้ MIT
ตอบกลับใน 538 ms (HTTP 200)
ไม่ต้องล็อกอิน
อ่านคำอธิบายเครื่องมือ 10 ตัวแล้ว ไม่พบคำสั่งแอบแฝงถึง AI
ไม่พบรายการใน OSV.dev สำหรับ hpsilab-quant-finance-mcp@0.11.1
ตรวจเฉพาะตัวแพ็กเกจรุ่นนี้ ไม่ใช่ทุก dependency · ตรวจเมื่อ 15 พ.ย. 2569
ถ้าคุณเป็นผู้ทำตัวนี้ คัดลอกโค้ดนี้ไปวางใน README ได้เลย ป้ายลิงก์กลับมาที่หน้านี้
[](https://mcp.popnx.com/th/servers/haiyunsky-hpsilab-quant-finance-mcp)ถาม แชร์เคล็ดลับ หรือแจ้งว่าใช้ไม่ได้ เรียงตามที่คนกดว่ามีประโยชน์
ยังไม่มีใครโพสต์ ถามหรือแชร์เป็นคนแรกได้เลย
ข้อความในส่วนนี้เขียนโดยผู้ใช้ ไม่ใช่ทีม PopNx
ยังไม่มีรีวิว
เทียบกับทุก server ที่ยังใช้งานในหมวดนี้ทั้งทะเบียน ดาวนับเฉพาะเมื่อผู้ลงทะเบียนเป็นเจ้าของ repo
จากการตรวจเบื้องต้นของเรา ผ่าน 5 จาก 5 ข้อที่ตรวจได้ เรายังไม่ได้อ่านโค้ด ก่อนใส่กุญแจหรือ token ให้ดูว่า server ขอสิทธิ์อะไร และเลือกกุญแจที่ทำได้เท่าที่จำเป็น
ต้องใส่ค่าเหล่านี้: HPSILAB_API_KEY
ได้ทั้งสองแบบ จะลงในเครื่องหรือต่อผ่านคลาวด์ก็ได้
repo บน GitHub มีการแก้โค้ดล่าสุด 6 วันที่ผ่านมา และส่งรุ่นล่าสุด (0.11.1) เข้า registry 26 วันที่ผ่านมา
โปรแกรมที่รองรับ MCP เช่น Claude Desktop, Claude Code, Cursor และ VS Code ตัวนี้ต่อผ่าน URL จึงใช้กับโปรแกรมที่รับ remote MCP ได้ เช่น ChatGPT บนเว็บ (แบบเต็มในแผน Business ขึ้นไป · Pro แบบอ่านอย่างเดียว)
ในหมวดเดียวกันมี SolidInvoice, Signal8, Journalit, Beancount.io, Tapetide - Indian Stock Market MCP
หมวดเดียวกันจากผู้ทำคนอื่น ผ่านตัวตรวจคำสั่งแล้ว ตัวทางการขึ้นก่อน แล้วเรียงตามดาว
อ่านการ์ด:↓ ดาวน์โหลดต่อสัปดาห์i★ ดาว GitHubiสามเสา: รีวิว · ผลตรวจ · การใช้งานiอัปเดต = วันที่ส่งรุ่นล่าสุดเข้า registryi
Create and send invoices and quotes, manage clients, and track payments in SolidInvoice.
SEC filings, dilution, insider & institutional ownership, and political-trade data for AI agents.
Trading journal in Obsidian. Ask Claude or ChatGPT about your trades; edits are previewed first.
Query, edit, and reconcile a hosted Beancount ledger: BQL, reports, files, and bank imports.
48 tools for ~8,000 NSE & BSE stocks: quotes, screener, financials, filings, FII/DII, options
| ตัวนี้ HPSILab Quant Finance | SolidInvoice | Signal8 | Journalit | Beancount.io | Tapetide - Indian Stock Market MCP | |
|---|---|---|---|---|---|---|
| ทำงานที่ไหน | มีทั้งบนคลาวด์และแบบลงเครื่อง | ใช้บนคลาวด์ ไม่ต้องลงเครื่อง | มีทั้งบนคลาวด์และแบบลงเครื่อง | ใช้บนคลาวด์ ไม่ต้องลงเครื่อง | ใช้บนคลาวด์ ไม่ต้องลงเครื่อง | มีทั้งบนคลาวด์และแบบลงเครื่อง |
| ต้องใส่คีย์ | ใช่ | ไม่ | ใช่ | ไม่ | ไม่ | ใช่ |
| กด + ใน Claude ได้ | ไม่ | ไม่ | ไม่ | ไม่ | ไม่ | ไม่ |
| ผลตรวจเบื้องต้น | 5/5 | 4/6 | 5/5 | 4/4 | 4/4 | 5/5 |
| สัญญาอนุญาต | MIT | MIT | MIT | NOASSERTION | MIT | MIT |
| ราคา | ไม่พบค่าใช้จ่ายในทะเบียน | ไม่พบค่าใช้จ่ายในทะเบียน | ไม่พบค่าใช้จ่ายในทะเบียน | ไม่พบค่าใช้จ่ายในทะเบียน | ไม่พบค่าใช้จ่ายในทะเบียน | ไม่พบค่าใช้จ่ายในทะเบียน |
ส่วนนี้คัดจาก repo ของผู้ทำตามต้นฉบับ PopNx MCP ไม่ได้ตรวจหรือรับรองเนื้อหา ตัด HTML รูปภาพ และสคริปต์ออกแล้ว ลิงก์จะพาออกนอกเว็บ
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:
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 |
Recommended, and requires no local installation.
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.
For clients without OAuth support, or for scripts:
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" } } } }
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.
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.
Nine financial research tools, plus register_account. Tool names and parameter meanings are part of the public compatibility contract.
| Tool | What it returns | Behavior |
|---|---|---|
analyze_stock | Aggregate directional and quantitative stock analysis | Read-only |
get_ai_prediction | Next-session prediction, confidence, and model consensus | Read-only |
get_iv_radar | IV level, rank, percentile, skew, and regime | Read-only |
get_option_pressure | Max pain, gamma walls, expected move, and pressure zones | Read-only |
get_monte_carlo | 10-trading-day simulated distribution and probabilities | Read-only |
get_equity_curve | Strategy backtests and risk-adjusted performance | Read-only |
get_pretrade_risk_scan | Position, exposure, correlation, and risk checks | Read-only |
generate_stock_images | Hosted stock and options chart artifacts | Creates an artifact; not idempotent |
generate_stock_research_report | Structured Markdown research report and timestamp | Creates an artifact; not idempotent |
register_account | Signing up from the client with no API key yet, or a fresh key for an existing account | Creates 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.
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.
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.
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.
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.
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_code | Meaning | What resolves it |
|---|---|---|
api_key_required | No key is configured | Registering. Nothing is sent downstream |
rate_limited | Calling too fast (429) | Waiting — next_actions carries the seconds |
insufficient_credits | The Credit balance is empty (402) | Adding Credits, or registering for trial Credits |
allowance_exhausted | The free evaluation ceiling is spent (402) | Registering, or verifying an email. Money does not lift it |
settlement_unknown | A payment whose outcome is unconfirmed | Reconciliation. 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.
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.
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.