EchoLedger MCPサーバー
コミット 2026年10月24日リアルタイムのブロックチェーン状態を使用して、Uniswap、Balancer、Curveの流動性プールにおけるポジション、健全性、およびデペグリスクを分析します。
別名 echoledger/echoledger-mcp, echoledger-mcp
- スター
- 0
- ツール
- —
- ダウンロード数(30日間)
- —
- 最新バージョン
- 0.2.3
- 最終コミット
- 2026年10月24日
- ライセンス
- Apache-2.0
EchoLedger MCPとは
リアルタイムのブロックチェーン状態を使用して、Uniswap、Balancer、Curveの流動性プールにおけるポジション、健全性、およびデペグリスクを分析します。
プロジェクトのREADMEから生成された概要
EchoLedger MCP server について
EchoLedgerは、Uniswap V2/V3、Balancer、およびCurve stableswapプロトコルにおける流動性プール・ポジションのリアルタイムなブロックチェーン状態分析を提供します。Claude Desktop、Claude Code、CursorなどのMCP対応クライアントを使用する開発者やDeFiアナリスト向けに設計されており、プールの健全性、スリッページ、およびデペグリスクの詳細な調査が可能です。本サーバーは、認証やAPIキーを必要としないstreamable HTTPエンドポイントを介して機能しますが、ライブチェーンデータにアクセスするために、各ツール呼び出し時にユーザー自身でRPC URLを提供する必要があります。
サーバーには、直接的なクエリを行うための10個のリアクティブなツールと、BuildStateTwinと呼ばれる独自の11番目のツールが含まれています。このビルダーはポータブルなJSON State Twinを生成し、クライアントが追加のRPCリクエストを行うことなく、ローカルで無制限の反実仮想シミュレーションを実行できるようにします。リアクティブなツールがAnalyzePositionやDetectRugSignalsといった特定のタスクを処理する一方で、State Twin機能は、2資産ウェイト付きBalancerプールや2資産のCurve stableswapプールにおける価格変動やインパーマネントロスの複雑なオフサーバーモデリングを可能にします。
できること
- 1ステーブルコインのデペグ露出の評価2資産のCurve stableswapプールにおける、さまざまなデペグレベルでの大幅な損失リスクを評価できます。
- 2ローカルシミュレーション環境の構築開発者はプールの状態のJSONスナップショットを生成し、さらなるブロックチェーンへのクエリを行うことなく、複数の数学的シナリオをローカルで実行できます。
プロジェクトの README から作成されています。すべてのユースケースは、その引用と照らし合わせて確認されています。
EchoLedger MCPのインストール方法
フォーマット検証日 2026年11月10日Cursor に追加Gooseに追加Claude CodeにEchoLedger MCPをインストール
$ claude mcp add --transport http echoledger-mcp https://mcp.echoledger.ai/mcpCursorにEchoLedger MCPをインストール
~/.cursor/mcp.json
{
"mcpServers": {
"echoledger-mcp": {
"url": "https://mcp.echoledger.ai/mcp"
}
}
}VS CodeにEchoLedger MCPをインストール
.vscode/mcp.json
{
"servers": {
"echoledger-mcp": {
"type": "http",
"url": "https://mcp.echoledger.ai/mcp"
}
}
}VS Code CLIにEchoLedger MCPをインストール
$ code --add-mcp '{"name":"echoledger-mcp","type":"http","url":"https://mcp.echoledger.ai/mcp"}'CodexにEchoLedger MCPをインストール
$ codex mcp add echoledger-mcp --url https://mcp.echoledger.ai/mcpCodex config.tomlにEchoLedger MCPをインストール
~/.codex/config.toml
[mcp_servers.echoledger-mcp] url = "https://mcp.echoledger.ai/mcp"
Gemini CLIにEchoLedger MCPをインストール
$ gemini mcp add -s user --transport http echoledger-mcp https://mcp.echoledger.ai/mcpGemini settings.jsonにEchoLedger MCPをインストール
~/.gemini/settings.json
{
"mcpServers": {
"echoledger-mcp": {
"url": "https://mcp.echoledger.ai/mcp",
"type": "http"
}
}
}設定
ECHOLEDGER_TEST_RPC_URL
| 名前 | 説明 | 種類 |
|---|---|---|
| ECHOLEDGER_TEST_RPC_URL | — |
自動チェック
実行日 2026年11月14日完全なレポート →まだ検証されていません。サーバーには80点のスコア、重大な問題がないこと、および検証に必要な十分なデータが必要です。 チェックの仕組み · 点数を上げるための改善点
- ソースリポジトリがリンクされており、アクセス可能echoledger/echoledger-mcp is public and reachablegithub.com/echoledger/echoledger-mcp ↗合格
- パッケージがこのリポジトリをソースとして指定未チェック
- ビルドの来歴 (Sigstore 証明)未チェック
- オープンソースライセンス (OSI)Apache-2.0spdx.org/licenses/Apache-2.0.html ↗合格
- 過去1年以内にコミットまたはリリースありLast commit or release 2026-10-24github.com/echoledger/echoledger-mcp ↗合格
- OpenSSF Scorecard未チェック
- パッケージ名が有名なパッケージに酷似していない未チェック
- パッケージおよびその依存関係に重大な勧告なし未チェック
- モデルへの隠れた指示がない0 tool descriptions and the README read; no override phrases, credential paths or hidden characters合格
- 破壊的なツールがラベル付けされている未チェック
- リモートエンドポイントが MCP ハンドシェイクに応答Endpoint did not answer initialize: HTTP 404検出事項
README
GitHubで見る⚠ Decommissioned (2026-10-23). This MCP server is no longer hosted. The public endpoint
mcp.echoledger.aihas been taken offline and its listings removed. Kept for reference. Not maintained, not deployed.
echoledger-mcp
EchoLedger's MCP server. Analyze live Uniswap V2/V3, Balancer, and Curve stableswap pools — positions, price moves, pool health, rug signals, slippage, and depeg risk — or build a portable State Twin for off-MCP analysis, from any MCP-compatible AI client. Reads real chain state via a caller-supplied RPC; the endpoint itself is authless.
Endpoint: https://mcp.echoledger.ai/mcp (streamable-HTTP, authless).
Install
Claude Desktop
Settings → Integrations → Add server.
URL: https://mcp.echoledger.ai/mcp
Claude Code
claude mcp add --transport http echoledger https://mcp.echoledger.ai/mcp
Cursor
Settings → MCP → Add new MCP server.
Name: echoledger · Type: http · URL: https://mcp.echoledger.ai/mcp
Smithery
Listed at smithery.ai/servers/ic3moore/echoledger — connect via the Smithery gateway from any supported client.
Tools
The endpoint ships 11 tools over live Uniswap V2/V3, Balancer weighted (2-asset), and Curve stableswap (2-asset) pools. Two surfaces:
- 10 reactive primitives — one question, one answer, one chain read.
Four of them also take a vector input (e.g.
price_change_pcts[],amounts_in[]) to sweep a whole grid/curve in one call. BuildStateTwin— returns a portable State Twin (the pool's state as JSON) that a client rehydrates locally to run unlimited counterfactuals off the MCP, zero further RPC.
Every call takes pool_address, rpc_url, and pool_type, plus an
optional chain_id guard and block_number pin — nothing is stored.
Each reactive tool is protocol-specific and advertises only the
pool_type values it accepts; pointing one at an unsupported type
returns a clean error before any chain read.
Full reference — params, returns, and a verified example per tool:
docs/TOOLS.md.
Scope: the Balancer tools cover 2-asset weighted pools; the
stableswap tools cover 2-asset plain Curve pools (rate-bearing pools
— metapools, LSD — are a later release). A stableswap tool pointed at a
3-coin or rate-bearing pool fails cleanly.
Uniswap V2/V3
AnalyzePosition
PnL decomposition for an LP position — impermanent loss, fees, and net.
"Analyze my position in the V3 USDC/ETH pool."
SimulatePriceMove
"What if price moves X%?" — projected reserves, position value, and IL.
"If ETH drops 20%, what happens to my V3 ETH/DAI position?"
CheckPoolHealth
TVL, reserves, LP concentration, and recent activity for a pool.
"Is this V3 pool healthy?"
DetectRugSignals
Threshold-based rug flags on a pool's on-chain state.
"Any rug signals on this V2 pair?"
CalculateSlippage
Slippage, price impact, and max trade size for a given trade.
"How much slippage on a 50 ETH buy in this V3 pool?"
Balancer (2-asset weighted)
AnalyzeBalancerLP
PnL decomposition for a 2-asset Balancer weighted-pool position, using the weighted-pool IL formula where the token weight shapes IL magnitude.
"How is my 80/20 BAL/WETH Balancer position doing?"
SimulateBalancerMove
"What if the base token moves X%?" — projected value and IL on a 2-asset weighted pool, weight-aware.
"If BAL drops 30%, what happens to my BAL/WETH Balancer LP?"
Curve stableswap (2-asset plain)
AnalyzeStableswapLP
PnL decomposition for a 2-asset Curve stableswap position via the amplified-invariant IL formula — small depegs can produce outsized IL at high A.
"Analyze my position in the crvUSD/USDC pool."
SimulateStableswapMove
"What if the peg shifts X%?" — projected value and IL on a 2-asset stableswap pool. At high A, large shocks may be physically unreachable (returned as null).
"What happens to my USDC/DAI Curve LP if USDC depegs 2%?"
AssessDepegRisk
IL across a ladder of depeg levels (default 2%, 5%, 10%, 20%, 50%) for a 2-asset stableswap position, with an optional constant-product benchmark.
"How exposed is my crvUSD/USDC position to a depeg?"
State twin builder (all four pool types)
BuildStateTwin
Reads a pool once and returns a portable State Twin — the pool's state
as JSON (__type__ + fields + a content_hash). A client rehydrates it
locally and runs unlimited counterfactuals (price moves, IL, slippage)
off the MCP, with zero further RPC — build once, run N. Spans all four
pool types. See the twin round-trip in docs/TOOLS.md and
the echoledger package.
"Build me a reusable twin of the USDC/ETH 0.05% pool."
(Honest gap: it's a single-block STATE twin — history-derived health
metrics stay server-side reads inside CheckPoolHealth/DetectRugSignals.)
How it works
echoledger-mcp reads live Uniswap V2/V3, Balancer, and Curve
stableswap pool state through a caller-supplied RPC endpoint (BYO-RPC,
passed per tool call). The endpoint is authless — no API key, no
account. Nothing is logged or stored; each call pulls state, runs the
analysis, and returns a typed result.
The analytics are powered by open-source DeFiPy — the same primitives, twin, and tools that run against synthetic recipes, now pointed at real pools. The math is open; the reports are paid.
Roadmap
- v0.2 — Balancer & Stableswap live reads ✓ shipped. The 5 Balancer/Stableswap tools went live on DeFiPy 2.2's LiveProviders (2-asset weighted + 2-asset plain Curve).
- v0.2.2 — honest schemas, vectors & the twin builder ✓ shipped.
Per-tool
pool_typeenums; vectorized scenario inputs on the four scenario tools; andBuildStateTwin— the 11th tool — for portable, off-MCP twin analysis. - N-asset & rate-bearing pools — 3-asset Balancer, N-coin and rate-bearing (metapool/LSD) Curve, once the upstream DeFiPy primitives extend past 2 assets.
- Distribution polish — OCI-package listing, DNS-verified namespace, and OIDC auto-publish.
Develop
python -m venv .venv && source .venv/bin/activate
pip install -e ".[dev]"
Run the server over streamable HTTP (binds to $PORT, default 8080):
PORT=8080 python -m echoledger_mcp.server # endpoint at http://localhost:8080/mcp
Or over stdio for a local MCP Inspector smoke-test:
python -m echoledger_mcp.server --stdio
npx @modelcontextprotocol/inspector python -m echoledger_mcp.server --stdio
Tests (offline — fake provider + real twin/primitives):
pytest tests/
Live-RPC gate (real mainnet Uniswap V2/V3, Balancer, and Curve pools; needs your own RPC):
ECHOLEDGER_TEST_RPC_URL="https://eth-mainnet.example/v2/<key>" pytest tests/test_live.py -v
License
Apache-2.0. See LICENSE and NOTICE.
This project adapts code from DeFiPy (Apache-2.0).
See also
- DeFiPy (open-source substrate): https://defipy.org
- EchoLedger: https://echoledger.ai
- State Twins paper: https://arxiv.org/abs/2605.11522
EchoLedger MCPのよくある質問
EchoLedger MCPをClaude Codeに追加するには
ターミナルでclaude mcp add --transport http echoledger-mcp https://mcp.echoledger.ai/mcpを実行します。すべてのプロジェクトで利用するには--scope userを追加します。
EchoLedger MCPをCursorに追加するには
~/.cursor/mcp.jsonを開き、上記のインストールセクションに示すCursor設定を使ってmcpServersの下にサーバーを追加します。
どの流動性プールを分析できますか?
Uniswap V2/V3、2資産ウェイト付きBalancerプール、および2資産のCurve stableswapプールをサポートしています。
追加のRPCコールを行わずにシミュレーションを実行できますか?
はい、BuildStateTwinツールを使用してポータブルなJSON状態を作成することで、ローカルで無制限の反実仮想分析を行うことが可能です。