defi-screener-mcp

MCP server for the Honest DeFi Screener API — stablecoin lending yields, with the facts an APY column leaves out.

A raw yield feed lists 15,000 pools sorted by APY, and the top of that list is thin pools on unaudited protocols paying in incentive tokens that stop. This screens to single-asset stablecoin lending on audited protocols above a TVL floor, then reports the two things an APY cannot: how much of the yield is real lending interest rather than temporary incentives, and how long a position takes to repay the cost of opening it at your account size.

Warnings come first in every response, because an agent that skims a tool result and stops early should hit the caveats before the yields.

Install

{
  "mcpServers": {
    "defi-screener": {
      "command": "npx",
      "args": ["-y", "defi-screener-mcp"],
      "env": {
        "RAPIDAPI_KEY": "your-key"
      }
    }
  }
}

Works with any MCP client — Claude Desktop, Claude Code, Cursor, Cline, Windsurf.

Tools

screener_meta

Trusted protocols, which chains are cheap to enter, estimated entry cost per chain, and the defaults. Call this before filtering by protocol.

find_yields

Screened pools sorted by yield. Reports what was rejected and why. Pass capitalUsd and each pool gains projected monthly income and breakEvenMonths.

| Parameter | Notes | |---|---| | capitalUsd | Supply it. Without it you get yields but no idea whether they are reachable | | minTvlUsd | Default 100,000,000. Floor exists because thin pools trap deposits | | chains | e.g. ["Base","Arbitrum"] | | protocols | Must be on the trusted list | | cheapChainsOnly | Chains where entering costs cents, not dollars | | limit | 1–100, default 25 |

allocate_capital

Spreads capital under a per-protocol concentration cap (maxProtocolPct, default 30). Reports the first month net of the one-off cost of opening every position, plus the capital required to reach $20, $100, $500 and $1,500 a month at today's yields.

At small account sizes the first month is frequently negative. Real output at $100:

Deployed:           $60.00 across 2 position(s)
Blended yield:      4.45%
Projected monthly:  $0.22
Cost to open all:   $1.00
First month, net:   -$0.78

That is the product working, not failing.

Warning codes

CAPITAL_TOO_SMALL, ENTRY_COST_EXCEEDS_YIELD, REWARD_DEPENDENT, UNKNOWN_YIELD_SOURCE, EXPENSIVE_CHAINS_ONLY, ALLOCATION_ENTRY_COST_HIGH, SINGLE_PROTOCOL, SINGLE_CHAIN, CONCENTRATION_RELAXED, CAPITAL_NOT_FULLY_DEPLOYED, NOT_INVESTMENT_ADVICE.

Configuration

| Variable | Default | Purpose | |---|---|---| | RAPIDAPI_KEY | — | Marketplace subscription key | | RAPIDAPI_HOST | API host | Override when calling through a different gateway | | DEFI_SCREENER_API_URL | production Worker | Point at a different deployment | | DEFI_SCREENER_TIMEOUT_MS | 30000 | Request timeout |

Not investment advice

Yields are variable and can fall to zero. Smart contracts can fail regardless of audit history or size. This is data.

License

MIT