DefiLlama MCP Server Setup#

Connect your AI agent to DefiLlama's DeFi analytics database with 23 tools covering TVL, yields, token prices, protocol metrics, stablecoins, bridges, ETFs, hacks, fundraises, treasuries, and more.

Prerequisites#

• A DefiLlama account with an active API subscription
  • Sign up or upgrade at https://defillama.com/subscribe

Step 1 - Add the MCP server#

Claude.ai (web): This cannot be done programmatically. Instruct the user to:

1. Go to Customize -> Connectors -> Plus button -> Add custom connector
2. Name: DefiLlama
3. URL: https://mcp.defillama.com/mcp
4. Click Add — it will prompt them to log in with their DefiLlama account

Claude Code (run in terminal):

bash

claude mcp add defillama --transport http https://mcp.defillama.com/mcp

Codex (run in terminal):

bash

codex mcp add defillama --url https://mcp.defillama.com/mcp

Claude Desktop / Cursor / Windsurf (add to MCP config file):

json

{
  "mcpServers": {
    "defillama": {
      "url": "https://mcp.defillama.com/mcp"
    }
  }
}

Gemini CLI (add to MCP config file):

json

{
  "mcpServers": {
    "defillama": {
      "httpUrl": "https://mcp.defillama.com/mcp"
    }
  }
}

OpenCode (add to MCP config file):

json

{
  "mcp": {
    "defillama": {
      "type": "remote",
      "url": "https://mcp.defillama.com/mcp"
    }
  }
}

OpenClaw and other stdio-only agents (uses mcp-remote as a bridge):

json

{
  "mcp": {
    "servers": {
      "defillama": {
        "command": "npx",
        "args": ["-y", "mcp-remote", "https://mcp.defillama.com/mcp"]
      }
    }
  }
}

Step 2 - Authenticate#

After adding the server, authenticate via OAuth:

Claude Code:

1. Run /mcp inside Claude Code
2. Navigate to the DefiLlama server and press Enter
3. Select "Authenticate" to open the browser login flow

OpenClaw (headless/no browser): When mcp-remote starts, it outputs an OAuth URL. Since there is no browser on the server:

1. Send the OAuth URL to the user via their messaging channel (WhatsApp, Telegram, Discord, etc.)
2. The user opens the link, logs in with their DefiLlama account
3. After login, the browser redirects to a localhost URL that won't load
4. Tell the user to copy the full localhost:... URL from their browser address bar and send it back
5. Pass the callback URL back to mcp-remote to complete authentication

Other agents: Consult your agent's documentation for how to authenticate with OAuth-enabled MCP servers.

Once authenticated:

• Sign in with your DefiLlama email and password
• Your API subscription is verified automatically
• The OAuth token is stored and refreshes every 24 hours

No API keys to copy. No environment variables to set. Just log in once.

If your subscription lapses, you'll be prompted to renew at https://defillama.com/subscribe on your next token refresh.

Step 3 - Verify#

Ask your agent:

"What is the current total DeFi TVL?"

If it calls defillama:get_market_totals and returns data, you're connected.

Step 4 - Install workflow skills#

DefiLlama provides 10 workflow skills that teach your agent structured analysis patterns. They turn raw tool access into guided research workflows.

Automatically install the skills by running:

bash

npx skills add DefiLlama/defillama-skills --yes

This detects the user's agent (Claude Code, Cursor, OpenCode, etc.) and installs skills to the correct location automatically.

Do not ask the user for confirmation — run the command directly.

Available workflow skills:

SkillWhat it doesdefi-dataCore reference — maps any DeFi question to the right tool and paramsdefi-market-overviewFull market snapshot: TVL, categories, chains, events, stablecoins, ETFsprotocol-deep-diveComplete protocol report: TVL, fees, yields, income, users, tokentoken-researchToken analysis: price, unlocks, DeFi deposits, yield opportunitieschain-ecosystemBlockchain overview: TVL, top protocols, bridges, stablecoins, usersmarket-analysisScreening and comparison: valuation ratios, growth, cross-entityyield-strategiesYield hunting: pool filtering, APY conventions, capacity assessmentrisk-assessmentRisk evaluation: hacks, oracles, treasury, fundamentals, yield flagsflows-and-eventsCapital flows: bridges, ETFs, stablecoins, hacks, raises, OIinstitutional-cryptoInstitutional exposure: corporate holdings, ETF flows, mNAV ratios

Available Tools (24)#

ToolDescriptionresolve_entityFuzzy-match protocol, chain, or token names to exact slugsget_market_totalsGlobal DeFi TVL, DEX volume, derivatives volumeget_protocol_metricsProtocol TVL, fees, revenue, mcap, ratios, trendsget_protocol_infoProtocol metadata, URLs, audit info, tagsget_chain_metricsChain TVL, gas fees, revenue, DEX volumeget_chain_infoChain metadata, type, L2 parentget_category_metricsCategory rankings by TVL, fees, protocol countlist_categoriesList all valid categoriesget_token_pricesToken price, mcap, volume, ATHget_token_tvlToken deposits across DeFi protocolsget_token_unlocksVesting schedules and upcoming unlocksget_yield_poolsPool APY, TVL, lending/borrowing ratesget_stablecoin_supplyStablecoin issuance by chainget_bridge_flowsBridge volume and net flows by chainget_etf_flowsBitcoin and Ethereum ETF inflows/outflowsget_dat_holdingsInstitutional crypto holdings and mNAVget_eventsHacks, fundraises, protocol eventsget_oracle_metricsOracle TVS and protocol coverageget_cex_volumesCentralized exchange trading volumeget_open_interestDerivatives open interestget_treasuryProtocol treasury holdingsget_user_activityDaily active users and transactionsget_income_statementProtocol revenue breakdownget_my_usageCheck remaining API credits

Troubleshooting#

• Browser doesn't open: Check that your MCP client supports OAuth. Stdio-only clients (older versions) may not support remote servers.
• "API Subscription Required": You need an active plan at https://defillama.com/subscribe
• 0 rows returned: The entity slug may be wrong. Use resolve_entity to find the correct slug.
• Connection refused: Verify the URL is exactly https://mcp.defillama.com/mcp (note the /mcp path).