Undertow

Undertow MCP | Herramientas de liquidez de mercado y costos de salida

Endpoint: https://api.seiche.info/undertow/mcp (HTTP transmisible, sin instalación)

Comience con una pregunta: Abra el workbench de criptomonedas. Elija un tamaño en dólares y haga clic para leer las estimaciones actuales publicadas de los venues, la fecha de la instantánea y el método. No se necesita cuenta, clave, wallet ni instalación de cliente para este ejemplo. El resultado es una estimación basada en profundidad, no una cotización ejecutable. La misma página proporciona configuración para Codex, Claude Code, Cursor y VS Code.

Pruébelo en vivo: liquilens-undertow.com/developers · Catálogo de API: api.seiche.info/undertow

Undertow expone el costo de salida estimado por tamaño de posición y venue, la concentración de profundidad cotizada, episodios realizados de colapso de profundidad y niveles de liquidez en segmentos de mercado. Este endpoint MCP 1.11.0 expone 22 herramientas de solo lectura, divididas en 14 herramientas públicas y 8 para suscriptores, además de 3 indicaciones guiadas. Su inventario de capacidades está fijado al commit 82d74bad2574d61cf9a602dd2cdf3a9232641669 de liquilens-undertow, la implementación alojada en deploy/hetzner/undertow-mcp. El servidor de descubrimiento stdio en undertow_mm/mcp_server.py es una superficie de descubrimiento separada; no es ni este listado de registro ni el adaptador stdio público proporcionado aquí.

El resultado de liquidity_tiers incluye conteos de medidas públicas, elegibilidad de reproducción y la razón publicada por la cual se retiene una puntuación. Un nivel PARCIAL puede permanecer incluso cuando cada medida califica. Historiales de liquidación y recibos de fuentes están disponibles a través del MCP de datos fuente separado.

Agregarlo

Claude Code:

claude mcp add --transport http undertow https://api.seiche.info/undertow/mcp

Claude.ai / ChatGPT / Cursor: agregue un conector personalizado o servidor MCP con la URL anterior. Sin clave y sin wallet para la superficie gratuita.

El kit de inicio gratuito para agentes conecta las estimaciones de salida de Undertow y la concentración de venues con el contexto de financiamiento de Seiche y la evidencia bancaria de LiquiLens. Siga la guía de Hermes o OpenClaw para la configuración compartida. Utiliza herramientas públicas bajo límites de uso justo; los costos del proveedor de modelos permanecen separados.

Este repositorio contiene el manifiesto de descubrimiento, la documentación y un adaptador stdio anónimo opcional para el servicio alojado. El registro oficial sirve io.github.beepboop2025/undertow versión 1.11.0.

Instalación local stdio y en contenedor

La URL alojada directa anterior sigue siendo la conexión más simple. Para clientes que requieren stdio, clone este repositorio en un commit revisado y use Python 3.12+ y uv:

uv sync --locked
uv run --locked undertow-mcp

Una configuración de Claude Desktop puede usar uv como su comando y ["run", "--directory", "/absolute/path/to/undertow-mcp", "--locked", "undertow-mcp"] como sus argumentos. El adaptador stdio expone solo las 14 herramientas anónimas y tres indicaciones; el acceso para suscriptores usa la URL alojada directa en su lugar.

Para la compilación del contenedor de Docker y Glama:

docker build -t undertow-mcp .
docker run --rm -i undertow-mcp

El Dockerfile raíz se ejecuta como un usuario sin privilegios e inicia stdio directamente. No se necesita clave de API, token de portador, wallet, puerto, volumen ni configuración de entorno. Se requiere acceso HTTPS saliente al endpoint fijo api.seiche.info. Las redirecciones, los proxies de entorno y las URL ascendentes arbitrarias están deshabilitados. Las solicitudes están limitadas a 64 KiB, las respuestas a 2 MiB y cada operación ascendente a 10 segundos incluida la espera en cola. Sin reintentos automáticos ni caché de respuestas que puedan ocultar interrupciones o gastar una cuota dos veces. La desviación de versión/catálogo ascendente falla de forma cerrada. Los resultados de herramientas, los valores nativos de isError y las denegaciones de derechos se conservan.

Un mantenedor de Glama puede configurar el Dockerfile raíz, completar su prueba de compilación y publicar una versión de Glama desde la página de administración del listado. Un commit o versión de GitHub no crea una versión de Glama. Este repositorio no reclama una calificación hasta que Glama realmente lo haya vuelto a escanear e inspeccionado. Consulte la guía de versiones de Glama.

Compatibilidad de protocolo alojado

• 2026-07-28: las solicitudes sin estado usan server/discover, _meta por solicitud, MCP-Protocol-Version y encabezados de enrutamiento reflejados Mcp-Method / Mcp-Name.
• 2025-11-25, 2025-06-18 y 2025-03-26: inicialización heredada retenida, herramientas, indicaciones, notificaciones, procesamiento por lotes y comportamiento de ping.
• El descubrimiento identifica las catorce herramientas públicas y las ocho de suscriptores. Anónimo tools/list devuelve solo el inventario público; la elegibilidad se verifica nuevamente en cada solicitud de suscriptor.
• resources/list y resources/templates/list devuelven catálogos vacíos explícitos. resources/read devuelve un error de no encontrado y nunca inventa un recurso.

Ejemplo

En la instantánea generada a las 2026-08-08T15:01:22Z, vender $1,000,000 de BTC en el peldaño de tamaño publicado de $1,000,000 seleccionado costó 2.386 pb en Binance y 13.623 pb en Bitfinex: aproximadamente $238.60 frente a $1,362.30. Gemini fue el venue observado más caro en esa misma instantánea con 25.852 pb, o aproximadamente $2,585.20.

Las clasificaciones de venues pueden cambiar durante el día, y esas diferencias no son visibles en un solo precio consolidado. Undertow publica la hora de observación y las entradas de venues con la estimación.

Workbench de criptomonedas y habilidades

El workbench de navegador combina comparaciones de salida de BTC publicadas con escenarios de financiamiento y cartera. Los formularios de escenarios se ejecutan localmente en el navegador.

El kit de agente de criptomonedas contiene tres habilidades instalables, un cliente Python de biblioteca estándar, calculadoras de escenarios sin conexión y un informe repetible que conecta Undertow, Seiche y evidencia institucional opcional de LiquiLens. Resúmenes de archivos exactos acompañan la descarga. Nada se ejecuta o instala automáticamente.

Herramientas

Herramienta	Qué sirve	Superficie
agent_access_status	Su nivel actual, medidor diario, concesiones y la ruta exacta al acceso de Agente o Escritorio	gratuita
board_full	Cada medida con su percentil de estrés o etiqueta ACRECENTANDO, límites y nota de analista	suscriptor
corporate_transmission	Si el estrés de financiamiento está llegando a empresas no financieras	suscriptor
crypto_exit_check	Compare hasta cuatro tamaños de venta de BTC solicitados en peldaños publicados, con relojes de observación y brechas explícitas de desactualización/profundidad; nunca interpole un tamaño solicitado	gratuita
crypto_funding_cost	Calcule financiamiento, tarifas de ida y vuelta y punto de equilibrio lineal a partir de entradas proporcionadas por el llamador	gratuita
crypto_portfolio_stress	Aplique choques de precios y costos proporcionados por el llamador a exposiciones lineales; muestre capital y concentración bruta de activos/venues	gratuita
depth_episodes	Episodios realizados de colapso de profundidad con inicio, valle, reducción y recuperación, contra umbrales declarados antes de que cualquier episodio se acumulara	gratuita
divergence_status	Comparación compacta de regímenes de transmisión corporativos y de hogares	suscriptor
exit_cost	Costo de venta por venue en puntos básicos en el peldaño de tamaño publicado más cercano, venue más barato y más caro con costo aproximado en dólares, y el diferencial de venues	gratuita
exit_desk_full	BTC y ETH en cada peldaño publicado, más el escenario de retiro por falla de venue	suscriptor
exit_schedule	Cronograma de liquidación por hora según el tamaño de posición junto a líneas base inmediatas y TWAP	suscriptor
household_credit	Si el estrés de financiamiento está llegando a los balances de los hogares	suscriptor
latest_article	El editorial exacto revisado de liquidez de mercado diaria con su reloj de evidencia y autoridad de publicación	gratuita
liquidity_tiers	Un nivel de liquidez por segmento de mercado (UST, IG, HY, acciones, ETF, FX, cuenca de China, cripto) con la superposición de estrés de financiamiento	gratuita
research_network	Descubrimiento de investigación acotado de Palimpsest y Seiche con relojes de fuente, disponibilidad y sin puntuación combinada	gratuita
sealed_record	El registro sellado de llamadas a futuro, encadenado por hash y firmado antes de los resultados, con fallos conservados	gratuita
tide_clock	Mapa de liquidez por fase de reloj y costo de salida por fase para perpetuos de BTC o ETH	suscriptor
trade_safety_exit_context	Contexto de venta de BTC/USD en peldaño exacto con solicitud, PIT, derechos, reloj y verificaciones de profundidad; las entradas no disponibles permanecen no disponibles, nunca autorización de orden	gratuita
unwind_stress	Paquete completo de estrés de desinversión institucional y venta forzada	suscriptor
unwind_watch	Vigilancia pública por bandas sobre el tiempo de desinversión institucional y la presión de venta forzada, con cantidades sensibles exactas retenidas	gratuita
venue_concentration	La columna vertebral de profundidad de BTC: participación del venue principal en la profundidad agregada, HHI, número efectivo de venues, profundidad por venue en USD	gratuita
venue_price_reconciliation	Una marca de consenso ponderada por profundidad en reposo sobre el semi-diferencial al cuadrado, más la brecha entre el venue más profundo y el consenso	gratuita

Indicaciones

Indicación	Libro de jugadas guiado
can_this_book_exit	Compare el ancho de puerta del libro vigilado, el horizonte de desinversión, el reloj de margen, la concentración de venues y los colapsos de profundidad realizados
exit_cost_check	Cotice una salida del tamaño de la posición en todos los venues e identifique las limitaciones de profundidad observadas
market_liquidity_briefing	Lea el tablero de liquidez a nivel de mercado, la superposición de financiamiento, la concentración y la evidencia actual de costo de salida juntos

Los futuros de materias primas están intencionalmente ausentes de esa tabla. Undertow no tiene profundidad puntual con licencia por mes de contrato, venue y sesión, por lo que el costo de salida ejecutable de materias primas es CANNOT_ASSESS_EXECUTABLE_EXIT_COST; el interés abierto o el volumen diario nunca se sustituyen. Para la presión agregada de efectivo de WTI/Henry Hub, la estructura de Cushing y el punto de referencia, llame al oil_funding_context público de Seiche o use /oil en @seiche_desk_bot.

Limitaciones

• PARCIAL no es calma. Un segmento publicable necesita suficientes medidas que califiquen y una reproducción que pase. La respuesta conserva los conteos exactos y la razón de puntuación retenida; las medidas que califican por sí solas no implican una puntuación.
• Los costos de salida son estimaciones, interpoladas de la profundidad de cotización publicada en las bandas del 1% y 2%. Nunca una caminata por el libro. La instantánea se actualiza aproximadamente cada hora, por lo que es una instantánea y no un feed en tiempo real.
• Las medidas de criptomonedas aún se están acumulando, por lo que el tablero no ha ganado un percentil de estrés de criptomonedas y nunca debe citar uno de él.
• El registro sellado incluye fallos. Las llamadas están encadenadas por hash y firmadas antes de que sus resultados sean conocibles, luego se puntúan contra el tablero puntual.
• La ejecución de materias primas es una brecha de cobertura declarada. Ballast es contexto ascendente útil de Seiche, no una escalera de profundidad y no una estimación de costo de salida de Undertow.

Investigación y datos de mercado, no asesoramiento de inversión.

Nivel de suscriptor

Los niveles Agente y Escritorio desbloquean las ocho herramientas de suscriptor. Envíe /agent al bot de Telegram para acuñar un token de portador:

{
  "mcpServers": {
    "undertow": {
      "url": "https://api.seiche.info/undertow/mcp",
      "headers": { "Authorization": "Bearer YOUR_TOKEN" }
    }
  }
}

El token prueba solo identidad. La elegibilidad se vuelve a leer de la membresía en vivo en cada llamada, por lo que el acceso se detiene cuando la suscripción lo hace, no cuando el token expira. Las herramientas de suscriptor son invisibles para un tools/list anónimo, y agent_access_status le dice dónde está parado.

Solo tools/call se mide, se informa en X-MCP-Usage-Used, X-MCP-Usage-Limit y X-MCP-Usage-Remaining. GET /undertow/mcp/usage es el auto-medidor. Alcanzar una cuota devuelve un resultado JSON-RPC normal que lleva isError y un puntero de actualización, nunca una conexión caída.

Acerca de este repositorio

Este repositorio es el listado: un README y los dos manifiestos que permiten a los directorios describir el servidor con precisión. El servidor en sí está alojado en el endpoint anterior; su fuente es deploy/hetzner/undertow-mcp en el repositorio de productos Undertow y el objetivo del registro sigue siendo 1.11.0 alojado. El adaptador reenvía los esquemas y resultados públicos nativos sin calcular valores de mercado ni otorgar acceso de suscriptor. Su propia versión es 0.1.0; el contrato ascendente es 1.11.0.

Verificación y límite de implementación

El flujo de verificación valida el releaseCommit exacto de 40 caracteres en contract.json contra el recibo de origen inmutable en source-receipt.json. El recibo vincula ese commit y contrato con los resúmenes SHA-256 de la implementación alojada y el manifiesto del registro, sin otorgar a este repositorio público acceso al repositorio privado del producto. Un mantenedor crea o actualiza el recibo solo después de ejecutar el verificador local de núcleo fijo contra un checkout limpio; ese verificador deriva la división público/suscriptor, el inventario de prompts, las versiones de protocolo, la identidad del servidor y el manifiesto del registro directamente desde el código fuente y comprueba ambos resúmenes de artefactos. Un nombre de rama o el HEAD actual del repositorio del producto nunca se acepta como procedencia de la versión.

Un smoke separado, programado y despachable manualmente, realiza llamadas anónimas de solo lectura al endpoint listado. Inicializa el protocolo heredado, ejercita el descubrimiento moderno, comprueba las herramientas públicas, la publicidad de suscriptores, los prompts y los catálogos de recursos vacíos explícitos, y luego llama a agent_access_status. No utiliza un token de portador ni ejercita una herramienta de suscriptor. Ejecuta las mismas comprobaciones localmente con:

uv run --locked python -m unittest discover -s tests -v
python3 scripts/verify_core_pin.py --receipt
python3 scripts/verify_core_pin.py --core /path/to/exact/core/checkout
python3 scripts/smoke_live_mcp.py

El pin de origen es un límite de contrato revisado, no un recibo de despliegue HTTP. El controlador de versiones de Undertow registra el SHA desplegado y los recibos de solo anexión en el host, mientras que la respuesta pública de MCP actualmente informa su versión semántica y catálogo de capacidades, pero no un commit de Git exacto. Por lo tanto, un smoke en vivo verde prueba el comportamiento publicado, no que el host ejecute este SHA exacto. No vuelvas a fijar este listado solo por una versión o catálogo coincidentes; exige primero el recibo de despliegue exitoso exacto del host (o una atestación SHA autenticada equivalente).

Proyectos hermanos del mismo laboratorio

• Seiche: estrés de financiación en dólares estadounidenses.
• LiquiLens: riesgo de quiebra de bancos, NBFC y prestamistas, y si ese estrés está llegando a empresas y hogares.
• groundcheck: verificación de fundamentos y citas para texto general.
• Palimpsest: señales en vivo de censura en internet.

Puerta de entrada humana: liquilens-undertow.com y el escritorio de Telegram.

Licencia

El código de integración público original y la documentación en este repositorio están licenciados bajo MIT. Consulta NOTICE.md para el alcance: esta concesión no cubre el servicio privado de Undertow ni los datos de mercado de terceros. Los controles de acceso nativos, las limitaciones de evidencia y las retenciones de derechos de origen siguen aplicándose.