FinData MCP
Servidor MCP de datos financieros: cotizaciones de acciones, fundamentos de empresas, indicadores económicos, presentaciones ante la SEC y precios de criptomonedas mediante micropagos x402
Documentación
FinData MCP
Datos del mercado bursátil, fundamentos de empresas, indicadores macroeconómicos de FRED, presentaciones SEC EDGAR y precios de criptomonedas para agentes de IA, todo en un solo servidor MCP. Prueba gratuita: 50 llamadas/día. Pago por uso: $0.01/llamada mediante micropagos x402 en Base. Sin registro, sin clave API.
Datos financieros para agentes de IA. Cinco herramientas que cubren precios de acciones en tiempo real (NYSE, NASDAQ, más de 50 000 tickers), fundamentos de acciones (ratio P/E, ganancias, capitalización de mercado), más de 800 000 series económicas de FRED (PIB, IPC, inflación, tasas de interés, rendimientos de bonos del Tesoro), presentaciones SEC EDGAR (informes anuales 10-K, 10-Q, 8-K) y precios de criptomonedas (Bitcoin, Ethereum, más de 8 000 monedas). Funciona con Claude Desktop, Cursor, Windsurf y cualquier cliente MCP.
Inicio rápido
Instalación:
pip install findata-mcp
Configura tu clave de wallet (cualquier wallet EVM con USDC en Base):
export EVM_PRIVATE_KEY=your_private_key_here
Añade a Claude Desktop — edita ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"findata-mcp": {
"command": "findata-mcp",
"env": {
"EVM_PRIVATE_KEY": "your_private_key_here"
}
}
}
}
Añade a Cursor — edita .cursor/mcp.json en la raíz de tu proyecto:
{
"mcpServers": {
"findata-mcp": {
"command": "findata-mcp",
"env": {
"EVM_PRIVATE_KEY": "your_private_key_here"
}
}
}
}
Reinicia tu cliente. Ahora tienes cinco herramientas de datos financieros disponibles.
Herramientas
| Herramienta | Qué devuelve | Caché |
|---|---|---|
stock_quote(ticker) | Precio, volumen, cambio %, capitalización de mercado | 1 min |
company_fundamentals(ticker) | Ingresos, P/E, sector, beta, rendimiento de dividendos, descripción | 1 h |
economic_indicator(series_id) | Más de 800 000 series FRED (PIB, IPC, tasas, curvas de rendimiento) | 6 h |
sec_filing(ticker, form_type) | Texto completo de 10-K, 10-Q, 8-K de SEC EDGAR | 24 h |
crypto_price(coin_id) | Precio, capitalización de mercado, volumen 24 h, gráfico de 7 días | 1 min |
Ejemplos
Obtener una cotización de acciones
stock_quote(ticker="NVDA")
{
"ticker": "NVDA",
"price": 878.35,
"change": 12.40,
"change_pct": 1.43,
"volume": 41200000,
"market_cap": 2150000000000,
"currency": "USD"
}
Consultar fundamentos de una empresa
company_fundamentals(ticker="AAPL")
{
"ticker": "AAPL",
"name": "Apple Inc.",
"sector": "Technology",
"market_cap": 3280000000000,
"pe_ratio": 33.2,
"revenue": 383285000000,
"beta": 1.24,
"dividend_yield": 0.0044
}
Verificar un indicador económico
economic_indicator(series_id="FEDFUNDS")
{
"series_id": "FEDFUNDS",
"title": "Federal Funds Effective Rate",
"units": "Percent",
"frequency": "Monthly",
"latest_value": 4.33,
"latest_date": "2026-02-01"
}
Series FRED comunes: GDP, CPIAUCSL (inflación), UNRATE (desempleo), DGS10 (bono del Tesoro a 10 años), FEDFUNDS.
Leer una presentación SEC
sec_filing(ticker="AAPL", form_type="10-K")
{
"ticker_or_cik": "AAPL",
"form_type": "10-K",
"filing_date": "2025-11-01",
"document_url": "https://www.sec.gov/Archives/...",
"content": "UNITED STATES SECURITIES AND EXCHANGE COMMISSION..."
}
También acepta ticker_or_cik (heredado) o symbol como alias de ticker.
Precios
$0.01 por llamada. Sin registro, sin claves API, sin tarifas mensuales.
El pago se realiza automáticamente mediante x402, un protocolo de micropagos abierto. Tu cliente MCP firma una transferencia de USDC en la red principal de Base por cada llamada. Necesitas:
- Una clave privada de wallet EVM (configurada como
EVM_PRIVATE_KEY) - Un pequeño saldo de USDC en la red principal de Base (~$1 cubre 100 llamadas)
Eso es todo. Sin cuentas, sin límites de tasa, sin páginas de facturación.
Cómo funciona
El paquete pip install es un servidor MCP stdio ligero. Reenvía tus llamadas de herramientas a un backend alojado, gestionando automáticamente la firma de pagos x402. Los datos provienen de Yahoo Finance, FRED, SEC EDGAR y CoinGecko.
Your AI agent → findata-mcp (local stdio) → Backend (Railway) → Data providers
signs x402 payment verifies payment
Configuración
| Variable | Requerida | Predeterminado | Descripción |
|---|---|---|---|
EVM_PRIVATE_KEY | Sí | — | Clave privada de wallet con USDC en Base |
FINDATA_BACKEND_URL | No | URL de producción | Anulación para backend autoalojado |
Métodos de instalación alternativos
uvx (sin necesidad de instalación):
uvx findata-mcp
Estado de distribución
- PyPI: findata-mcp
- Smithery: en vivo
- Glama: en vivo
- mcp.so: en vivo
Licencia
MIT