Prototipo · Versión preliminar: todos los servidores del registro oficial, sincronizados cada 30 minutos. Inicia sesión con Google para escribir reseñas.Prototipo · se actualiza cada 30 min
PopNx MCPServidores MCP para quienes usan IA · en palabras sencillas

HPSILab Quant Finance

de haiyunskyversión 0.11.1i★ 1iComputadora o nubeSitio oficial ↗
Nombre en el registroio.github.haiyunsky/hpsilab-quant-finance-mcp

Cómo instalar

What it does

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

  • Connects Computadora o nube
  • Account or key Cloud: Works without a key · add Authorization if you have one (often raises limits) · Local: Needs HPSILAB_API_KEY
  • Category Contabilidad, finanzas e impuestos

Por qué está en este puesto

Las listas se ordenan por una puntuación de uso (sobre 100) con estas partes

Popularidad4/80Estrellas de GitHub o descargas semanales: la mayor cuenta 60, la menor 20
Actualidad12/12Puntuación completa con una versión o cambio de código en 30 días
Sigue respondiendo8/8El endpoint en la nube respondió en la última revisión
Puntuación de uso24/100

Calidad: Pasó 5/5 revisiones básicas (se muestra, no ordena) · Impulso: Sin datos aún (Solo se usa en la pestaña En auge)

Instalación

Elige la app de IA que usas y copia la configuración.

Que tu IA lo instale con una frase

Instala HPSILab Quant Finance. Sigue https://mcp.popnx.com/i/haiyunsky-hpsilab-quant-finance-mcp.md, enséñame los comandos y espera mi OK antes de ejecutarlos.

Pégala en una IA que trabaje en tu equipo (como Claude Code o Cursor). Lee nuestros pasos, te muestra los comandos y espera tu OK. Sin clave ni registro. · Ver el texto completo que lee tu IA

Pasó 5/5 revisiones · Lo que preguntas pasa por el servidor del autor (hpsilab.com) · ✓ Comandos revisados el 13 nov 2026

Primero: ¿qué IA usas?

Elige tu app y los pasos aparecen abajo.

Funciona con Claude · unos 2 min

Sin clave y sin instalar nada · Configúralo una vez en claude.ai o en la app de escritorio y úsalo en el chat · las cuentas gratis pueden añadir 1 · en Team/Enterprise lo añade un Owner

  1. Abre la página Connectors de Claude

    CustomizeConnectors

    CustomizeConnectors1Add2https://…3Add4
  2. Pulsa “Add” → “Custom” → “Web” y completa estos 2 campos

    Copia cada valor al campo con el mismo nombre en Claude y pulsa Continue

    Name · NombreHPSILab Quant Finance
    Remote MCP server URL · Direcciónhttps://hpsilab.com/mcp

    Pulsa Continue en la pantalla de inicio de sesión que detectó Claude · en Authentication elige lo que indique el autor (Sign in now, Sign in when needed o No sign in) y pulsa Add

  3. Actívalo en un chat

    +ConnectorsHPSILab Quant Finance

  4. Pruébalo

    Usa HPSILab Quant Finance y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Claude dice que está usando HPSILab Quant Finance o muestra una herramienta de HPSILab Quant Finance en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con ChatGPT según tu plan

MCP completo: ChatGPT Business, Enterprise o Edu en la web · Pro: conecta con permisos de lectura/obtención, así que las herramientas que cambian datos pueden no funcionar · Plus: no confirmado en la documentación; si ves una opción para añadir MCP propio en la página de plugins puedes probar · solo web

  1. Abre la página para añadir MCP en ChatGPT web

    Plugins+Add custom MCP server

    ChatGPTPlugins1+2https://…3Create4
  2. Escribe el nombre y la dirección

    Pon un nombre, pega la dirección en Connection, marca el aviso de riesgo y pulsa Create as a plugin

    Name · NombreHPSILab Quant Finance
    Connection · Direcciónhttps://hpsilab.com/mcp
  3. Elige HPSILab Quant Finance en un chat

    Abre un chat nuevo y elige HPSILab Quant Finance en tus plugins antes de escribir

  4. Pruébalo

    Usa HPSILab Quant Finance y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si ChatGPT dice que está usando HPSILab Quant Finance o muestra una herramienta de HPSILab Quant Finance en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de OpenAI el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con Claude Code · unos 2 min

Sin clave y sin instalar nada

  1. Abre la Terminal

    Mac: pulsa Command+Espacio y escribe Terminal · Windows: abre PowerShell

  2. Pega este comando y pulsa Enter

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

    Deberías ver HPSILab Quant Finance en la lista como conectado

  4. Pruébalo

    Usa HPSILab Quant Finance y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Claude Code dice que está usando HPSILab Quant Finance o muestra una herramienta de HPSILab Quant Finance en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con Cursor · unos 2 min

Sin clave y sin instalar nada

  1. Pulsa este botón para abrir Cursor

    Abrir en Cursor

    Cursor te pedirá confirmar; pulsa Install

  2. Abre el chat de IA de Cursor en modo Agent

  3. Pruébalo

    Usa HPSILab Quant Finance y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Cursor dice que está usando HPSILab Quant Finance o muestra una herramienta de HPSILab Quant Finance en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Cursor el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con VS Code · unos 2 min

Sin clave y sin instalar nada

  1. Pulsa este botón para abrir VS Code

    Abrir en VS Code

    VS Code te pedirá confirmar; pulsa Install

  2. Abre el chat de IA de VS Code en modo Agent

  3. Pruébalo

    Usa HPSILab Quant Finance y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si VS Code dice que está usando HPSILab Quant Finance o muestra una herramienta de HPSILab Quant Finance en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de VS Code el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Otras apps que usan MCP, como Windsurf, Zed o Gemini CLI, añaden servidores de forma distinta. Míralo en la lista de apps

Ver todas las apps que usan MCP →

Dirección para apps que se conectan por la web

Direcciónhttps://hpsilab.com/mcp

La configuración JSON está en “Para desarrolladores”, abajo

¿Te atascaste? Pregunta a quien usa HPSILab Quant Finance💬 Conversación →
Para desarrolladores: comandos de Terminal y configuración JSON

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

Instalado en tu computadora

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

Valores que debes completar

  • HPSILAB_API_KEY secreto obligatorio env
    Clave de API de HPSILab generada y gestionada en la configuración de HPSILab.
    Ver original en inglésHPSILab API key generated and managed in HPSILab Settings.
  • Authorization secreto HTTP header
    Opcional. Los clientes compatibles con MCP OAuth pueden omitirlo e iniciar sesión en HPSILab; de lo contrario, envía una clave de API Bearer desde la configuración de HPSILab. Las herramientas de investigación requieren una de las dos opciones.
    Ver original en inglésOptional. 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.

Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.

Esta configuración se genera a partir de la ficha del creador en el registro. Si el README dice otra cosa, sigue el README.

De un vistazo

Descargas por semanai
76/sem
Conexión
Computadora o nube
Transporte
stdio, streamable-http
Última versióni
0.11.1
Publicado en el registroi
24 oct 2026
Último cambio de códigoi
13 nov 2026
Última revisión
18 nov 2026
Creador
haiyunsky
Paquetes
pypi: hpsilab-quant-finance-mcp
Sitio web
hpsilab.com
Estado en el registro
Activo

Qué apps pueden usarlo

Según cómo se conecta este servidor y la documentación de cada app, comprobado el 10 nov 2026.

Se conectan por internet en

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

Se ejecutan en tu computadora en

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

Todas las apps, con ventajas y desventajas →

Qué puede hacer

Nombres y descripciones de las herramientas tal como los informó el servidor el 18 nov 2026. Los escribió el creador, no nosotros; los mostramos como texto sin formato.

  • 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

Revisiones básicasi

Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 20 nov 2026

  • ✓ Superada

    El creador coincide con el repo

    El nombre en el registro se verificó con la cuenta de GitHub haiyunsky, dueña del repo

  • ✓ Superada

    Sigue en mantenimiento

    Último cambio de código: hace 7 días

  • ✓ Superada

    Tiene licencia

    Usa MIT

  • ✓ Superada

    El endpoint responde

    Respondió en 538 ms (HTTP 200)

  • – No aplica

    Inicio de sesión con OAuth

    No hace falta iniciar sesión

  • ✓ Superada

    Sin instrucciones ocultas en las descripciones de herramientas

    Leímos 10 descripciones de herramientas y no encontramos instrucciones ocultas para la IA

Vulnerabilidades publicadas (OSV.dev)

Sin entradas en OSV.dev para hpsilab-quant-finance-mcp@0.11.1

Solo revisa esta versión del paquete, no todas sus dependencias · revisado 15 nov 2026

Qué revisamos → · JSON

Creadores: pedir otra revisión o avisar de un dato erróneo
Para autores: añade una insignia a tu README

Si lo creaste tú, pega este código en tu README. La insignia enlaza a esta página.

[![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)

Conversación

Pregunta, comparte un consejo o avisa de que no funciona. Ordenado por lo que la gente marcó como útil.

Aún no hay publicaciones. Sé la primera persona en preguntar o compartir.

Lo publicado aquí lo escriben usuarios, no el equipo de PopNx.

Inicia sesión para publicar

Reseñas de usuarios

Aún no hay reseñas

Inicia sesión para escribir una reseña

Comparado con otros en Contabilidad, finanzas e impuestosi

  • Más estrellas que el 87% de los otros 3448 servidores de esta categoría
  • Publicado en el registro más recientemente que el 53% de los otros 3448 servidores de esta categoría
  • Revisiones básicas iguales o mejores que el 99% de los otros 3448 servidores de esta categoría

Comparado con todos los servidores activos de esta categoría en el registro. Las estrellas solo cuentan cuando quien lo publica es dueño del repo.

Preguntas frecuentes

¿Es seguro HPSILab Quant Finance?

Superó 5 de 5 revisiones básicas aplicables. No hemos leído el código. Antes de agregar una clave o un token, revisa qué acceso pide el servidor y usa una clave que tenga solo los permisos que necesitas.

¿Qué claves o códigos necesita?

Debes completar: HPSILAB_API_KEY

¿Se ejecuta en mi computadora o en la nube?

Funciona de las dos formas: instálalo en tu computadora o conéctate a la versión en la nube.

¿Sigue en mantenimiento?

El repo de GitHub cambió por última vez hace 7 días, y la última versión (0.11.1) llegó al registro hace 27 días.

¿Qué apps pueden usarlo?

Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. Se conecta por URL, así que también sirve en apps que aceptan MCP remoto, como ChatGPT en la web (MCP completo en Business y superiores; Pro solo lectura).

¿Qué puedo usar en su lugar?

En la misma categoría: SolidInvoice, Signal8, Journalit, Beancount.io, Tapetide - Indian Stock Market MCP

Alternativas parecidas

Misma categoría, otros creadores, comandos ya revisados. Primero los oficiales, luego por estrellas.

Cómo leer una tarjeta:↓ Descargas por semanai★ Estrellas de GitHubiTres pilares: reseñas · revisiones · usoiActualizado = fecha en que se publicó la última versión en el registroi

SolidInvoice

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

de SolidInvoiceEn crecimiento★ 991Actualizado hace 11 días

Se ejecuta en la nube✓ del servicio · solidinvoice.co

Signal8

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

de signal8aiEn crecimiento↓ 431/sem★ 425Actualizado hace 11 días

Computadora o nube✓ del servicio · signal8.ai

Journalit

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

de CursivezEn crecimiento★ 261Actualizado hace 12 días

Se ejecuta en la nube✓ del servicio · journalit.co

Beancount.io

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

de bex-coEn crecimiento★ 702 Estrellas de todo el repositorioActualizado el mes pasado

Se ejecuta en la nube✓ del servicio · beancount.io
Comparado con otros parecidos
Este
HPSILab Quant Finance
SolidInvoiceSignal8JournalitBeancount.ioTapetide - Indian Stock Market MCP
Dónde se ejecutaEn la nube o instalado en tu equipoFunciona en la nube, sin instalar nadaEn la nube o instalado en tu equipoFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nadaEn la nube o instalado en tu equipo
Necesita claveSíNoSíNoNoSí
Se añade con + en ClaudeNoNoNoNoNoNo
Revisiones básicas5/54/65/54/44/45/5
LicenciaMITMITMITNOASSERTIONMITMIT
PrecioSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registro

README del creador

Abrir el README

Copiado tal cual del repo del creador. PopNx MCP no lo ha revisado ni lo respalda. Se quitaron HTML, imágenes y scripts. Los enlaces llevan fuera de este sitio.

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.