defillama-setup

Original：🇺🇸 English
Translated

Install and configure the DefiLlama MCP server for DeFi analytics. Provides 23 tools for TVL, token prices, yields, protocol metrics, stablecoins, bridges, ETFs, hacks, raises, and more. Supports OAuth login with your DefiLlama account. Use when the user wants to set up DefiLlama MCP, connect to DeFi data, or install DeFi analytics tools.

10installs
Sourcedefillama/defillama-skills
Added on

NPX Install

npx skill4agent add defillama/defillama-skills defillama-setup

Tags

Translated version includes tags in frontmatter
defillama-mcpdefi-analyticsagent-integrationoauth-authenticationworkflow-skills

SKILL.md Content

View Translation Comparison →

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

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 does
defi-data
Core reference — maps any DeFi question to the right tool and params
defi-market-overview
Full market snapshot: TVL, categories, chains, events, stablecoins, ETFs
protocol-deep-dive
Complete protocol report: TVL, fees, yields, income, users, token
token-research
Token analysis: price, unlocks, DeFi deposits, yield opportunities
chain-ecosystem
Blockchain overview: TVL, top protocols, bridges, stablecoins, users
market-analysis
Screening and comparison: valuation ratios, growth, cross-entity
yield-strategies
Yield hunting: pool filtering, APY conventions, capacity assessment
risk-assessment
Risk evaluation: hacks, oracles, treasury, fundamentals, yield flags
flows-and-events
Capital flows: bridges, ETFs, stablecoins, hacks, raises, OI
institutional-crypto
Institutional exposure: corporate holdings, ETF flows, mNAV ratios

Available Tools (24)

ToolDescription
resolve_entity
Fuzzy-match protocol, chain, or token names to exact slugs
get_market_totals
Global DeFi TVL, DEX volume, derivatives volume
get_protocol_metrics
Protocol TVL, fees, revenue, mcap, ratios, trends
get_protocol_info
Protocol metadata, URLs, audit info, tags
get_chain_metrics
Chain TVL, gas fees, revenue, DEX volume
get_chain_info
Chain metadata, type, L2 parent
get_category_metrics
Category rankings by TVL, fees, protocol count
list_categories
List all valid categories
get_token_prices
Token price, mcap, volume, ATH
get_token_tvl
Token deposits across DeFi protocols
get_token_unlocks
Vesting schedules and upcoming unlocks
get_yield_pools
Pool APY, TVL, lending/borrowing rates
get_stablecoin_supply
Stablecoin issuance by chain
get_bridge_flows
Bridge volume and net flows by chain
get_etf_flows
Bitcoin and Ethereum ETF inflows/outflows
get_dat_holdings
Institutional crypto holdings and mNAV
get_events
Hacks, fundraises, protocol events
get_oracle_metrics
Oracle TVS and protocol coverage
get_cex_volumes
Centralized exchange trading volume
get_open_interest
Derivatives open interest
get_treasury
Protocol treasury holdings
get_user_activity
Daily active users and transactions
get_income_statement
Protocol revenue breakdown
get_my_usage
Check 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).