DefiLlama MCP

An MCP server that gives Claude, Cursor, and any MCP-compatible agent live DeFi data from DefiLlama — chain and protocol TVL, token prices, yield/farming pools, and stablecoin supply.

No API key. No signup. The public DefiLlama API is free.

Most "MCP for X" repos are half-finished and break on the second request. This one ships with tests and graceful error handling so an agent can actually rely on it.

What your agent can do

Ask things like:

"Which chains have the most TVL right now?"
"What's Aave's TVL and how did it move this week?"
"Find the highest-APY stablecoin pools on Ethereum with at least $10M TVL."
"Price of BTC and ETH?" (coingecko:bitcoin,coingecko:ethereum)
"List the biggest stablecoins by circulating supply."

Tools

Tool	What it does
`get_chains_tvl`	TVL across all blockchains, ranked
`search_protocols`	Search protocols by name / symbol / category, ranked by TVL
`get_protocol`	TVL, 1d/7d change, chains, category for one protocol
`get_token_prices`	Current USD price for one or more tokens (DefiLlama coin ids)
`get_yield_pools`	Top yield pools by APY, filter by chain / project / min TVL
`get_stablecoins`	Largest stablecoins by circulating supply + peg type

Install

No install needed. It runs straight from npm via npx.

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "defillama": {
      "command": "npx",
      "args": ["-y", "defillama-mcp"]
    }
  }
}

Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "defillama": {
      "command": "npx",
      "args": ["-y", "defillama-mcp"]
    }
  }
}

Restart the client and the defillama tools appear.

Coin ids for prices

get_token_prices uses DefiLlama coin ids, comma-separated:

By CoinGecko id: coingecko:bitcoin, coingecko:ethereum
By contract: chain:0xcontract, e.g. ethereum:0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2 (WETH)

Develop

npm install
npm run dev     # run from TypeScript source over stdio
npm test        # run the unit tests
npm run build   # compile to dist/

License

MIT — see LICENSE.

Hire me

I build custom MCP servers and AI systems (multi-agent, RAG, automation). Need a connector for your own API, or a full AI integration?

Hire me on Upwork: https://www.upwork.com/freelancers/~01946645ed245c263d
Or open an issue on this repo.

Built by Gleb.

defillama mcp