mcpField
B
Base Defi X402

Base Defi X402

Remote
github.comData & Analytics0Updated 8w ago

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

  1. 01Ranked Base yield opportunities
  2. 02APY, TVL, and risk scores
  3. 03Aerodrome and Moonwell filters
  4. 04GET and POST API endpoints

Use cases

  1. 01Compare Base yield farms before deploying capital
  2. 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.

Endpointhttps://base-defi.api.klymax402.com/mcp
Copy install command
Claude CodeTerminal
Cursor.cursor/mcp.json
VS Code.vscode/mcp.json
Claude Desktopclaude_desktop_config.json
Windsurf~/.codeium/windsurf/mcp_config.json

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 README

Base DeFi Yield Optimizer API

MCP Server x402 License: MIT

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

ToolMethodPathPriceDescription
base_get_defi_opportunitiesGET/api/opportunities$0.008Get DeFi yield opportunities on Base chain
base_get_defi_opportunitiesPOST/api/opportunities$0.008Get 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

NameTypeRequiredDescription
protocolstringnoFilter by protocol: 'all', 'aerodrome', or 'moonwell'. Defaults to 'all'.

Returns

  • opportunities -- array of yield farms ranked by APY
  • protocol -- protocol name (Aerodrome, Moonwell)
  • pool -- pool name and token pair
  • apy -- current annual percentage yield
  • tvl -- total value locked in USD
  • riskScore -- 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

NameTypeRequiredDescription
protocolstringnoFilter by protocol: 'all', 'aerodrome', or 'moonwell'. Defaults to 'all'.

Returns

  • opportunities -- array of yield farms ranked by APY
  • protocol -- protocol name (Aerodrome, Moonwell)
  • pool -- pool name and token pair
  • apy -- current annual percentage yield
  • tvl -- total value locked in USD
  • riskScore -- 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.

License

MIT

Comments

Markdown supported

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.