Volumen
Integrates with Coinbase WebSocket to stream live cryptocurrency prices tick by tick, feeding the live dashboard.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Volumen Where is capital flowing right now? Show the liquidity overview"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Volumen
Servidor MCP que analiza hacia dónde se mueve la liquidez de los mercados mundiales, en tiempo casi real.
📊 Dashboard en vivo: https://avcruz2000.github.io/Volumen/ 🕰️ Historial de flujos (desde 1993): https://avcruz2000.github.io/Volumen/historia.html
Volumen mide el flujo de dinero entrando y saliendo de clases de activo, países, sectores y cripto a partir del volumen negociado en USD, y lo combina con la liquidez de los bancos centrales y del ecosistema cripto para responder una pregunta: ¿hacia dónde está yendo el dinero ahora mismo?
Qué analiza
Bloque | Qué mide | Fuente |
Flujos por instrumento | Flujo neto de dinero 5/20 sesiones, Chaikin Money Flow, volumen relativo, momentum → puntuación −100…+100 | Yahoo Finance |
Clases de activo | Acciones EE.UU./desarrollados/emergentes, bonos (corto, largo, IG, HY), oro, plata, petróleo, materias primas, dólar, REITs, Bitcoin | Yahoo Finance |
Países | 30 mercados vía sus ETFs cotizados en EE.UU. (volumen comparable en USD) | Yahoo Finance |
Sectores | 11 sectores del S&P 500 + semiconductores | Yahoo Finance |
Régimen risk-on / risk-off | Flujo en activos de riesgo vs refugio, VIX, crédito (HYG vs IEF), cobre/oro | Calculado |
Liquidez de la Fed | Balance (WALCL) − Cuenta del Tesoro (TGA) − Repos inversos (RRP), M2 | FRED |
Liquidez cripto | Capitalización, dominancia BTC, oferta de stablecoins, miedo y codicia | CoinGecko, DefiLlama, alternative.me |
Macro y divisas | VIX, rendimientos del Tesoro, DXY, EUR, JPY, CNY, MXN, oro, petróleo, cobre | Yahoo Finance |
Análisis técnico | Calificación técnica (medias + osciladores), RSI, volumen relativo intradía de cada instrumento | TradingView |
Volumen inusual | Activos con volumen relativo anómalo ahora mismo (EE.UU., cripto y 24 mercados locales) | TradingView |
Amplitud sectorial | Flujo neto intradía y % al alza por sector, recorriendo todas las acciones de EE.UU. > 10.000 M | TradingView |
En vivo (dashboard) | Precios cripto tick a tick · gráfico interactivo de TradingView | Coinbase WebSocket · TradingView |
Historial
Serie | Desde | Resolución |
Flujos por clase de activo (S&P 500, bonos, oro…) | 1993 | mensual · semanal (10 años) |
Flujos por país (30 ETFs) | 1996 | mensual · semanal (10 años) |
Flujos por sector EE.UU. | 1998 | mensual · semanal (10 años) |
Flujos cripto | 2014 | mensual · semanal |
Régimen riesgo vs refugio | 1998 | mensual |
Liquidez neta de la Fed | 2002 | semanal |
Masa monetaria M2 | 1959 | mensual |
VIX | 1990 | mensual |
Stablecoins | 2017 | semanal |
Miedo y codicia cripto | 2018 | semanal |
La página de historial muestra un mapa de calor de intensidad de flujo (instrumento × periodo), el flujo acumulado de hasta 4 instrumentos (en USD o normalizado), un ranking del periodo elegido, el régimen histórico y el contexto macro. Se recalcula una vez al día en GitHub Actions.
Todas las fuentes son públicas y gratuitas, sin API keys. TradingView se consulta mediante su scanner público (no oficial): puede cambiar sin aviso, por eso Volumen sigue funcionando aunque falle.
Puntuación de flujo
flujo_5d = Σ (posición del cierre en el rango de la vela × precio × volumen) ← "money-flow volume"
modelo_vol = 40% · tanh(flujo_5d / volumen_medio_diario) × √volumen_relativo
+ 30% · tanh(CMF20 × 5)
+ 30% · tanh(cambio_5d / 4%)
puntuación = 85% · modelo_vol + 15% · calificación_técnica_TradingView × 100Además se indica si TradingView confirma la dirección del flujo de volumen o diverge de ella.
Positivo = acumulación (entra liquidez). Negativo = distribución (sale liquidez). Durante la sesión, el volumen del día se proyecta a sesión completa para no infravalorar el flujo intradía.
Related MCP server: Coinversaa Pulse
Arquitectura
┌──────────────────────────────┐
Yahoo · FRED · │ src/core (fuentes + │
CoinGecko · ───▶ │ analítica + snapshot) │
DefiLlama · F&G └──────┬─────────────┬─────────┘
│ │
┌───────────────▼──┐ ┌──────▼───────────────────┐
│ Servidor MCP │ │ GitHub Actions (c/10 min)│
│ stdio o HTTP │ │ → site/data/snapshot.json│
│ (Claude, etc.) │ │ → GitHub Pages │
└──────────────────┘ └──────┬───────────────────┘
│
┌─────────▼─────────────────┐
│ Dashboard público │
│ + Coinbase WS y CoinGecko │
│ en vivo desde el navegador│
└────────────────────────────┘El servidor MCP consulta las fuentes en el momento (con caché de 60 s), así que Claude siempre recibe datos actuales.
El dashboard se publica en GitHub Pages: accesible desde cualquier dispositivo, sin servidores que mantener. Se regenera cada ~10 minutos y además recibe precios cripto en vivo directamente en el navegador.
Tiempo real total: si despliegas el modo HTTP en tu propio servidor, abre el dashboard con
?api=https://tu-servidory leerá/api/snapshoten vez del archivo estático.
Uso como MCP
Requisitos
Node.js 20 o superior.
git clone https://github.com/avcruz2000/Volumen.git
cd Volumen
npm install
npm run buildClaude Code
claude mcp add volumen -- node /ruta/a/Volumen/dist/src/index.jsClaude Desktop
En claude_desktop_config.json:
{
"mcpServers": {
"volumen": {
"command": "node",
"args": ["/ruta/a/Volumen/dist/src/index.js"]
}
}
}Modo HTTP remoto (Streamable HTTP)
PORT=8787 npm run start:http
# MCP: http://localhost:8787/mcp
# Snapshot: http://localhost:8787/api/snapshotSe puede desplegar tal cual en cualquier servicio que ejecute Node (Render, Railway, Fly.io, un VPS…) y conectarlo como conector remoto en Claude.
Herramientas
Herramienta | Descripción |
| Panorama completo: régimen, top entradas/salidas, liquidez Fed y cripto, resumen narrativo |
| Ranking de flujos en |
| Flujo de cualquier símbolo de Yahoo Finance (AAPL, ^N225, EURUSD=X, GC=F, BTC-USD…) |
| Compara y ordena el flujo de varios símbolos |
| Régimen risk-on / risk-off y sus componentes |
| Liquidez neta de la Reserva Federal con historial |
| Capitalización, dominancia, stablecoins, miedo y codicia |
| Calificación técnica, RSI, volumen relativo y rendimiento de cualquier símbolo (SPY, BTC-USD, BMV:WALMEX, TVC:DXY…) |
| Screener de volumen inusual en EE.UU., cripto o mercados locales (México, Brasil, Japón, India…) |
| Historial de flujos (mensual desde 1993 o semanal) de un grupo o de símbolos concretos |
| Qué entró y qué salió en cada mes/semana: cómo ha rotado la liquidez |
| Fed, M2, stablecoins, VIX, miedo y codicia y régimen histórico |
| Flujo neto intradía y amplitud por sector con todas las grandes acciones de EE.UU. |
Recurso: volumen://snapshot · Prompt: informe_liquidez.
Ejemplos de preguntas a Claude:
"¿Hacia dónde se está moviendo la liquidez hoy?"
"¿Qué países están recibiendo más flujo esta semana?"
"Compara el flujo de oro, bonos largos, Nasdaq y Bitcoin."
"¿La Fed está inyectando o drenando liquidez?"
"¿Qué acciones mexicanas tienen volumen inusual hoy?"
"¿TradingView confirma el flujo hacia el oro?"
"¿Cómo ha rotado la liquidez entre sectores en los últimos 12 meses?"
"¿Qué países han acumulado más flujo desde 2010?"
Desarrollo
npm run build # compila TypeScript
npm run snapshot # genera site/data/*.json con datos reales
npm run history # genera site/data/history/*.json (historial completo)
python3 -m http.server 8765 --directory site # ver el dashboard en localPara añadir instrumentos edita src/core/universe.ts.
Aviso
Información con fines educativos. No es asesoramiento financiero. Los datos de Yahoo Finance pueden tener hasta 15 minutos de retraso según el mercado; FRED se actualiza semanalmente.
Licencia
MIT
Available Tools
13 toolsanalyze_instrumentAnalizar flujo de un instrumentoBRead-only
Analiza el flujo de dinero de cualquier símbolo de Yahoo Finance (acciones, ETFs, índices como ^GSPC, divisas como EURUSD=X, futuros como GC=F, cripto como BTC-USD): volumen en USD, volumen relativo, CMF, flujo neto y puntuación.
Inputs: symbol (required).
compare_flowsComparar flujosBRead-only
Compara el flujo de liquidez entre varios símbolos (p.ej. ['GLD','TLT','SPY','BTC-USD']) y los ordena.
Inputs: symbols (required).
get_capital_flowsFlujos de capital por grupoARead-only
Ranking de flujo de liquidez dentro de un grupo: 'asset' (clases de activo), 'region' (países), 'sector' (sectores EE.UU.), 'crypto' o 'macro' (índices y divisas). Ordenado de mayor entrada a mayor salida.
Inputs: group (required).
get_crypto_liquidityLiquidez criptoBRead-only
Capitalización total, volumen y dominancias (CoinGecko), oferta de stablecoins y su variación (DefiLlama), e índice de miedo y codicia (alternative.me).
Inputs: no named parameters.
get_fed_liquidityLiquidez neta de la Reserva FederalBRead-only
Liquidez neta en USD = balance de la Fed (WALCL) − cuenta del Tesoro (TGA) − repos inversos (RRP), en miles de millones, con variaciones a 4, 13 y 52 semanas e historial semanal. Fuente: FRED.
Inputs: weeks.
get_flow_historyHistorial de flujos de liquidezARead-only
Historial de flujo de dinero por periodo (mensual desde 1993 o semanal 10 años) para un grupo ('asset', 'region', 'sector', 'crypto') o para símbolos concretos del universo. Por periodo: rendimiento %, volumen en USD, flujo neto en USD e intensidad (flujo/volumen ×100, comparable en el tiempo). Incluye el flujo acumulado del rango pedido.
Inputs: group (required), periods, symbols, resolution.
get_liquidity_overviewPanorama global de liquidezBRead-only
Resumen completo: régimen de mercado, hacia dónde entra y de dónde sale el dinero (top entradas/salidas), liquidez de la Fed, stablecoins, cripto y un resumen narrativo en español.
Inputs: no named parameters.
get_macro_liquidity_historyHistorial de liquidez macroBRead-only
Series largas de liquidez: liquidez neta de la Fed (semanal desde 2002), balance de la Fed, M2 (mensual desde 1959), stablecoins (desde 2017), miedo y codicia cripto (desde 2018), VIX (desde 1990) y régimen histórico risk-on/off de flujos (desde 1998).
Inputs: step, since.
get_risk_regimeRégimen risk-on / risk-offBRead-only
Determina si el dinero busca riesgo o refugio combinando flujo en activos de riesgo vs refugio, VIX, crédito (HYG vs IEF) y cobre/oro.
Inputs: no named parameters.
get_rotation_historyHistorial de rotación de liquidezBRead-only
Para cada periodo (mes o semana), qué instrumentos de un grupo recibieron más dinero y cuáles perdieron más, por intensidad de flujo. Sirve para ver cómo ha rotado la liquidez entre países, sectores o clases de activo a lo largo del tiempo.
Inputs: group (required), top, periods, resolution.
tradingview_sector_breadthAmplitud y flujo sectorial intradía (TradingView)BRead-only
Recorre todas las acciones de EE.UU. con capitalización > 10.000 M y calcula por sector: % de acciones al alza, valor negociado y flujo neto intradía (valor negociado con el signo del movimiento). Medida bottom-up independiente de los ETFs.
Inputs: min_market_cap.
tradingview_technicalsAnálisis técnico de TradingViewARead-only
Calificación técnica de TradingView (−1 venta fuerte … +1 compra fuerte; medias móviles y osciladores), RSI, volumen relativo 10d, valor negociado y rendimiento semanal/mensual. Acepta símbolos de EE.UU. (SPY, AAPL), de Yahoo (BTC-USD, ^VIX, EURUSD=X, GC=F) o de TradingView con bolsa (BMV:WALMEX, BINANCE:SOLUSDT, TVC:DXY).
Inputs: symbols (required).
tradingview_unusual_volumeVolumen inusual (TradingView)ARead-only
Screener de TradingView: activos con el volumen relativo más alto ahora mismo y liquidez suficiente — dónde está entrando dinero nuevo. Mercados: america, crypto, mexico, brazil, argentina, chile, colombia, peru, uk, germany, france, spain, japan, china, hongkong, india, korea, taiwan, canada, australia, etc.
Inputs: limit, market, min_value_traded.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 13 tools
Hay solapamiento considerable entre varias herramientas de liquidez/flujo: get_liquidity_overview, get_flow_history, get_capital_flows, analyze_instrument y compare_flows giran todas en torno al flujo de dinero y pueden confundirse, aunque las descripciones matizan el alcance (resumen, histórico, ranking, instrumento individual, comparación). Las tres herramientas tradingview_* y las de la Fed son más distinguibles, pero el conjunto no es nítido.
La mayoría sigue un patrón consistente verbo_sustantivo (get_liquidity_overview, get_flow_history, get_capital_flows, analyze_instrument, compare_flows, get_fed_liquidity), pero tradingview_technicals, tradingview_unusual_volume y tradingview_sector_breadth rompen el patrón usando el prefijo del proveedor con sustantivos en lugar de verbos. Aun así es legible y predecible en gran medida.
13 herramientas para un servidor de análisis de liquidez y flujos es un rango bien dimensionado; cada herramienta cubre una faceta concreta (resumen, histórico, ranking, instrumento, comparación, riesgo, Fed, cripto, técnicos, volumen inusual, amplitud sectorial, rotación, macro).
La cobertura del dominio es amplia: overview, histórico, rankings, análisis por instrumento, comparación, régimen de riesgo, liquidez Fed/cripto, técnicas, volumen inusual, amplitud sectorial, rotación e historia macro. Faltan quizá operaciones de alertas/suscripción o exportación, pero el núcleo analítico está bien cubierto sin callejones sin salida evidentes.
Maintenance
Related MCP Connectors
Live macro data for AI agents: regime, conditions, liquidity, with input provenance. No signup.
Live crypto market data: prices, funding, OI, liquidations, regimes, GEX, whales, sentiment, macro.
Market intelligence for AI agents. Real-time data, cross-market analysis, and regime detection.
Live crypto technical analysis for agents: 200+ causal indicators, signals and liquidity sweeps.
Related MCP Servers
- AlicenseAqualityCmaintenanceConnects AI agents to real-time crypto market data, covering market health scores, derivatives, ETF flows, and BTC cycle indicators. It provides 13 specialized tools for structured market analysis, sentiment tracking, and monitoring macro-economic indicators.1313 npm1MIT

Coinversaa Pulseofficial
AlicenseAqualityBmaintenanceProvides comprehensive crypto intelligence for the Hyperliquid exchange, allowing users to query trader profiles, behavioral cohorts, and live market data. It enables AI agents to analyze over 1.8 billion trades, track whale positions, and access real-time liquidation heatmaps.10665 npm10MIT
oneqaz-trading-mcpofficial
AlicenseNot gradedqualityBmaintenanceProvides AI agents with real-time financial market intelligence including regime detection, adaptive signals, macro context chains, and cross-market analysis for crypto, US, and Korean stocks.MIT
CoinLobster MCPofficial
AlicenseAqualityBmaintenanceProvides real-time crypto whale trade data and market analysis to AI agents, including unusual flow radar, liquidations, funding rates, and market snapshots across 15 exchanges and on-chain DEXs.1755 npm13MIT