
MCP server giving AI agents direct, on-chain access to DeFi data — Aave v3 positions, Chainlink
MCP server giving AI agents direct, on-chain access to DeFi data — Aave v3 positions, Chainlink prices, Uniswap v3 swap simulation. No centralized API.
·
An MCP (Model Context Protocol) server that gives AI agents direct, on-chain access to DeFi data on EVM chains — wallet balances, Aave v3 lending positions, and live token prices, with no centralized API in the middle.
Status: Live and functional. 5 tools available today, more on the roadmap.
Most "DeFi + AI" integrations route through a centralized API that can rate-limit, paywall, or simply disappear. defi-mcp talks directly to the chain (via your own RPC provider) and to first-party oracles (Chainlink), so the data your AI agent gets is exactly what's on-chain — verifiable, and not dependent on a third-party API staying online.
get_token_balanceReads the ERC-20 balance of any wallet address for a supported token.
Supported tokens:
USDC, USDC.e, USDT, WETH, WMATIC, WBTC, DAI, AAVEUSDC, USDC.e (bridged), USDT, WETH, WBTC, ARB// get_token_balance(address="0x...", token_symbol="USDC", chain="polygon")
{
"address": "0x...",
"token": "USDC",
"chain": "polygon",
"balance": 268.21,
"raw_balance": "268210000",
"decimals": 6
}get_aave_positionReads a user's full Aave v3 lending/borrowing position: collateral, debt, available borrowing power, and health factor — straight from the Aave v3 Pool contract.
// get_aave_position(address="0x...", chain="polygon")
{
"address": "0x...",
"chain": "polygon",
"total_collateral_usd": 969.78,
"total_debt_usd": 288.16,
"available_borrows_usd": 484.86,
"liquidation_threshold_pct": 82.79,
"ltv_pct": 79.71,
"health_factor": 2.79,
"has_active_position": true
}A health_factor below 1.0 means the position is at risk of liquidation. A null health factor means the user has no outstanding debt.
get_token_priceReads the current USD price of a token directly from a Chainlink price feed — the same oracle DeFi protocols use internally, so the price is consistent with what get_aave_position reports.
Supported feeds:
ETH/WETH, MATIC/WMATIC, WBTC, USDC, USDTETH/WETH, WBTC, ARB, USDC, USDT// get_token_price(token_symbol="WBTC", chain="polygon")
{
"token": "WBTC",
"chain": "polygon",
"price_usd": 63835.77,
"decimals": 8,
"updated_at": 1782032816
}simulate_swapSimulates a Uniswap v3 swap on-chain via the QuoterV2 contract — no transaction submitted, no wallet needed. Tries all four fee tiers (0.01%, 0.05%, 0.3%, 1%) and returns the best available output amount.
Supported tokens:
USDC, USDC.e, USDT, WETH, WMATIC, WBTC, DAI, AAVEUSDC, USDC.e (bridged), USDT, WETH, WBTC, ARB// simulate_swap(token_in="WMATIC", token_out="USDC", amount_in=100.0, chain="polygon")
{
"chain": "polygon",
"token_in": "WMATIC",
"token_out": "USDC",
"amount_in": 100.0,
"amount_out": 7.990547,
"fee_tier_used_pct": 0.05,
"fee_tier_used_bps": 500,
"gas_estimate": 122770
}If no pool exists for the pair at any fee tier, returns {"error": "No liquidity found for this pair on any fee tier"}.
helloSimple connectivity check — confirms the MCP server is reachable and responding.
| Chain | get_token_balance | get_aave_position | get_token_price | simulate_swap |
|---|---|---|---|---|
| Polygon | ✅ | ✅ | ✅ | ✅ |
| Arbitrum | ✅ | ✅ | ✅ | ✅ |
Requires Python 3.10+ and an RPC provider API key (e.g. Alchemy, free tier works).
pip install defi-mcpCreate a .env file in your working directory (see .env.example):
POLYGON_RPC_URL=https://polygon-mainnet.g.alchemy.com/v2/YOUR_API_KEY
ARBITRUM_RPC_URL=https://arb-mainnet.g.alchemy.com/v2/YOUR_API_KEYEach chain only needs its RPC URL configured. Tools called with chain="arbitrum" will fail gracefully if ARBITRUM_RPC_URL is not set.
Add this to your Claude Desktop MCP config (claude_desktop_config.json):
{
"mcpServers": {
"defi-mcp": {
"command": "uvx",
"args": ["defi-mcp"],
"env": {
"POLYGON_RPC_URL": "https://polygon-mainnet.g.alchemy.com/v2/YOUR_API_KEY",
"ARBITRUM_RPC_URL": "https://arb-mainnet.g.alchemy.com/v2/YOUR_API_KEY"
}
}
}
}Restart Claude Desktop, and the tools above will be available to the model.
You can test the server directly with the official MCP Inspector:
npx @modelcontextprotocol/inspector uvx defi-mcpdefi-mcp-cloud — hosted tier with MEV-specific tools, caching, and higher rate limitsOpen-core model: this repository (MIT licensed) covers standard on-chain read tools. A separate defi-mcp-cloud will offer a hosted version with MEV-related tools, request caching, and managed RPC access for users who don't want to run their own infrastructure.
web3.py snippets. Useful if you want to read on-chain state directly via eth_getStorageAt instead of calling view functions — the lower-level approach behind some of what this server does under the hood.Issues and PRs welcome. This is an early-stage project — feedback on what tools would actually be useful to you is especially valuable.
MIT
Pick your client and paste the snippet. Each one is the same server, written the way that client expects it.
claude mcp add defi-mcp -- uvx defi-mcp{
"mcpServers": {
"defi-mcp": {
"env": {
"POLYGON_RPC_URL": "",
"ARBITRUM_RPC_URL": ""
},
"args": [
"defi-mcp"
],
"command": "uvx"
}
}
}code --add-mcp '{"name":"defi-mcp","env":{"POLYGON_RPC_URL":"","ARBITRUM_RPC_URL":""},"args":["defi-mcp"],"command":"uvx"}'[mcp_servers.defi-mcp]
command = "uvx"
args = ["defi-mcp"]Runs locally on your device. Your client starts the server itself, so nothing has to be hosted.
Paste this prompt into your agent. It reads this page and does the setup for you.
Read https://aiagentslisting.com/mcp/defi-mcp to learn what the "Defi Mcp" MCP server does and how to install it. Add it to my coding agent's MCP configuration as documented on that page, then confirm the server connects and list the tools it exposes.Agents can also browse this directory over MCP at https://aiagentslisting.com/api/mcp
npx @modelcontextprotocol/inspector uvx defi-mcppip install defi-mcpThis server runs locally, so we can't read its tool list over the web yet.
We could not run this server: it ships no npx package for our sandbox and no public endpoint. The four checks that need a live server are left out, and the grade tops out at B until one exists.
Maintain this server? Claiming proves you own the listing and earns the last 4 points.
Claim this listingPaste this line near the top of your repository's README. The badge always renders the current score.
[](https://aiagentslisting.com/mcp/defi-mcp)Nothing comparable is listed yet.
No tagged releases on record.
Connect to the AI Agents Listing MCP server at https://aiagentslisting.com/api/mcp using the HTTP transport and complete the sign-in when it asks. Then call the submit_review tool for the listing "defi-mcp" with a rating from 1 to 5 and a short note on what worked and what did not.No reviews yet
Be the first to share your experience with this tool.
One email a week. New agents, MCP servers and skills, and what is actually getting traction.