Undertow

Undertow MCP | Ferramentas de liquidez de mercado e custo de saída

Endpoint: https://api.seiche.info/undertow/mcp (HTTP transmissível, sem instalação)

Comece com uma pergunta: Abra o workbench de cripto. Escolha um tamanho em dólares e clique para ler as estimativas atuais publicadas por venue, data do snapshot e método. Não é necessária conta, chave, carteira ou instalação de cliente para este exemplo. O resultado é uma estimativa baseada em profundidade, não uma cotação executável. A mesma página fornece configuração para Codex, Claude Code, Cursor e VS Code.

Experimente ao vivo: liquilens-undertow.com/developers · Catálogo de API: api.seiche.info/undertow

Undertow expõe custo estimado de saída por tamanho de posição e venue, a concentração de profundidade cotada, episódios realizados de colapso de profundidade e níveis de liquidez entre segmentos de mercado. Este endpoint MCP 1.11.0 expõe 22 ferramentas somente leitura, divididas em 14 ferramentas públicas e 8 para assinantes, além de 3 prompts guiados. Seu inventário de capacidades está fixado no commit 82d74bad2574d61cf9a602dd2cdf3a9232641669 do liquilens-undertow, a implementação hospedada em deploy/hetzner/undertow-mcp. O servidor de descoberta stdio em undertow_mm/mcp_server.py é uma superfície de descoberta separada; não é este registro de listagem nem o adaptador stdio público fornecido aqui.

O resultado liquidity_tiers inclui contagens de medidas públicas, elegibilidade de replay e o motivo publicado para uma pontuação ser retida. Um nível PARCIAL pode permanecer mesmo quando todas as medidas se qualificam. Históricos de liquidação e recibos de fonte estão disponíveis através do MCP separado de dados-fonte.

Adicionar

Claude Code:

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

Claude.ai / ChatGPT / Cursor: adicione um conector personalizado ou servidor MCP com a URL acima. Sem chave e sem carteira para a superfície gratuita.

O kit inicial gratuito para agentes conecta estimativas de saída da Undertow e concentração de venue com contexto de funding da Seiche e evidências bancárias da LiquiLens. Siga o guia Hermes ou OpenClaw para a configuração compartilhada. Ele usa ferramentas públicas sob limites de uso justo; custos do provedor de modelo permanecem separados.

Este repositório contém o manifesto de descoberta, documentação e um adaptador stdio anônimo opcional para o serviço hospedado. O registro oficial serve io.github.beepboop2025/undertow versão 1.11.0.

Instalação local via stdio e contêiner

A URL hospedada direta acima continua sendo a conexão mais simples. Para clientes que exigem stdio, clone este repositório em um commit revisado e use Python 3.12+ e uv:

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

Uma configuração do Claude Desktop pode usar uv como comando e ["run", "--directory", "/absolute/path/to/undertow-mcp", "--locked", "undertow-mcp"] como argumentos. O adaptador stdio expõe apenas as 14 ferramentas anônimas e três prompts; o acesso de assinante usa a URL hospedada direta.

Para a compilação de contêiner do Docker e do Glama:

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

O Dockerfile raiz executa como usuário sem privilégios e inicia stdio diretamente. Não é necessária chave de API, token bearer, carteira, porta, volume ou configuração de ambiente. É necessário acesso HTTPS de saída ao endpoint fixo api.seiche.info. Redirecionamentos, proxies de ambiente e URLs upstream arbitrárias são desabilitados. As solicitações são limitadas a 64 KiB, as respostas a 2 MiB e cada operação upstream a 10 segundos, incluindo espera na fila. Sem novas tentativas automáticas ou cache de resposta que possam ocultar indisponibilidades ou gastar cota duas vezes. Desvio de versão/catálogo upstream falha de forma fechada. Resultados de ferramentas, valores nativos isError e recusas de direitos são preservados.

Um mantenedor do Glama pode configurar o Dockerfile raiz, concluir seu teste de compilação e publicar uma versão Glama pela página de administração da listagem. Um commit ou release no GitHub não cria uma versão Glama. Este repositório não reivindica uma classificação até que o Glama realmente o reexamine e inspecione. Veja o guia de releases do Glama.

Compatibilidade de protocolo hospedado

• 2026-07-28: solicitações sem estado usam server/discover, _meta por solicitação, MCP-Protocol-Version e cabeçalhos de roteamento espelhados Mcp-Method / Mcp-Name.
• 2025-11-25, 2025-06-18 e 2025-03-26: inicialização legada retida, ferramentas, prompts, notificações, loteamento e comportamento de ping.
• A descoberta identifica todas as quatorze ferramentas públicas e oito para assinantes. Anônimo tools/list retorna apenas o inventário público; a elegibilidade é verificada novamente a cada solicitação de assinante.
• resources/list e resources/templates/list retornam catálogos vazios explícitos. resources/read retorna um erro de não encontrado e nunca inventa um recurso.

Exemplo

No snapshot gerado em 2026-08-08T15:01:22Z, vender $1.000.000 de BTC no degrau de tamanho publicado de $1.000.000 selecionado custou 2,386 bp na Binance e 13,623 bp na Bitfinex: cerca de $238,60 contra $1.362,30. A Gemini foi o venue mais caro observado no mesmo snapshot, com 25,852 bp, ou cerca de $2.585,20.

Os rankings de venues podem mudar durante o dia, e essas diferenças não são visíveis em um preço consolidado único. A Undertow publica o horário de observação e as entradas de venue junto com a estimativa.

Workbench de cripto e habilidades

O workbench de navegador combina comparações publicadas de saída de BTC com cenários de funding e portfólio. Os formulários de cenário são executados localmente no navegador.

O kit de agente de cripto contém três habilidades instaláveis, um cliente Python de biblioteca padrão, calculadoras de cenário offline e um briefing repetível conectando Undertow, Seiche e evidências opcionais de instituições LiquiLens. Digestões exatas de arquivos acompanham o download. Nada é executado ou instalado automaticamente.

Ferramentas

Ferramenta	O que serve	Superfície
agent_access_status	Seu nível atual, medidor diário, concessões e a rota exata para acesso Agente ou Desk	gratuita
board_full	Cada medida com seu percentil de estresse ou rótulo ACCRUING, limites e nota de analista	assinante
corporate_transmission	Se o estresse de funding está alcançando empresas não financeiras	assinante
crypto_exit_check	Compare até quatro tamanhos de venda de BTC solicitados entre degraus publicados, com relógios de observação e lacunas explícitas de desatualização/profundidade; nunca interpole um tamanho solicitado	gratuita
crypto_funding_cost	Calcule funding, taxas de ida e volta e ponto de equilíbrio linear a partir de entradas fornecidas pelo chamador	gratuita
crypto_portfolio_stress	Aplique choques de preço e custos fornecidos pelo chamador a exposições lineares; mostre patrimônio e concentração bruta de ativos/venues	gratuita
depth_episodes	Episódios realizados de colapso de profundidade com início, vale, redução e recuperação, contra limites declarados antes de qualquer episódio acumular	gratuita
divergence_status	Comparação compacta de regimes de transmissão corporativos e domésticos	assinante
exit_cost	Custo de venda por venue em pontos-base no degrau de tamanho publicado mais próximo, venue mais barato e mais caro com custo aproximado em dólares, e o spread entre venues	gratuita
exit_desk_full	BTC e ETH em cada degrau publicado, além do cenário de retirada por falha de venue	assinante
exit_schedule	Cronograma de liquidação hora a hora dimensionado por posição ao lado de linhas de base imediatas e TWAP	assinante
household_credit	Se o estresse de funding está alcançando balanços de famílias	assinante
latest_article	O editorial exato revisado de liquidez de mercado diária com seu relógio de evidência e autoridade de publicação	gratuita
liquidity_tiers	Um nível de liquidez por segmento de mercado (UST, IG, HY, ações, ETF, FX, bacia da China, cripto) com a sobreposição de estresse de funding	gratuita
research_network	Descoberta limitada de pesquisa Palimpsest e Seiche com relógios de fonte, disponibilidade e sem pontuação combinada	gratuita
sealed_record	O registro selado de chamadas futuras, encadeado por hash e assinado antes dos resultados, com erros mantidos	gratuita
tide_clock	Mapa de liquidez por fase de relógio e custo de saída por fase para perpétuos de BTC ou ETH	assinante
trade_safety_exit_context	Contexto de venda BTC/USD em degrau exato com solicitação, PIT, direitos, relógio e verificações de profundidade; entradas indisponíveis permanecem indisponíveis, nunca liberação de ordem	gratuita
unwind_stress	Pacote completo de estresse institucional de desinvestimento e venda forçada	assinante
unwind_watch	Vigilância pública em faixas sobre tempo de desinvestimento institucional e pressão de venda forçada, com quantidades sensíveis exatas retidas	gratuita
venue_concentration	A espinha dorsal de profundidade BTC: participação do principal venue na profundidade agregada, HHI, número efetivo de venues, profundidade por venue em USD	gratuita
venue_price_reconciliation	Uma marca de consenso ponderada por profundidade em repouso sobre meio-spread ao quadrado, mais a lacuna entre o venue mais profundo e o consenso	gratuita

Prompts

Prompt	Manual guiado
can_this_book_exit	Compare largura de porta do livro observado, horizonte de desinvestimento, relógio de margem, concentração de venue e colapsos de profundidade realizados
exit_cost_check	Precifique uma saída dimensionada por posição entre venues e identifique as limitações de profundidade observadas
market_liquidity_briefing	Leia o quadro de liquidez no nível de mercado, a sobreposição de funding, a concentração e as evidências atuais de custo de saída juntos

Futuros de commodities estão intencionalmente ausentes dessa tabela. A Undertow não tem profundidade pontual licenciada por mês de contrato, venue e sessão, então o custo de saída executável de commodities é CANNOT_ASSESS_EXECUTABLE_EXIT_COST; juros abertos ou volume diário nunca são substituídos. Para pressão agregada de caixa WTI/Henry Hub, estrutura de Cushing e benchmark, chame o oil_funding_context público da Seiche ou use /oil em @seiche_desk_bot.

Limitações

• PARCIAL não é calma. Um segmento publicável precisa de medidas qualificadas suficientes e um replay aprovado. A resposta preserva as contagens exatas e o motivo da pontuação retida; medidas qualificadas sozinhas não implicam uma pontuação.
• Custos de saída são estimativas, interpoladas da profundidade de cotação publicada nas faixas de 1% e 2%. Nunca uma caminhada de livro. O snapshot é atualizado aproximadamente a cada hora, então é um snapshot e não um feed em tempo real.
• As medidas de cripto ainda estão acumulando, então o quadro não ganhou um percentil de estresse de cripto e você nunca deve citar um a partir dele.
• O registro selado inclui erros. Chamadas são encadeadas por hash e assinadas antes que seus resultados sejam conhecíveis, depois pontuadas contra o quadro pontual.
• Execução de commodities é uma lacuna de cobertura declarada. Ballast é contexto upstream útil da Seiche, não uma escada de profundidade e não uma estimativa de custo de saída da Undertow.

Pesquisa e dados de mercado, não aconselhamento de investimento.

Nível de assinante

Os níveis Agente e Desk desbloqueiam as oito ferramentas de assinante. Envie /agent ao bot do Telegram para cunhar um token bearer:

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

O token prova apenas identidade. A elegibilidade é relida da assinatura ativa em cada chamada, então o acesso para quando a assinatura para, em vez de quando o token expira. Ferramentas de assinante são invisíveis para um tools/list anônimo, e agent_access_status informa onde você está.

Apenas tools/call é medido, reportado em X-MCP-Usage-Used, X-MCP-Usage-Limit e X-MCP-Usage-Remaining. GET /undertow/mcp/usage é o auto-medidor. Atingir uma cota retorna um resultado JSON-RPC normal carregando isError e um ponteiro de upgrade, nunca uma conexão descartada.

Sobre este repositório

Este repositório é a listagem: um README e os dois manifestos que permitem que diretórios descrevam o servidor com precisão. O servidor em si está hospedado no endpoint acima; sua fonte é deploy/hetzner/undertow-mcp no repositório de produto Undertow e o alvo do registro permanece hospedado 1.11.0. O adaptador encaminha os esquemas e resultados públicos nativos sem computar valores de mercado ou conceder acesso de assinante. Sua própria versão é 0.1.0; o contrato upstream é 1.11.0.

Verificação e limite de implantação

O fluxo de trabalho de verificação valida os exatos 40 caracteres de releaseCommit em contract.json contra o recibo de origem imutável em source-receipt.json. O recibo vincula esse commit e contrato aos digests SHA-256 da implementação hospedada e do manifesto do registro, sem conceder a este repositório público acesso ao repositório privado do produto. Um mantenedor cria ou atualiza o recibo somente após executar o verificador local de núcleo fixado (pinned-core) contra um checkout limpo; esse verificador deriva a divisão público/assinante, o inventário de prompts, as versões de protocolo, a identidade do servidor e o manifesto do registro diretamente da fonte e verifica ambos os digests dos artefatos. Um nome de branch ou o HEAD atual do repositório do produto nunca é aceito como proveniência de release.

Um smoke test separado, agendado e acionável manualmente, faz chamadas anônimas e somente leitura ao endpoint listado. Ele inicializa o protocolo legado, exercita a descoberta moderna, verifica as ferramentas públicas, a divulgação de assinantes, os prompts e os catálogos de recursos vazios explícitos e, em seguida, chama agent_access_status. Ele não usa um token de portador nem exercita uma ferramenta de assinante. Execute as mesmas verificações localmente com:

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

O pin de origem é uma fronteira de contrato revisada, não um recibo de implantação HTTP. O controlador de release do Undertow registra o SHA implantado e recibos somente de acréscimo (append-only) no host, enquanto a resposta pública do MCP atualmente relata sua versão semântica e catálogo de capacidades, mas nenhum commit Git exato. Portanto, um smoke test ao vivo verde prova o comportamento publicado, não que o host execute este SHA exato. Não refixe esta listagem apenas com base em uma versão ou catálogo correspondente; exija primeiro o recibo exato de implantação bem-sucedida do host (ou uma atestação SHA autenticada equivalente).

Irmãos do mesmo laboratório

• Seiche: estresse de financiamento em dólar americano.
• LiquiLens: risco de falência de bancos, NBFCs e credores, e se esse estresse está alcançando empresas e famílias.
• groundcheck: fundamentação de alegações e verificação de citações para texto geral.
• Palimpsest: sinais ao vivo de censura na internet.

Porta de entrada humana: liquilens-undertow.com e o balcão do Telegram.

Licença

O código de integração público original e a documentação neste repositório são licenciados sob MIT. Consulte NOTICE.md para o escopo: esta concessão não cobre o serviço privado Undertow nem dados de mercado de terceiros. Controles de acesso nativos, limitações de evidências e retenções de direitos de fonte ainda se aplicam.