# Undertow — market liquidity map [Verified owner] [Health: Active]

**Category:** 💰 Finance & Fintech  
**Repository:** https://github.com/beepboop2025/undertow-mcp  
**GitHub Stars:** 0  
**Views:** 6  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/undertow-market-liquidity-map-2

## Description
Review market depth and hypothetical BTC exit costs before an agent makes a decision. Undertow 1.13.0 exposes 16 public read-only MCP tools for liquidity surfaces, order-book evidence, venue comparisons and stated-size exit research. Public hosted calls need no API key; subscriber routes have separate access terms. Retain source dates, venue and size assumptions, coverage gaps and rights in every answer. Estimates are research evidence, not executable quotes or trade clearance; these tools do not submit orders. Connect and try a first task: https://liquilens-undertow.com/

## Tools
Capabilities this server exposes over MCP:

- **agent_access_status** — Identity, entitlement, daily usage, access instructions; missing/refused subscriber tools.
- **crypto_exit_check** — Four BTC sell sizes by rung/bracket. Withholds stale/future, uncovered or unconverted venues. Fees excluded; no trade clearance.
- **crypto_funding_cost** — Input perpetual funding/fees, net carry, linear break-even. Positive funding: longs pay shorts. Constant-rate scenario, not forecast.
- **crypto_portfolio_stress** — Linear input shocks, 20 exposures: P&L/equity, asset/venue concentration. Symbols label scenarios. No liquidation/probability model.
- **depth_episodes** — BTC depth-collapse onset/trough/recovery under preregistered rules. Zero differs from missing. Subscriber exit_desk_full: ETH.
- **exit_cost** — BTC nearest-rung sell estimates; interpolated bid-depth bands. Fees excluded; not executable. Sizes/freshness: crypto_exit_check.
- **gold_cash_realisation** — Gold sale/cash gates from inputs: decimal kg, fineness (0,1], USD/troy-oz bid, USD fees, currency/USD FX (USD=1), aware ISO clocks. Arithmetic and withheld-cash reasons only; no fetch, storage, execution or verified balance.
- **latest_article** — Latest published editorial: title/full text/URL/clock/quality receipt. No args or generated prose. Missing text/failed receipt errors. Board: liquidity_tiers.
- **liquidity_tiers** — Nine segment tiers, Seiche funding, measure counts, replay/withholding reasons. PARTIAL: missing history/unpassed replay, never calm.
- **market_corpus_context** — Corpus coverage/rights/clocks. No summary pagination; other views: records/total/next_offset. Retrieval age is not observation freshness. Readings: liquidity_tiers.
- **research_network** — Cross-product metadata, clocks, rights, next steps. Follow next_offset. Unavailable: retrieval/contract/size failure. Local counts: market_corpus_context. No shared score or authority.
- **sealed_record** — Calls sealed/signed before outcomes: hits/misses, decided counts, ledger root. Report hits and misses together.
- **trade_safety_exit_context** — Exact-rung BTC/USD observe/paper: request hash, PIT source/rights, conversion, bid bands, six venue clocks, startup SHA. No live mode/clearance.
- **unwind_watch** — Watched-filer headlines: effective positions, days-to-exit brackets, blind spots. No live execution model. Full grids: unwind_stress.
- **venue_concentration** — BTC two-sided depth: HHI, effective/top venue, venue depth. Subscriber exit_desk_full: ETH and venue failure.
- **venue_price_reconciliation** — BTC/ETH consensus: depth/squared-half-spread weights, deepest-venue blindness, concentration, dislocations. Experimental; no execution authority.

## Claude Desktop Quick Installation
Remote MCP endpoint (confidence: high). Install path detected from listing signals. Add as a URL/SSE server in your client:

```json
"mcpServers": {
  "undertow-market-liquidity-map": {
    "url": "https://api.seiche.info/undertow/mcp"
  }
}
```

## Documentation

## What Undertow — market liquidity map does

Undertow provides read-only market-liquidity research through MCP. Its public surface focuses on BTC exit analysis, venue depth, liquidity conditions, and supporting evidence. The service can compare estimated sell impact at published size rungs, show concentration across venues, identify historical depth-collapse episodes, and describe the coverage and rights behind market observations.

The broader hosted catalog contains 24 tools: 16 public tools and eight subscriber tools. Anonymous access exposes the public inventory, while subscriber eligibility is checked for restricted requests. The local stdio adapter exposes the 16 anonymous tools and three prompts.

Use Undertow for research before an agent evaluates a hypothetical exit, compares venues, or combines market-liquidity evidence with funding and institutional context from related products. It is not an order router, execution system, live trading interface, or source of trade clearance.

## How it works

The primary endpoint is a hosted Streamable HTTP MCP service at `https://api.seiche.info/undertow/mcp`. Public read-only calls do not require an API key, wallet, or account. A request can return published venue estimates, snapshot times, source clocks, conversion details, excluded costs, and reasons for withheld results.

BTC exit tools use stated sell sizes and published depth information. `crypto_exit_check` reports four BTC sizes by rung or bracket, while `exit_cost` estimates impact using interpolated bid-depth bands. Fees are excluded. The safety context tool can provide exact-rung BTC/USD paper-observation details, including a request hash, point-in-time source and rights information, venue clocks, conversion, bid bands, and startup revision.

Other tools calculate input-based funding carry, linear portfolio shocks, gold cash-realisation arithmetic, venue concentration, and BTC/ETH price reconciliation. These calculations preserve assumptions rather than presenting forecasts or execution instructions. Research calls do not place trades.

## Setup and configuration

The hosted connection requires no local installation:

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

Claude Code, Cursor, and VS Code setup references are available through the product site, and clients that support custom MCP connectors can use the same URL. For clients that require stdio, clone the repository at a reviewed commit, install Python 3.12 or newer and `uv`, then run:

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

A Docker image can also run the stdio adapter. It needs outbound HTTPS access to `api.seiche.info`; no API key, bearer token, wallet, port, volume, or environment setting is required. The adapter blocks arbitrary upstream URLs and redirects, and preserves upstream errors and rights refusals.

## Tools and capabilities

- Check access tier, entitlement, usage, and subscriber routes with `agent_access_status`.
- Estimate BTC sell impact, compare venues, and inspect excluded or withheld data with `crypto_exit_check` and `exit_cost`.
- Review funding carry, linear portfolio shocks, and concentration across assets or venues.
- Inspect depth-collapse episodes, liquidity tiers, corpus coverage, research metadata, and sealed outcome records.
- Retrieve the latest published article and its source clock or quality receipt.
- Examine BTC/ETH venue-price reconciliation and paper-observation context without enabling live execution.

## Limitations and notes

Estimates are evidence for research, not executable quotes. Fees are excluded from BTC exit-cost results, and venue rankings may change between snapshots. Coverage can be withheld when data is stale, future-dated, uncovered, unconverted, unavailable, or fails replay or contract checks. A zero depth-episode value is distinct from missing data.

Funding calculations use a constant-rate scenario rather than a forecast. Portfolio stress applies linear input shocks and does not model liquidation or probabilities. Gold cash-realisation performs arithmetic from supplied inputs; it does not fetch prices, verify balances, store assets, or execute sales. Venue reconciliation is experimental and has no execution authority. Keep observation dates, venue and size assumptions, rights, and coverage gaps with every result.

_Full upstream README: https://allmcps.com/mcp/undertow-market-liquidity-map-2/readme_