Skip to content

EchoLedger

by icmoore · remote · no sign-in to list tools · v0.2.3 · published by GitHub user icmoore

Live LP analytics — Uniswap V2/V3, Balancer, Curve stableswap: PnL, health, slippage, depeg risk.

Changes · 6

11 tools: 6 change things and 5 only read.

Scanned Oct 21, 2026

No check matched anything in the tool definitions. No finding is not a safety guarantee. How the checks work.

claude mcp add --transport http echoledger https://mcp.echoledger.ai/mcp

Tools

Open a tool for its reasons and full description. Descriptions are the publisher's own words, shown as they are.

11 tools

Changes things 6Claude Code: ask
  • AssessDepegRiskQuantify a 2-asset Curve-style Stableswap LP position's exposure to a stablecoin depeg.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    Description, as the server wrote it
    Quantify a 2-asset Curve-style Stableswap LP position's exposure to a stablecoin depeg. Computes IL at multiple depeg levels (default 2%, 5%, 10%, 20%, 50%) via the closed-form stableswap-invariant expansion, with an optional V2 constant-product benchmark at each level. Some depeg levels are physically unreachable at high A — unreachable scenarios return null on il_pct, lp_value_at_depeg, and hold_value_at_depeg; the V2 benchmark stays populated.
  • CalculateSlippageCalculate slippage and price-impact decomposition for a proposed swap on a Uniswap V2 or V3 pool.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    Description, as the server wrote it
    Calculate slippage and price-impact decomposition for a proposed swap on a Uniswap V2 or V3 pool. Returns spot vs execution price, slippage percentage, slippage cost in output-token units, and price impact. Also returns the maximum trade size that stays within 1% slippage for V2 pools; V3 returns null for that field because tick-crossing math has not yet been inverted.
  • DetectRugSignalsDetect rug-pull signals on a Uniswap V2 or V3 pool via three threshold checks: suspiciously low TVL, top-LP concentration above a limit, and inactive-pool-with-liquidity.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    Description, as the server wrote it
    Detect rug-pull signals on a Uniswap V2 or V3 pool via three threshold checks: suspiciously low TVL, top-LP concentration above a limit, and inactive-pool-with-liquidity. Composes over CheckPoolHealth and returns per-signal booleans plus a count-based risk level (low/medium/high/critical). The inactive-with-liquidity signal is V2-only; V3 pools report False for it with a note in details.
  • SimulateBalancerMoveProject a 2-asset Balancer weighted-pool LP position's value at a hypothetical price change from the CURRENT pool state.No findings

    Why it is in this group

    • The name "SimulateBalancerMove" says "move": a word for a change.
    Description, as the server wrote it
    Project a 2-asset Balancer weighted-pool LP position's value at a hypothetical price change from the CURRENT pool state. The shock is applied to the base-token price in opp units; IL depends on both the shock magnitude and the pool's weights. Returns new value in opp-numeraire, IL at the simulated price, and percentage change.
  • SimulatePriceMoveProject a Uniswap V2 or V3 LP position's value at a hypothetical price change from the CURRENT pool state (not from entry).No findings

    Why it is in this group

    • The name "SimulatePriceMove" says "move": a word for a change.
    Description, as the server wrote it
    Project a Uniswap V2 or V3 LP position's value at a hypothetical price change from the CURRENT pool state (not from entry). A price_change_pct of -0.30 asks 'what if price drops 30% from here'. Returns new value, IL at the simulated price, and percentage change in position value. Fee projection is not modeled (always null).
  • SimulateStableswapMoveProject a 2-asset Curve-style Stableswap LP position's value at a hypothetical depeg from the CURRENT pool state.No findings

    Why it is in this group

    • The name "SimulateStableswapMove" says "move": a word for a change.
    Description, as the server wrote it
    Project a 2-asset Curve-style Stableswap LP position's value at a hypothetical depeg from the CURRENT pool state. The shock multiplies the pool's current alpha by (1 + price_change_pct); at high A, large shocks may be physically unreachable and in that case new_value, il_at_new_price, and value_change_pct are returned as null. Values are in peg-numeraire.
Only reads 5Claude Code: allow
  • AnalyzeBalancerLPAnalyze a 2-asset Balancer weighted-pool LP position's PnL.No findings

    Why it is in this group

    • The name "AnalyzeBalancerLP" says "analyze": a word for reading.
    Description, as the server wrote it
    Analyze a 2-asset Balancer weighted-pool LP position's PnL. Decomposes impermanent loss using the weighted-pool formula where the base token's weight affects IL magnitude. Values are denominated in opp-token units per BalancerImpLoss's convention; fee income is not attributed in v1 because Balancer pools only expose vault-level fees with no per-LP attribution.
  • AnalyzePositionAnalyze why a Uniswap V2 or V3 LP position is gaining or losing money.No findings

    Why it is in this group

    • The name "AnalyzePosition" says "analyze": a word for reading.
    Description, as the server wrote it
    Analyze why a Uniswap V2 or V3 LP position is gaining or losing money. Decomposes PnL into impermanent loss, accumulated fees, and net result, with optional real APR if a holding period is supplied. Returns current value, hold value, IL percentage, fee income, net PnL, real APR, and a diagnosis label.
  • AnalyzeStableswapLPAnalyze a 2-asset Curve-style Stableswap LP position's PnL using the amplified-invariant IL formula where small depegs can produce surprisingly large IL at high A.No findings

    Why it is in this group

    • The name "AnalyzeStableswapLP" says "analyze": a word for reading.
    Description, as the server wrote it
    Analyze a 2-asset Curve-style Stableswap LP position's PnL using the amplified-invariant IL formula where small depegs can produce surprisingly large IL at high A. Values are in peg-numeraire (tokens valued 1:1); fee income is not attributed in v1 (pool-global only); positions whose implied alpha is in the unreachable regime return None on il_percentage, net_pnl, and real_apr.
  • BuildStateTwinRead a pool's on-chain state once and return it as a serialized State Twin (JSON): the protocol-specific snapshot plus a content_hash, in the wire form a client rehydrates locally.No findings

    Why it is in this group

    • The description's first verb is "read": a word for reading.
    Description, as the server wrote it
    Read a pool's on-chain state once and return it as a serialized State Twin (JSON): the protocol-specific snapshot plus a content_hash, in the wire form a client rehydrates locally. Use this to pull a single managed-RPC twin, then run any number of counterfactuals (price moves, IL, slippage) client-side, off this server. Covers Uniswap V2/V3, Balancer 2-asset weighted, and Curve 2-asset plain stableswap pools. The endpoint stores and logs nothing — your rpc_url is never persisted.
  • CheckPoolHealthSnapshot pool-level health metrics for a Uniswap V2 or V3 pool: TVL in token0 numeraire, reserves, accumulated fees, LP concentration, and swap activity.No findings

    Why it is in this group

    • The description's first verb is "snapshot": a word for reading.
    Description, as the server wrote it
    Snapshot pool-level health metrics for a Uniswap V2 or V3 pool: TVL in token0 numeraire, reserves, accumulated fees, LP concentration, and swap activity. Answers 'is this a pool I would deposit into?' at the pool level (not position level). num_swaps and fee_accrual_rate_recent are V2-only; V3 returns null for these because V3 has no per-swap history array. A single-block live snapshot also returns null for the LP-concentration and swap metrics (unrecoverable from state alone).

This is not a safety rating, and no finding is not a safety guarantee. The groups and findings come from fixed checks of the tool definitions the server returned on the date shown, not from its code or what it does when called. How the checks work.

Install

Pinned to version 0.2.3. Values in angle brackets are yours to fill in.

claude mcp add --transport http echoledger https://mcp.echoledger.ai/mcp

Run in a terminal.

Claude Code permissions

Allow the reads, ask before a change, deny the deletes. Paste into .claude/settings.json.

.claude/settings.json
{
  "permissions": {
    "allow": [
      "mcp__echoledger__AnalyzePosition",
      "mcp__echoledger__AnalyzeBalancerLP",
      "mcp__echoledger__AnalyzeStableswapLP",
      "mcp__echoledger__CheckPoolHealth",
      "mcp__echoledger__BuildStateTwin"
    ],
    "ask": [
      "mcp__echoledger__SimulatePriceMove",
      "mcp__echoledger__SimulateBalancerMove",
      "mcp__echoledger__SimulateStableswapMove",
      "mcp__echoledger__DetectRugSignals",
      "mcp__echoledger__CalculateSlippage",
      "mcp__echoledger__AssessDepegRisk"
    ],
    "deny": []
  }
}

Tools that only read are allowed, tools that change things ask first, tools that delete or cancel are denied. It assumes the server is installed as echoledger. Review it before you use it.