Skip to main content
Glama

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 × 100

Ademá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-servidor y leerá /api/snapshot en 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 build

Claude Code

claude mcp add volumen -- node /ruta/a/Volumen/dist/src/index.js

Claude 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/snapshot

Se 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

get_liquidity_overview

Panorama completo: régimen, top entradas/salidas, liquidez Fed y cripto, resumen narrativo

get_capital_flows

Ranking de flujos en asset, region, sector, crypto o macro

analyze_instrument

Flujo de cualquier símbolo de Yahoo Finance (AAPL, ^N225, EURUSD=X, GC=F, BTC-USD…)

compare_flows

Compara y ordena el flujo de varios símbolos

get_risk_regime

Régimen risk-on / risk-off y sus componentes

get_fed_liquidity

Liquidez neta de la Reserva Federal con historial

get_crypto_liquidity

Capitalización, dominancia, stablecoins, miedo y codicia

tradingview_technicals

Calificación técnica, RSI, volumen relativo y rendimiento de cualquier símbolo (SPY, BTC-USD, BMV:WALMEX, TVC:DXY…)

tradingview_unusual_volume

Screener de volumen inusual en EE.UU., cripto o mercados locales (México, Brasil, Japón, India…)

get_flow_history

Historial de flujos (mensual desde 1993 o semanal) de un grupo o de símbolos concretos

get_rotation_history

Qué entró y qué salió en cada mes/semana: cómo ha rotado la liquidez

get_macro_liquidity_history

Fed, M2, stablecoins, VIX, miedo y codicia y régimen histórico

tradingview_sector_breadth

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 local

Para 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 tools
analyze_instrumentAnalizar flujo de un instrumentoB
Read-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 flujosB
Read-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 grupoA
Read-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 criptoB
Read-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 FederalB
Read-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 liquidezA
Read-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 liquidezB
Read-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 macroB
Read-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-offB
Read-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 liquidezB
Read-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)B
Read-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 TradingViewA
Read-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)A
Read-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

    A3.5/5.0

    Scored across 13 tools

    Disambiguation3/5

    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.

    Naming Consistency4/5

    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.

    Tool Count5/5

    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).

    Completeness4/5

    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

    ActivityMaintained
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      C
      maintenance
      Connects 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.
      13
      13 npm
      1
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Provides 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.
      106
      65 npm
      10
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Provides 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
    • A
      license
      A
      quality
      B
      maintenance
      Provides 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.
      17
      55 npm
      13
      MIT