MCP server de EchoLedger
Commit 24 oct 2026Analiza posiciones de pools de liquidez en vivo de Uniswap, Balancer y Curve, su salud y el riesgo de depeg utilizando el estado de la blockchain en tiempo real.
También conocido como echoledger/echoledger-mcp, echoledger-mcp
- Stars
- 0
- Herramientas
- —
- Descargas, 30 días
- —
- Última versión
- 0.2.3
- Último commit
- 24 oct 2026
- Licencia
- Apache-2.0
¿Qué es EchoLedger MCP?
Analiza posiciones de pools de liquidez en vivo de Uniswap, Balancer y Curve, su salud y el riesgo de depeg utilizando el estado de la blockchain en tiempo real.
Resumen generado a partir del README del proyecto
Acerca del MCP server de EchoLedger
EchoLedger proporciona análisis del estado de la blockchain en tiempo real para posiciones en pools de liquidez a través de los protocolos Uniswap V2/V3, Balancer y Curve stableswap. Diseñado para desarrolladores y analistas DeFi que utilizan clientes compatibles con MCP como Claude Desktop, Claude Code o Cursor, el servidor permite una inspección profunda de la salud de los pools, el slippage y los riesgos de depeg. Funciona mediante un endpoint de streamable HTTP que no requiere autenticación ni API keys, aunque los usuarios deben proporcionar su propia URL de RPC para cada llamada a las herramientas para acceder a los datos en vivo de la cadena.
El servidor incluye diez herramientas reactivas para consultas directas y una undécima herramienta única llamada BuildStateTwin. Este constructor genera un State Twin en formato JSON portable, lo que permite a un cliente realizar simulaciones contrafácticas ilimitadas localmente sin realizar peticiones RPC adicionales. Mientras que las herramientas reactivas gestionan tareas específicas como AnalyzePosition o DetectRugSignals, la función State Twin permite un modelado complejo fuera del servidor de movimientos de precios e impermanent loss para pools de Balancer con ponderación de 2 activos y pools de Curve stableswap de 2 activos.
Qué puedes hacer con él
- 1Evaluar la exposición al depeg de stablecoinsLos usuarios pueden evaluar el riesgo de pérdidas significativas en varios niveles de depeg para pools de Curve stableswap de 2 activos.
- 2Crear entornos de simulación localesUn desarrollador puede generar un snapshot JSON del estado de un pool para ejecutar múltiples escenarios matemáticos localmente sin realizar más consultas a la blockchain.
Escrito a partir del README del proyecto. Cada caso de uso se verifica con una cita del mismo.
Cómo instalar EchoLedger MCP
Formatos verificados el 10 nov 2026Añadir a CursorAñadir a GooseInstalar EchoLedger MCP en Claude Code
$ claude mcp add --transport http echoledger-mcp https://mcp.echoledger.ai/mcpInstalar EchoLedger MCP en Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"echoledger-mcp": {
"url": "https://mcp.echoledger.ai/mcp"
}
}
}Instalar EchoLedger MCP en VS Code
.vscode/mcp.json
{
"servers": {
"echoledger-mcp": {
"type": "http",
"url": "https://mcp.echoledger.ai/mcp"
}
}
}Instalar EchoLedger MCP en VS Code CLI
$ code --add-mcp '{"name":"echoledger-mcp","type":"http","url":"https://mcp.echoledger.ai/mcp"}'Instalar EchoLedger MCP en Codex
$ codex mcp add echoledger-mcp --url https://mcp.echoledger.ai/mcpInstalar EchoLedger MCP en Codex config.toml
~/.codex/config.toml
[mcp_servers.echoledger-mcp] url = "https://mcp.echoledger.ai/mcp"
Instalar EchoLedger MCP en Gemini CLI
$ gemini mcp add -s user --transport http echoledger-mcp https://mcp.echoledger.ai/mcpInstalar EchoLedger MCP en Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"echoledger-mcp": {
"url": "https://mcp.echoledger.ai/mcp",
"type": "http"
}
}
}Configuración
ECHOLEDGER_TEST_RPC_URL
| Nombre | Descripción | Tipo |
|---|---|---|
| ECHOLEDGER_TEST_RPC_URL | — |
Verificaciones automáticas
Ejecutado 14 nov 2026Informe completo →Aún no verificado. Un servidor necesita una puntuación de 80, ningún hallazgo grave y suficientes datos para que podamos revisarlo. Cómo funcionan las verificaciones · Qué corregir para obtener más puntos
- Repositorio de origen vinculado y accesibleecholedger/echoledger-mcp is public and reachablegithub.com/echoledger/echoledger-mcp ↗Aprobado
- El paquete indica este repositorio como su origenNo verificado
- Procedencia de la compilación (atestación de Sigstore)No verificado
- Licencia de código abierto (OSI)Apache-2.0spdx.org/licenses/Apache-2.0.html ↗Aprobado
- Commit o lanzamiento en el último añoLast commit or release 2026-10-24github.com/echoledger/echoledger-mcp ↗Aprobado
- OpenSSF ScorecardNo verificado
- El nombre del paquete no es similar a un paquete popularNo verificado
- No hay avisos críticos en el paquete ni en sus dependenciasNo verificado
- Sin instrucciones ocultas para el modelo0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersAprobado
- Las herramientas destructivas están etiquetadasNo verificado
- El endpoint remoto responde al handshake de MCPEndpoint did not answer initialize: HTTP 404Hallazgo
README
Ver en 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
Preguntas sobre EchoLedger MCP
¿Cómo agrego EchoLedger MCP a Claude Code?
Ejecuta claude mcp add --transport http echoledger-mcp https://mcp.echoledger.ai/mcp en tu terminal. Añade --scope user para que esté disponible en todos los proyectos.
¿Cómo agrego EchoLedger MCP a Cursor?
Abre ~/.cursor/mcp.json y añade el servidor en mcpServers, usando la configuración de Cursor que se muestra en la sección de instalación de arriba.
¿Qué liquidity pools puedo analizar?
El servidor es compatible con Uniswap V2/V3, pools de Balancer con ponderación de 2 activos y pools de Curve stableswap de 2 activos.
¿Puedo ejecutar simulaciones sin realizar más llamadas RPC?
Sí, puedes usar la herramienta BuildStateTwin para crear un estado JSON portable que permite realizar análisis contrafácticos locales ilimitados.