Defimind MCP Server

defimind-mcp

DeFiMind's MCP server. Analyze live Uniswap V2/V3 pools — positions, price moves, pool health, rug signals, and slippage — from any MCP-compatible AI client. Reads real chain state via a caller-supplied RPC; the endpoint itself is authless.

Endpoint: https://mcp.defimind.ai/mcp (streamable-HTTP, authless).

Install

Claude Desktop

Settings → Integrations → Add server. URL: https://mcp.defimind.ai/mcp

Claude Code

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

Cursor

Settings → MCP → Add new MCP server. Name: defimind · Type: http · URL: https://mcp.defimind.ai/mcp

Smithery

Listed at smithery.ai/servers/ic3moore/defimind — connect via the Smithery gateway from any supported client.

Tools

v0.1 ships 5 tools over Uniswap V2/V3, reading live pool state. Each call takes pool_address, rpc_url, and pool_type (uniswap_v2 | uniswap_v3), plus optional chain_id guard and block_number pin — nothing is stored.

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?"

How it works

defimind-mcp reads live Uniswap V2/V3 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, once DeFiPy 2.2 ships their LiveProviders.
• 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 defimind_mcp.server      # endpoint at http://localhost:8080/mcp

Or over stdio for a local MCP Inspector smoke-test:

python -m defimind_mcp.server --stdio
npx @modelcontextprotocol/inspector python -m defimind_mcp.server --stdio

Tests (offline — fake provider + real twin/primitives):

pytest tests/

Live-RPC gate (real mainnet V2 + V3 pools; needs your own RPC):

DEFIMIND_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
• DeFiMind: https://defimind.ai
• State Twins paper: https://arxiv.org/abs/2605.11522