About Base Defi X402
Base Defi X402 is an MCP server and pay-per-call API for yield opportunities on Base. It returns ranked farm data with APY, TVL, and risk scores, with access paid in USDC through x402.
Key features
- 01Ranked Base yield opportunities
- 02APY, TVL, and risk scores
- 03Aerodrome and Moonwell filters
- 04GET and POST API endpoints
Use cases
- 01Compare Base yield farms before deploying capital
- 02Filter opportunities by Aerodrome or Moonwell
MCP support
Exposes the `base_get_defi_opportunities` tool to MCP clients, with an optional protocol filter. API calls use x402 payments in USDC on Base.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://base-defi.api.klymax402.com/mcpclaude mcp add --transport sse br0ski777-base-defi https://base-defi.api.klymax402.com/mcp{"mcpServers":{"br0ski777-base-defi":{"type":"sse","url":"https://base-defi.api.klymax402.com/mcp"}}}Open in Cursor{"servers":{"br0ski777-base-defi":{"type":"sse","url":"https://base-defi.api.klymax402.com/mcp"}}}Open in VS Code{"mcpServers":{"br0ski777-base-defi":{"type":"sse","url":"https://base-defi.api.klymax402.com/mcp"}}}{"mcpServers":{"br0ski777-base-defi":{"serverUrl":"https://base-defi.api.klymax402.com/mcp"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
Tools
Details
From the project READMEBase DeFi Yield Optimizer API
Base chain DeFi yields -- Aerodrome LP, Moonwell lending, top farms ranked by APY with TVL and risk. Pay-per-call via x402 (USDC on Base L2) -- no API key, no signup, no rate-limit wall.
Part of the klymax402 marketplace -- 100 x402 micropayment APIs for AI agents, one wallet, USDC on Base.
Quickstart -- MCP
Add to your MCP client config (Claude Desktop, Cursor, ElizaOS, etc.):
{
"mcpServers": {
"base-defi": {
"url": "https://base-defi.api.klymax402.com/mcp"
}
}
}
Quickstart -- HTTP (x402)
curl "https://base-defi.api.klymax402.com/api/opportunities"
# -> 402 Payment Required, with an x402 payment challenge in the response body
Any x402-aware client (@x402/fetch, x402-agent-tools, ATXP) handles the 402 -> sign -> retry cycle automatically.
Tools
| Tool | Method | Path | Price | Description |
|---|---|---|---|---|
base_get_defi_opportunities | GET | /api/opportunities | $0.008 | Get DeFi yield opportunities on Base chain |
base_get_defi_opportunities | POST | /api/opportunities | $0.008 | Get DeFi yield opportunities on Base chain (POST variant) |
base_get_defi_opportunities
Use this when you need DeFi yield opportunities specifically on Base chain. Returns Base-native protocol yields in JSON.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
protocol | string | no | Filter by protocol: 'all', 'aerodrome', or 'moonwell'. Defaults to 'all'. |
Returns
opportunities-- array of yield farms ranked by APYprotocol-- protocol name (Aerodrome, Moonwell)pool-- pool name and token pairapy-- current annual percentage yieldtvl-- total value locked in USDriskScore-- risk rating (1-10, lower is safer)type-- yield type (LP, lending, staking)
Example response:
{"opportunities":[{"protocol":"Aerodrome","pool":"USDC/WETH","apy":18.5,"tvl":45000000,"riskScore":3,"type":"LP"},{"protocol":"Moonwell","pool":"USDC Lending","apy":5.2,"tvl":120000000,"riskScore":1,"type":"lending"}],"chain":"base","totalPools":12}
When to use: deploying capital on Base chain specifically. Curated list of vetted Base-native protocols only.
Not for: swap quotes on Base (use dex_get_swap_quote), liquidation risk (use defi_get_liquidation_levels).
base_get_defi_opportunities
Use this when you need DeFi yield opportunities specifically on Base chain. Returns Base-native protocol yields in JSON. POST variant of base_get_defi_opportunities -- same params passed as JSON body instead of query string.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
protocol | string | no | Filter by protocol: 'all', 'aerodrome', or 'moonwell'. Defaults to 'all'. |
Returns
opportunities-- array of yield farms ranked by APYprotocol-- protocol name (Aerodrome, Moonwell)pool-- pool name and token pairapy-- current annual percentage yieldtvl-- total value locked in USDriskScore-- risk rating (1-10, lower is safer)type-- yield type (LP, lending, staking)
Example response:
{"opportunities":[{"protocol":"Aerodrome","pool":"USDC/WETH","apy":18.5,"tvl":45000000,"riskScore":3,"type":"LP"},{"protocol":"Moonwell","pool":"USDC Lending","apy":5.2,"tvl":120000000,"riskScore":1,"type":"lending"}],"chain":"base","totalPools":12}
When to use: deploying capital on Base chain specifically. Curated list of vetted Base-native protocols only.
Not for: swap quotes on Base (use dex_get_swap_quote), liquidation risk (use defi_get_liquidation_levels).
Example agent prompts
- "DeFi yield opportunities specifically on Base chain"
- "DeFi yield opportunities specifically on Base chain"
Payment
- Protocol: x402 -- HTTP-native pay-per-call, no signup, no API key
- Network: Base L2 (
eip155:8453) - Asset: USDC
- Facilitator: Coinbase CDP (primary), PayAI (fallback)
- Also reachable via ATXP (OAuth-wrapped x402, RFC 9728 protected-resource metadata)
Part of klymax402
100 x402 micropayment APIs for AI agents -- one wallet, USDC on Base, zero signup.
- Catalog: https://klymax402.com/llms.txt
- Full API reference: https://klymax402.com/llms-full.txt
- Live stats: https://klymax402.com/stats
License
MIT
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.