filingrail-mcp
Presentaciones SEC EDGAR como herramientas MCP: datos financieros XBRL, operaciones de información privilegiada del Formulario 4, eventos 8-K y tenencias 13F, con la URL de la presentación de sec.gov en cada registro.
Documentación
filingrail-mcp — presentaciones SEC EDGAR dentro de Claude, Cursor y cualquier agente MCP
Dale a tu agente de IA datos en vivo de SEC EDGAR: finanzas de empresas, operaciones de insiders, eventos 8-K, tenencias 13F y el flujo de presentaciones en bruto — todo normalizado a JSON limpio, con cada número trazable hasta su sec.gov presentación fuente.
Un pip install, una clave API, y tu agente puede responder "¿Cuál fue la posición de efectivo de Apple el último trimestre?" o "Enumera las 10 principales tenencias de Berkshire Hathaway al 2026-Q1" — basándose en presentaciones reales, no en sus datos de entrenamiento.
pip install filingrail-mcp
Disponible en PyPI: pypi.org/project/filingrail-mcp · Licencia MIT · Python 3.10+
Por qué existe esto
Cada número que una empresa pública reporta a la SEC es gratuito y abierto en EDGAR. El cuello de botella no es el acceso — es el parser XBRL, el normalizador de deriva de etiquetas, el gobernador de límite de tasa y la capa de deduplicación que tendrías que escribir antes de obtener la cifra que realmente querías. filingrail-mcp entrega a tu agente el JSON terminado en su lugar.
- Trazable a la fuente. Cada respuesta financiera lleva el
source_filing_urlde origen. Haz clic y ve el 10-K / 10-Q exacto en sec.gov. Sin "confía en nosotros". - Normalizado.
revenueesrevenue, ya sea que el presentador lo haya etiquetado comous-gaap:Revenues,SalesRevenueNetoRevenueFromContractWithCustomerExcludingAssessedTax. Más de 1.8M de filas XBRL desde 2006. - Cero infraestructura. Sin configuración de User-Agent de EDGAR, sin parser local, sin gobernador de límite de tasa. La API maneja todo.
Obtén una clave (nivel gratuito, sin tarjeta)
Filingrail es una API REST en RapidAPI. El nivel gratuito es 50 llamadas/día, sin tarjeta de crédito:
→ Suscríbete a Filingrail en RapidAPI y copia tu X-RapidAPI-Key.
El usuario final trae su propia clave — configúrala como RAPIDAPI_KEY en la configuración de tu cliente MCP (abajo).
Configura tu agente
Claude Desktop
Edita %APPDATA%/Claude/claude_desktop_config.json (Windows) o ~/Library/Application Support/Claude/claude_desktop_config.json (macOS):
{
"mcpServers": {
"filingrail": {
"command": "filingrail-mcp",
"env": { "RAPIDAPI_KEY": "your-rapidapi-key-here" }
}
}
}
Reinicia Claude Desktop. Las herramientas de Filingrail (search_companies, get_financials, get_insider_trades, …) aparecen en la lista de herramientas. Luego solo haz una pregunta en inglés sencillo.
Cursor / Continue / cualquier otro cliente MCP
Apunta el cliente a filingrail-mcp como comando stdio y pasa RAPIDAPI_KEY como variable de entorno. Misma estructura que arriba.
Si tu cliente solo acepta un comando en bruto, usa:
{ "command": "filingrail-mcp", "env": { "RAPIDAPI_KEY": "your-rapidapi-key-here" } }
Herramientas expuestas
| Herramienta | Qué hace |
|---|---|
search_companies(q, limit) | Resuelve ticker / CIK / fragmento de nombre a una empresa (más de 8,000 emisores SEC, coincidencia difusa) |
get_recent_filings(form_type, cik, limit) | Flujo de presentaciones recientes — filtra por formulario (10-K, 8-K, 4, 13F-HR) o CIK |
get_financials(ticker_or_cik, limit) | Partidas normalizadas del último 10-K / 10-Q + source_filing_url |
get_financials_history(ticker_or_cik, period, limit, …) | Series históricas trimestrales o anuales |
get_insider_trades(ticker_or_cik, since, limit) | Transacciones del Formulario 4 — quién compró/vendió, cuándo, cuánto |
get_8k_events(ticker_or_cik, since, limit) | Eventos materiales 8-K con códigos de ítem SEC (5.02, 2.01, …) |
get_13f_holdings(institution_cik, quarter, limit) | Tenencias institucionales (p. ej. Berkshire = CIK 1067983) |
health() | Verificación de disponibilidad de la API |
Pruébalo
Después de instalar y configurar, pregúntale a tu agente:
- "¿Cuál fue el ingreso y el ingreso operativo de Apple el último trimestre, y pásame el enlace de la presentación?"
- "Muéstrame ventas de insiders en NVIDIA en los últimos 30 días."
- "¿Qué eventos 8-K presentó Tesla este mes?"
- "Enumera las 10 posiciones 13F más grandes de Berkshire Hathaway para 2026-Q1."
Lo que no es
Advertencias honestas:
- No es en tiempo real. Las presentaciones nuevas aparecen dentro de ~24h tras la aceptación de EDGAR (política de acceso justo).
- No es Bloomberg. Sin precios intradía, cadenas de opciones, emisores no estadounidenses ni estimaciones de analistas.
- Datos SEC estructurados, trazados a la fuente — ese es todo el producto.
Precios
| Nivel | Precio | Llamadas/mes |
|---|---|---|
| Gratis | $0 | 1,500 (50/día) |
| Pro | $9/mes | 5,000 |
| Ultra | $49/mes | 50,000 |
| Mega | $199/mes | 500,000 |
Las claves y la facturación las gestiona RapidAPI. Obtén la tuya →
Enlaces
- Obtén una clave API (listado en RapidAPI)
- Página principal de Filingrail
- SDK de Python (sync + async) —
pip install filingrail - Página de estado de la API
- Preguntas / problemas:
support@hudsonenterprisesllc.com
Licencia
MIT © Hudson Enterprises LLC