undertow-mcp

# Undertow MCP | Market liquidity and exit-cost tools

**Endpoint:** `https://api.seiche.info/undertow/mcp` (streamable HTTP, no install)

**Start with a question:** [Open the crypto workbench](https://liquilens-undertow.com/crypto/).
Choose a dollar size and click to read the current published venue estimates,
snapshot date and method. No account, key, wallet or client installation is
needed for this example. The result is a depth-based estimate, not an executable
quote. The same page provides Codex, Claude Code, Cursor and VS Code setup.

**Try it live:** [liquilens-undertow.com/developers](https://liquilens-undertow.com/developers/) ·
**API catalog:** [api.seiche.info/undertow](https://api.seiche.info/undertow/)

Undertow exposes estimated exit cost by position size and venue, the concentration of
quoted depth, realized depth-collapse episodes, and liquidity tiers across market segments.
This MCP 1.11.0 endpoint exposes 22 read-only tools, split into 14 public and 8 subscriber
tools, plus 3 guided prompts. Its capability inventory is pinned to liquilens-undertow
commit `82d74bad2574d61cf9a602dd2cdf3a9232641669`, the hosted implementation at
`deploy/hetzner/undertow-mcp`. The stdio discovery server in
`undertow_mm/mcp_server.py` is a separate discovery surface; it is neither
this registry listing nor the public stdio adapter provided here.

The `liquidity_tiers` result includes public measure counts, replay eligibility and the published reason a score is withheld. A PARTIAL tier can remain even when every measure qualifies. [Settlement histories and source receipts](https://liquilens.in/agents/#source-data) are available through the separate source-data MCP.

## Add it

Claude Code:

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

Claude.ai / ChatGPT / Cursor: add a custom connector or MCP server with the URL above.
No key and no wallet for the free surface.

The [free agent starter kit](https://liquilens.in/agents/) connects Undertow exit
estimates and venue concentration with Seiche funding context and LiquiLens bank
evidence. Follow the [Hermes](https://liquilens.in/agents/hermes/) or
[OpenClaw](https://liquilens.in/agents/openclaw/) guide for the shared setup. It uses
public tools under fair-use limits; model-provider costs remain separate.

This repository contains the discovery manifest, documentation and an optional
anonymous stdio adapter for the hosted service. The official registry serves
[`io.github.beepboop2025/undertow` version 1.11.0](https://registry.modelcontextprotocol.io/v0.1/servers/io.github.beepboop2025%2Fundertow/versions/latest).

## Local stdio and container installation

The direct hosted URL above remains the simplest connection. For clients that
require stdio, clone this repository at a reviewed commit and use Python 3.12+
and [uv](https://docs.astral.sh/uv/):

```sh
uv sync --locked
uv run --locked undertow-mcp
```

A Claude Desktop configuration can use `uv` as its command and
`["run", "--directory", "/absolute/path/to/undertow-mcp", "--locked", "undertow-mcp"]`
as its arguments. The stdio adapter exposes only the 14 anonymous tools and
three prompts; subscriber access uses the direct hosted URL instead.

For Docker and Glama's container build:

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

The root Dockerfile runs as an unprivileged user and starts stdio directly.
No API key, bearer token, wallet, port, volume or environment setting is needed.
Outbound HTTPS access to the fixed `api.seiche.info` endpoint is required.
Redirects, environment proxies and arbitrary upstream URLs are disabled.
Requests are capped at 64 KiB, responses at 2 MiB, and each upstream operation
at 10 seconds including queue wait. No automatic retries or response cache can
hide outages or spend a quota twice. Upstream version/catalog drift fails closed.
Tool results, native `isError` values and rights refusals are preserved.

A Glama maintainer can configure the root Dockerfile, complete its build test,
and publish a Glama release from the listing's admin page. A GitHub commit or
release does not create a Glama release. This repository does not claim a grade
until Glama has actually rescanned and inspected it. See
[Glama's release guide](https://glama.ai/blog/2026-03-15-how-to-make-a-release).

## Hosted protocol compatibility

- `2026-07-28`: stateless requests use `server/discover`, per-request `_meta`,
  `MCP-Protocol-Version`, and mirrored `Mcp-Method` / `Mcp-Name` routing headers.
- `2025-11-25`, `2025-06-18`, and `2025-03-26`: retained legacy initialization,
  tools, prompts, notifications, batching, and ping behavior.
- Discovery identifies all fourteen public and eight subscriber tools. Anonymous
  `tools/list` returns only the public inventory; entitlement is checked fresh on every
  subscriber request.
- `resources/list` and `resources/templates/list` return explicit empty catalogs.
  `resources/read` returns a not-found error and never invents a resource.

## Example

In the snapshot generated at **2026-08-08T15:01:22Z**, selling $1,000,000 of BTC
at the selected **$1,000,000 published size rung** cost **2.386 bp on Binance and
13.623 bp on Bitfinex**: about $238.60 against $1,362.30. Gemini was the dearest
observed venue in that same snapshot at 25.852 bp, or about $2,585.20.

Venue rankings can change during the day, and those differences are not visible in a
single consolidated price. Undertow publishes the observation time and venue inputs with
the estimate.

## Crypto workbench and skills

The [browser workbench](https://liquilens-undertow.com/crypto/) combines published BTC exit comparisons with funding and portfolio scenarios. The scenario forms run locally in the browser.

The [crypto agent kit](https://liquilens-undertow.com/crypto/undertow-crypto-kit.zip) contains three installable skills, a standard-library Python client, offline scenario calculators and a repeatable brief connecting Undertow, Seiche and optional LiquiLens institution evidence. [Exact file digests](https://liquilens-undertow.com/crypto/kit-manifest.json) accompany the download. Nothing runs or installs automatically.

## Tools

| Tool | What it serves | Surface |
|---|---|---|
| `agent_access_status` | Your current tier, daily meter, grants, and the exact route to Agent or Desk access | free |
| `board_full` | Every measure with its stress percentile or ACCRUING label, limits and analyst note | subscriber |
| `corporate_transmission` | Whether funding stress is reaching nonfinancial firms | subscriber |
| `crypto_exit_check` | Compare up to four requested BTC sell sizes across published rungs, with observation clocks and explicit stale/depth gaps; never interpolate a requested size | free |
| `crypto_funding_cost` | Calculate funding, round-trip fees and linear break-even from caller-supplied inputs | free |
| `crypto_portfolio_stress` | Apply caller-supplied price shocks and costs to linear exposures; show equity and gross asset/venue concentration | free |
| `depth_episodes` | Realized depth-collapse episodes with onset, trough, drawdown and recovery, against thresholds declared before any episode accrued | free |
| `divergence_status` | Compact comparison of corporate and household transmission regimes | subscriber |
| `exit_cost` | Per-venue sell cost in basis points at the nearest published size rung, cheapest and dearest venue with approximate dollar cost, and the venue spread | free |
| `exit_desk_full` | BTC and ETH at every published rung, plus the venue-failure withdrawal scenario | subscriber |
| `exit_schedule` | Position-sized hour-by-hour liquidation schedule beside immediate and TWAP baselines | subscriber |
| `household_credit` | Whether funding stress is reaching household balance sheets | subscriber |
| `latest_article` | The exact reviewed daily market-liquidity editorial with its evidence clock and publication authority | free |
| `liquidity_tiers` | A liquidity tier per market segment (UST, IG, HY, equities, ETF, FX, China basin, crypto) with the funding-stress overlay | free |
| `research_network` | Bounded Palimpsest and Seiche research discovery with source clocks, availability and no blended score | free |
| `sealed_record` | The sealed forward-calls record, hash-chained and signed before outcomes, misses kept | free |
| `tide_clock` | Clock-phase liquidity map and exit-cost-by-phase for BTC or ETH perpetuals | subscriber |
| `trade_safety_exit_context` | Exact-rung BTC/USD sell context with request, PIT, rights, clock and depth checks; unavailable inputs remain unavailable, never order clearance | free |
| `unwind_stress` | Full institutional unwind and forced-sale stress pack | subscriber |
| `unwind_watch` | Banded public watch over institutional unwind time and forced-sale pressure, with exact sensitive quantities withheld | free |
| `venue_concentration` | The BTC depth backbone: top venue share of aggregate depth, HHI, effective venue count, per-venue depth in USD | free |
| `venue_price_reconciliation` | A consensus mark weighted by resting depth over squared half-spread, plus the gap between the deepest venue and consensus | free |

## Prompts

| Prompt | Guided playbook |
|---|---|
| `can_this_book_exit` | Compare watched-book door width, unwind horizon, margin clock, venue concentration, and realized depth collapses |
| `exit_cost_check` | Price a position-sized exit across venues and identify the observed depth limitations |
| `market_liquidity_briefing` | Read the market-level liquidity board, funding overlay, concentration, and current exit-cost evidence together |

Commodity futures are intentionally absent from that table. Undertow has no
licensed point-in-time depth by contract month, venue and session, so
executable commodity exit cost is `CANNOT_ASSESS_EXECUTABLE_EXIT_COST`; open
interest or daily volume is never substituted. For aggregate WTI/Henry Hub
cash pressure, Cushing and benchmark structure, call Seiche's