get_top_yields(chain, min_tvl, stablecoins_only, max_risk, limit)LABSCO SUMMARY
The risk tier is the point, not the APY.
Surfacing a huge APY is easy; labelling it is the useful part. Anything above 1000% comes back tagged EXTREME, and max_risk filters it out before it reaches the answer. The coverage behind it is DefiLlama's — 16,000+ pools across 60+ chains — so treat the tier as a screen for a shortlist, then run get_pool_risk on the two or three you would actually fund.
What it is
A yield aggregator over DefiLlama data, exposed as four tools. It ranks pools across chains and attaches a risk classification to each, so an answer says what a pool pays and what could go wrong with it.
What you get
get_top_yieldsfilters by chain, minimum TVL, stablecoins-only and maximum risk, and returns the best opportunities left standingget_pool_riskgoes deep on one pool: impermanent-loss exposure, audit status, APY trend and predictioncompare_yieldsprojects what a given deposit amount would earn across the top poolsget_chainslists every chain with its pool count and top yield- Every pool carries one of four tiers — LOW, MEDIUM, HIGH or EXTREME, where EXTREME means very low TVL or an APY above 1000% and so likely unsustainable
Requirements
It is not on PyPI, so the README's pip install line fails; install it from a clone with pip install ., and it then runs as python -m defi_yield_mcp. No account and no API key: all data comes from DefiLlama's free public API, refreshed every 5 minutes.
Setup effort
Build from source — git clone https://github.com/RJW34/defi-yield-mcp
USE CASES
01
Parking stablecoins somewhere sensible
Filter to stablecoin pools on one chain above a TVL floor, and cap the risk tier so nothing exotic comes back.
02
Checking a pool someone recommended
Pull impermanent-loss exposure, audit status and the APY trend for that one pool before depositing.
03
Sizing what a deposit would actually earn
Project returns for a specific amount across the leading pools instead of reading percentages in isolation.
04
Choosing which chain to work on
Compare chains by how many pools they have and what the top yield looks like.
4 tools
Listed in project docs. Your client may show a different list.
get_pool_risk(pool_id, project, symbol)compare_yields(amount, chains, stablecoins_only)get_chains()BEFORE YOU INSTALL
What to know first
Tools you get
4 tools named in the project's documentation.
Requires
python on PATH
Where it runs
The documented client runs the server on your machine.
INSTALLATION
Connect your client
This one is built from source rather than installed with a single command.
Server setup
TERMINAL
git clone https://github.com/RJW34/defi-yield-mcp
cd defi-yield-mcp
pip install .Then point your client at it — the block under MCP Clients runs the installed module with python -m defi_yield_mcp
MCP Clients
Claude Desktop
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"defi-yield": {
"command": "python",
"args": [
"-m",
"defi_yield_mcp"
]
}
}
}
