FalsifyLab Alpha

8 herramientas de datos que exponen alpha de cripto y acciones estadounidenses a agentes de IA a través de MCP

Documentación

falsifylab-alpha-mcp

FalsifyLab Alpha: 13 live finance MCP tools for AI coding agents

Capa de datos MCP para investigación de mercado asistida por IA. 13 herramientas financieras en vivo que se integran en Claude Code, Cursor, Cline, Windsurf o cualquier cliente compatible con MCP. El nivel gratuito no requiere registro.

No es un servicio de señales. No es asesoramiento de inversión. Datos de mercado públicos con enriquecimiento ligero para agentes de IA. Haz backtesting antes de actuar.

Dos formas de usarlo

Opción 1: MCP alojado (sin instalación). Apunta tu agente al endpoint alojado, no necesitas Python.

{
  "mcpServers": {
    "falsifylab-alpha": {
      "url": "https://mcp.falsifylab.com/"
    }
  }
}

El nivel gratuito se aplica automáticamente. Flujo OAuth 2.1 + PKCE para el plan de pago vía Whop. Transporte HTTP streamable. Especificación OpenAPI 3.1 completa en https://docs.falsifylab.com/openapi.html.

Opción 2: stdio (este paquete).

pip install falsifylab-alpha-mcp

Cero dependencias en tiempo de ejecución (solo stdlib de Python). Luego conéctalo a tu agente. Consulta configuración del cliente.

Qué hace

Cuando el usuario le pide a tu agente de IA cosas como:

"¿Qué clústeres de insiders se están formando hoy?"
"Muéstrame bóvedas de Hyperliquid con Sharpe alto y drawdown <10%"
"¿Los flujos de ETF de BTC están confirmando o divergiendo de la acción del precio?"
"¿Qué hay en la cinta macro ahora mismo?"
"Encuentra ballenas de Polymarket con tasa de victoria superior al 60%"

...el agente llama a una de las 13 herramientas y fundamenta su respuesta en números en tiempo real de datos de mercado público — en lugar de especular a partir del conocimiento de los datos de entrenamiento.

Las 13 herramientas

Herramienta	Devuelve	Caso de uso
`top_yield_farms`	Rendimientos DeFi con emisiones eliminadas, riesgo de IL valorado	Encuentra rendimiento real, no rendimiento titular
`hl_vault_leaderboard`	Bóvedas de Hyperliquid por NAV / 30d / drawdown / puntuación	Referencia de copy-trade
`insider_buy_clusters`	Compras en clúster del Formulario 4 de la SEC (3+ insiders, ventana de 24h)	Señal de convicción en acciones
`sec8k_material_today`	Presentaciones 8-K filtradas por códigos de partidas materiales	Ganancias, M&A, cambios de directivos
`macro_tape`	Instantánea de SPX/NDX/VIX/UST/DXY/GOLD/WTI/BTC/ETH	Puerta de régimen para ideas de trading
`etf_flow_today`	Agregados de ETF spot de BTC + ETH en EE. UU.	Posicionamiento institucional
`active_airdrop_farms`	Airdrops de brecha de rendimiento de DefiLlama	Granjas donde te pagan por esperar
`polymarket_whale_positions`	Principales wallets + posiciones activas	Copy-trade en mercados de predicción
`earnings_drift_radar`	Deriva post-resultados + candidatos a aplastamiento de IV	Escáner de volatilidad de eventos en acciones
`token_unlock_radar`	Calendario de desbloqueo de tokens + tamaño	Radar de riesgo de exceso de oferta
`fed_comm_radar`	Ventanas de volatilidad de eventos de la Fed	Escáner de riesgo de eventos macro
`confluence_today`	Alineación de señales entre fuentes	Apila 2+ señales sobre el mismo activo
`onchain_smart_wallets`	Puntuaciones en vivo de bots de copy-trade de Solana	Rankings de wallets de producción

Todas las herramientas tienen esquemas JSON completos expuestos en /.well-known/mcp/server-card.json.

Configuración del cliente

Claude Code

claude mcp add falsifylab-alpha -- python -m falsifylab_alpha_mcp

Para el nivel Pro:

claude mcp add falsifylab-alpha \
  --env FL_API_KEY=fl_your_key \
  -- python -m falsifylab_alpha_mcp

Cursor

Colócalo en ~/.cursor/mcp.json o en la raíz del workspace .mcp.json:

{
  "mcpServers": {
    "falsifylab-alpha": {
      "command": "python",
      "args": ["-m", "falsifylab_alpha_mcp"],
      "env": {
        "FL_API_KEY": "fl_your_key_or_omit_for_free_tier"
      }
    }
  }
}

Reinicia Cursor. Las herramientas se descubren automáticamente.

Cline

Configuración → Servidores MCP → Agregar servidor. Pega el mismo JSON que en Cursor arriba.

Windsurf

Configuración → MCP. Misma configuración JSON. Indexado automáticamente desde Smithery dentro de 48h.

Smithery

Conéctate a través de la puerta de enlace alojada de Smithery — no necesitas instalación local de Python. Consulta smithery.ai/servers/falsifylab/falsifylab-alpha-mcp.

Verificar instalación

En tu agente, pregunta:

Usa macro_tape. Muéstrame SPX, VIX, BTC, ETH con retornos de 1d y 5d.

Si el agente devuelve números, estás en vivo.

Prompts de agente funcionales

Copia y pega estos. Funcionan en la primera ejecución.

Resumen macro diario:

Use macro_tape. Tell me the macro regime in 3 sentences. Cite specific
numbers — last price, 1d return, 5d return. Then list 2 tickers from
sec8k_material_today that might benefit from this regime.

Apilador de insiders + 8-K:

Run insider_buy_clusters (min_insiders=3) and sec8k_material_today
(items=["2.02","8.01","5.02"]). Find tickers in both within 24h. For
each match, summarize what insiders bought and what the 8-K said. End
with the bear case in one sentence.

Escaneo de confluencia con caso bajista:

Use confluence_today with min_signals=2. For each asset/ticker, explain
why these signals stacking is meaningful in 2 sentences. Skip noise
(DeFi LP pools with stablecoins). Highlight the most contrarian stack.

8 recetas más en falsifylab.com/cookbook.

Precios

Nivel	Precio	Qué incluye
Gratis	$0	Caché de 24h, 10 resultados/consulta, sin registro, 60 req/h
Pro	$19/mes	Tiempo real (5min), 100 resultados/consulta, historial de 90d, sin límite de tasa
Pro Plus	$49/mes	Refresco de 1 min, alertas por email + Slack, 365d en feeds de acciones, webhooks
Equipos	$199/mes	5 asientos, 50k req/día, soporte prioritario

Promoción de lanzamiento EARLY50: 50% de descuento en los primeros 3 meses, máximo 25 canjes. Obtén una clave en falsifylab.com/pro.

Demo en vivo

Agente público que llama a estas herramientas cada 15 minutos: falsifylab.com/demo. El mismo servidor MCP que instalarías. Números reales, sin curación.

Por qué existe esto

Lo construí porque el autor raspaba manualmente SEC EDGAR y DefiLlama a las 6am cada mañana para alimentar una flota de bots de trading. Los bots que sobrevivieron se alimentaron de este mismo pipeline. Lo envolví como un servidor MCP para que cualquier agente pueda extraer los mismos datos.

Los recibos de la flota de bots (vivos + muertos, P&L, drawdown) son públicos en falsifylab.com/vaults.

Transparencia

Qué hacemos: agregamos y enriquecemos ligeramente datos de mercado públicos, los exponemos vía MCP
Qué no hacemos: ejecución de trades, corretaje, asesoramiento, venta de señales
Fuentes de datos: SEC EDGAR (Formulario 4, 8-K), SoSoValue (flujos de ETF), DefiLlama (rendimiento), API pública de Hyperliquid, API pública de Polymarket, Yahoo Finance (macro)
Privacidad: la clave del nivel gratuito se emite por hash(IP+UA), no se almacena a largo plazo. Los cuerpos de las solicitudes nunca se registran.

Telemetría

El servidor stdio local escribe filas JSONL de telemetría mínima por herramienta en:

/var/log/falsifylab/mcp_tool_calls.jsonl (anular con FL_MCP_TOOL_CALL_LOG)

Cada fila incluye solo:

ts, tool, args_keys (solo nombres de argumentos), has_api_key, key_hash (prefijo sha256), version

Nunca se registran en esta ruta de telemetría:

claves API crudas
valores de argumentos / cuerpos de solicitudes
dirección IP
email / nombre / otros identificadores de usuario

Para deshabilitar la telemetría por completo:

export FL_DISABLE_TELEMETRY=1

Qué funciona, qué no

Lista honesta. Actualizada en cada versión.

Qué funciona hoy

Las 13 herramientas devuelven datos en vivo dentro de llamadas de agente en menos de 1s p95.
El nivel gratuito tiene cero fricción de registro. No se necesita clave API para la ruta en caché.
Los clústeres de insiders del Formulario 4 se actualizan cada 15 min en días laborables desde SEC EDGAR directo, sin revendedor de terceros en el pipeline.
Los rendimientos de DefiLlama están despojados de emisiones (APY titular menos tokens de recompensa), así que una granja del 200% y otra del 200% ya no son el mismo número.
Las actualizaciones de NAV de bóvedas de Hyperliquid llegan a nuestro espejo R2 dentro de 60s del ticker fuente.
La entrega de webhooks de Telegram + Slack en Pro Plus llega a tiempo dentro de la ventana cron. Sin acumulaciones en cola en el mes de lanzamiento.

Qué no funciona (aún)

La lista de presentaciones materiales 8-K está vacía los fines de semana porque la SEC no presenta. Devuelve count: 0 sáb/dom. Esperado.
La cinta macro usa endpoints gratuitos de Yahoo Finance. Brecha intradía de 15-20 min durante el horario de mercado de EE. UU. Planeamos cambiarlo a un feed de pago en el nivel Equipos, no antes.
onchain_smart_wallets solo cubre Solana por ahora. Las puntuaciones de copy-trade de Base + Ethereum están en cola para v0.3.x.
La caché del nivel gratuito es de 24h. Así que confluence_today en una clave gratuita muestra la confluencia de ayer, no la de hoy. El plan Pro de $19/mes llega en vivo.
La reproducción histórica a través de múltiples trimestres no está en v0.2.x. Se sigue como elemento de hoja de ruta.
Aún no hay SDK para TypeScript o Go. Solo servidor MCP de Python. Usa transporte stdio desde cualquier cliente compatible con MCP mientras tanto.

Qué ya eliminamos

Suscripciones directas de Stripe Connect (bloqueo de KYC del operador). Whop es el camino.
Plan de pago de Substack (dependencia de Stripe).
Una versión anterior del paquete 0.2.0 envió un host api.falsifylab.com roto. Corregido en 0.2.1 dentro de 4 días. Disculpas si obtuviste 0.2.0 primero.

Si encuentras algo roto, envía un DM a la cuenta X de FL o abre un issue. Enviamos correcciones el mismo día para errores que bloquean producción.

Arquitectura

your AI agent
    ↓ (MCP stdio)
falsifylab_alpha_mcp (Python stdlib, no deps)
    ↓ (HTTPS)
falsifylab.com/api/* (Cloudflare Workers)
    ↓ (cached 60s-1hr)
R2 (data feeds refreshed every 15min via cron)
    ↓ (every 15min)
Backend cron scripts (Form 4, 8-K, ETF, yield, polymarket, onchain, etc.)

El nivel gratuito accede a datos en caché con antigüedad de 24h. El nivel Pro accede a los mismos endpoints con encabezado de autenticación, omitiendo la caché hacia el upstream fresco.

Enlaces

Demo en vivo: falsifylab.com/demo
Guía de instalación: falsifylab.com/install
Cookbook: falsifylab.com/cookbook
Precios: falsifylab.com/pro
Comparación (vs Token Terminal / Nansen / Dune): falsifylab.com/vs
Tarjeta de servidor MCP: /.well-known/mcp/server-card.json
Substack: falsifylab.substack.com
PyPI: pypi.org/project/falsifylab-alpha-mcp
Smithery: smithery.ai/servers/falsifylab/falsifylab-alpha-mcp
Repositorio de inicio para agentes: github.com/opsfalsifylab/falsifylab-agent-starter

Soporte

Issues: Issues de GitHub
Email: ops@falsifylab.com
Seguridad: reporta a ops@falsifylab.com con el asunto [security]. Respuesta en 48h. Divulgación responsable acreditada en CHANGELOG.

Contribuciones

Se aceptan PRs para:

Nuevas ideas de herramientas (abre un issue primero para discutir el alcance)
Mejoras de documentación
Correcciones de errores

No envíes PRs para generadores de señales de trading o ayudantes de copy-trading — fuera del alcance de este servidor (somos infraestructura de datos de investigación, no asesoría).

Licencia

MIT. Consulta LICENSE.

FalsifyLab Alpha v0.3.3 · Construido para agentes de codificación de IA · Nivel gratuito sin registro · falsifylab.com