Vanoe Market Intelligence

Señales del mercado de valores de EE. UU. para agentes de IA: veredicto compuesto por ticker con justificación, análisis de etapa de tendencia, Point & Figure, amplitud sectorial, régimen macro, presentaciones de insiders ante la SEC. Nivel gratuito

GitHubPrueba este MCPPatrocinado

Documentación

Servidor MCP de Vanoe Market Intelligence

Expone la API de Vanoe Market Intelligence como herramientas que cualquier asistente de IA compatible con MCP (Claude Desktop, Claude Code, Cursor, etc.) puede llamar directamente: un veredicto compuesto de 0 a 100 por ticker, análisis de etapa de tendencia (actual y un historial semanal seguro para backtesting), señales de Point & Figure, amplitud sectorial, el régimen de riesgo macro, presentaciones de insiders de la SEC y 8-K, el calendario macro y tu uso.

Este es un cliente autenticado ligero, no un nivel gratuito: cada llamada a una herramienta es una llamada real y medida contra tu plan usando tu propia clave de API, exactamente como si llamaras a la API REST tú mismo. Obtén una clave gratuita (1,000 créditos al mes, sin tarjeta) en https://api.vanoe.ai/signup.

Solo datos informativos. No es asesoramiento financiero. Ver https://api.vanoe.ai/terms.

Instalación

No se necesita ningún paso de instalación con uv — uvx descarga y ejecuta el paquete bajo demanda:

uvx vanoe-intelligence-mcp

O instálalo permanentemente con pipx install vanoe-intelligence-mcp o pip install vanoe-intelligence-mcp, lo que coloca un comando vanoe-intelligence-mcp en tu PATH.

Configura tu cliente MCP

Establece una variable de entorno, VANOE_API_KEY. VANOE_API_BASE_URL es opcional y tiene como valor predeterminado https://api.vanoe.ai.

Claude Desktop (claude_desktop_config.json) y la mayoría de los otros clientes:

{
  "mcpServers": {
    "vanoe": {
      "command": "uvx",
      "args": ["vanoe-intelligence-mcp"],
      "env": { "VANOE_API_KEY": "sk_live_your_key_here" }
    }
  }
}

Claude Code:

claude mcp add vanoe -e VANOE_API_KEY=sk_live_your_key_here -- uvx vanoe-intelligence-mcp

Luego pregúntale a tu asistente cosas como "¿Cuál es el veredicto sobre NVDA y por qué?", "¿En qué etapa están AAPL, MSFT y AMD?", o "¿El régimen macro está en modo de riesgo ahora mismo?" — llamará a las herramientas a continuación.

Herramientas

Herramienta	Llamada a la API	Créditos
`get_verdict(ticker)`	`GET /v1/verdict/{ticker}`	5
`get_stage(tickers)`	`GET /v1/signals/stage`	1 por ticker
`get_stage_history(ticker, weeks)`	`GET /v1/signals/stage/history`	5
`get_pnf(tickers)`	`GET /v1/signals/pnf`	1 por ticker
`get_sector_breadth()`	`GET /v1/sector-breadth`	1
`get_macro()`	`GET /v1/macro`	1
`get_filings(ticker)`	`GET /v1/filings/{ticker}`	1
`get_calendar()`	`GET /v1/calendar`	1
`get_usage()`	`GET /v1/usage`	0

Las herramientas nunca generan errores. Cualquier fallo — clave faltante, error de red, cuota excedida, un ticker desconocido — regresa como {"error": {"code", "message", "http_status"}} con el mensaje propio de la API, para que el asistente pueda explicar lo que sucedió en lugar de interrumpir la llamada.

La gestión de webhooks se expone deliberadamente: es administración de cuenta, no algo para hacer a mitad de conversación. Usa la API REST para eso.

Desarrollo

git clone https://github.com/peeroren/vanoe-intelligence-mcp.git
cd vanoe-intelligence-mcp
python -m venv .venv && . .venv/bin/activate     # Windows: .venv\Scripts\activate
pip install -e '.[test]'
pytest tests
VANOE_API_BASE_URL=http://localhost:8000 VANOE_API_KEY=sk_live_… vanoe-intelligence-mcp

El código fuente está en https://github.com/peeroren/vanoe-intelligence-mcp;; los problemas y las solicitudes de extracción son bienvenidas. Si también ejecutas el servidor de la API localmente, instala esto en su propio virtualenv, separado del requirements.txt del servidor de la API: el SDK de mcp incorpora una versión más nueva de starlette de la que tolera el pin de FastAPI de la API, y compartir un entorno rompe el servidor de la API con Router.__init__() got an unexpected keyword argument 'on_startup'. Los usuarios finales nunca se topan con esto (el servidor MCP se ejecuta en su máquina, junto a su asistente).

tests/manual_e2e_smoke.py ejecuta el servidor real como un subproceso sobre stdio contra una API accesible con una clave real; no es parte de pytest.

El SDK de Python de MCP está en la v2: la clase del servidor es mcp.server.mcpserver.MCPServer (los tutoriales más antiguos muestran FastMCP en una ruta de importación diferente).

Publicación

python -m build
twine upload dist/*

Primero incrementa version en pyproject.toml. Los nombres de variables más antiguos INTEL_API_KEY / INTEL_API_BASE_URL todavía se aceptan por compatibilidad.