Skip to main content
Glama
MCP DeFiLlama Airdrops

MCP DeFiLlama Airdrops

by zarelli1

MCP DeFiLlama Airdrops

Um servidor MCP (Model Context Protocol) para extrair dados de airdrops do DeFiLlama.

🚀 Funcionalidades

  • Scraping automático de airdrops do DeFiLlama

  • Cache inteligente (5 minutos) para otimizar performance

  • Filtros avançados por status, chain, valor mínimo

  • Ranking dos melhores airdrops por critérios configuráveis

  • Dados estruturados em formato JSON

  • Fallback de dados para garantir funcionamento

Related MCP server: Find Flights MCP Server

🛠️ Ferramentas Disponíveis

get_airdrops

Busca todos os airdrops disponíveis.

Parâmetros:

  • forceRefresh (boolean): Forçar atualização ignorando cache

  • onlyActive (boolean): Retornar apenas airdrops ativos

  • chain (string): Filtrar por blockchain específica

filter_airdrops

Filtra airdrops por critérios específicos.

Parâmetros:

  • minValue (number): Valor mínimo estimado

  • status (string): Status do airdrop

  • chain (string): Blockchain

  • searchTerm (string): Buscar no nome/descrição

get_best_airdrops

Obtém os melhores airdrops rankeados.

Parâmetros:

  • limit (number): Máximo de resultados (padrão: 10)

  • sortBy (string): Critério de ordenação (value, deadline, name)

debug_scraper

Debug e teste do scraper.

📊 Formato dos Dados

{
  "name": "LayerZero",
  "value": "$1000-5000", 
  "status": "Active",
  "chain": "ETH",
  "deadline": "2024-12-31",
  "url": "https://...",
  "lastUpdated": "2024-01-01T00:00:00.000Z"
}

🔧 Instalação e Uso

# Instalar dependências
npm install

# Compilar
npm run build

# Executar servidor MCP
npm start

# Ou modo desenvolvimento
npm run dev

🧪 Teste

# Testar scraper
npx tsx test-scraper.ts

🔗 Integração com N8N

  1. Configure o MCP como servidor HTTP

  2. Use nó HTTP Request no N8N

  3. Endpoint: http://localhost:3000/tools/get_best_airdrops

  4. Configure filtros conforme necessário

📱 Exemplo de Fluxo N8N → WhatsApp

[MCP] → [Filtrar Top 5] → [Formatar Mensagem] → [Evolution API] → [WhatsApp]

⚠️ Limitações

  • Site protegido por Cloudflare (usa dados de fallback)

  • Cache de 5 minutos para performance

  • Dados dependem da estrutura do site DeFiLlama

🤝 Contribuição

  1. Fork o projeto

  2. Crie branch para feature

  3. Commit suas mudanças

  4. Push para branch

  5. Abra Pull Request

📄 Licença

MIT License - veja arquivo LICENSE para detalhes.

Available Tools

4 tools
debug_scraperC

Debugar o scraper para verificar se está funcionando corretamente

Inputs: no named parameters.

filter_airdropsC

Filtrar airdrops por critérios específicos

Inputs: chain, minValue, searchTerm, status.

get_airdropsB

Buscar todos os airdrops disponíveis no DeFiLlama

Inputs: chain, forceRefresh, onlyActive.

get_best_airdropsC

Obter os melhores airdrops baseado em critérios de valor e facilidade

Inputs: limit, sortBy.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3/5.0

    Scored across 4 tools

    Disambiguation4/5

    The tools are mostly distinct: get_airdrops retrieves all airdrops, get_best_airdrops filters for top ones, and filter_airdrops allows custom filtering. However, get_best_airdrops and filter_airdrops could be confused since both involve filtering, though their descriptions clarify one is preset criteria and the other is user-defined.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern with snake_case: debug_scraper, filter_airdrops, get_airdrops, and get_best_airdrops. The verbs (debug, filter, get) are clear and appropriately matched to their actions.

    Tool Count3/5

    With 4 tools, the count is borderline thin for a DeFiLlama airdrops server, as it might lack operations like detailed airdrop info, subscription, or status updates. However, it covers core retrieval and filtering functions adequately.

    Completeness3/5

    The server provides basic read and filter operations but has notable gaps: no create, update, or delete tools for managing airdrops, and no tools for user actions like claiming or tracking airdrops. It focuses on retrieval and filtering, which may limit agent workflows.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Provides real-time and historical cryptocurrency market data through integration with major exchanges. This server enables LLMs like Claude to fetch current prices, analyze market trends, and access detailed trading information.
      7
      83
      MIT
    • A
      license
      C
      quality
      D
      maintenance
      Enables searching and retrieving detailed flight information using the Duffel API, supporting various flight types and flexible search parameters for efficient travel planning.
      3
      234
      MIT
    • F
      license
      Not graded
      quality
      Not graded
      maintenance
      Enables interaction with the Artemis API to retrieve and analyze cryptocurrency data, including accessing metrics, generating formulas, and validating API connections.
      18 PyPI
      2
      -