ProfitSpot MCP

ProfitSpot MCP

Inteligência DeFi cross-chain para agentes de IA.
Rendimentos com pontuação de risco, simulações de Monte Carlo, rastreamento de baleias
em 86 chains e mais de 6.500 pools.

Instalação Rápida • Exemplos • Referência de Ferramentas • Preços • Self-Hosting

O que é isso?

O ProfitSpot MCP dá a qualquer agente de IA — Claude, GPT, Gemini ou seu agente personalizado — acesso instantâneo à mesma inteligência DeFi que alimenta o profitspot.live. Pense nele como o Terminal Bloomberg para agentes de IA.

Os servidores MCP DeFi existentes são ou wrappers básicos do DeFiLlama com 1 ferramenta, ou limitados a uma única chain. O ProfitSpot MCP cobre 86 chains, mais de 6.500 pools, e adiciona uma camada de inteligência — notas de risco, simulação de lucro Monte Carlo, detecção de baleias — que nenhum concorrente possui.

Nenhuma chave de API necessária para começar. O plano gratuito dá a você descoberta de rendimentos, visão geral do mercado e cálculos de IL imediatamente.

🚀 Instalação Rápida

Claude Desktop

Adicione ao seu claude_desktop_config.json:

{
  "mcpServers": {
    "profitspot": {
      "command": "uvx",
      "args": ["profitspot-mcp"],
      "env": {
        "PROFITSPOT_API_KEY": "your-pro-key-here"
      }
    }
  }
}

Plano gratuito? Basta remover o bloco "env" completamente. Nenhuma chave necessária.

Cursor

Adicione ao .cursor/mcp.json na raiz do seu projeto:

{
  "mcpServers": {
    "profitspot": {
      "command": "uvx",
      "args": ["profitspot-mcp"],
      "env": {
        "PROFITSPOT_API_KEY": "your-pro-key-here"
      }
    }
  }
}

VS Code (Copilot)

Adicione ao seu .vscode/mcp.json:

{
  "servers": {
    "profitspot": {
      "type": "stdio",
      "command": "uvx",
      "args": ["profitspot-mcp"],
      "env": {
        "PROFITSPOT_API_KEY": "your-pro-key-here"
      }
    }
  }
}

pip (instalação manual)

pip install profitspot-mcp

💡 Exemplos de Chamadas de Ferramentas

Respostas reais de dados ao vivo do DeFiLlama. Cada resposta inclui confidence (0–1) e data_freshness (timestamp ISO).

1. Descubra Rendimentos — Ethereum, nota B ou melhor

discover_yields(chain="Ethereum", min_tvl=10000000, min_apy=3, max_risk="B", limit=5)

{
  "data": {
    "pools": [
      {
        "pool_id": "fc9f488e-8183-416f-a61e-4e5c571d4395",
        "symbol": "WETH-USDT",
        "protocol": "uniswap-v3",
        "chain": "Ethereum",
        "apy": 31.53,
        "apy_base": 31.53,
        "apy_reward": 0,
        "apy_mean_30d": 37.11,
        "tvl_usd": 73909084,
        "risk_grade": "B",
        "risk_score": 74,
        "prediction": "Down",
        "stablecoin": false,
        "il_risk": "yes",
        "exposure": "multi"
      },
      {
        "pool_id": "3dd2c646-c05a-4483-98f4-d7a924a6d6d3",
        "symbol": "WBTC-USDT",
        "protocol": "uniswap-v3",
        "chain": "Ethereum",
        "apy": 22.24,
        "apy_base": 22.24,
        "apy_reward": 0,
        "apy_mean_30d": 21.92,
        "tvl_usd": 16180215,
        "risk_grade": "B",
        "risk_score": 74,
        "prediction": "Down",
        "stablecoin": false,
        "il_risk": "yes",
        "exposure": "multi"
      },
      {
        "pool_id": "49717ee2-9808-4288-b76d-e658195b7979",
        "symbol": "USDC-WETH",
        "protocol": "uniswap-v3",
        "chain": "Ethereum",
        "apy": 18.24,
        "apy_base": 18.24,
        "apy_reward": 0,
        "apy_mean_30d": 20.65,
        "tvl_usd": 23656801,
        "risk_grade": "B",
        "risk_score": 78,
        "prediction": "Down",
        "stablecoin": false,
        "il_risk": "yes",
        "exposure": "multi"
      },
      {
        "pool_id": "0d9e7113-c9bc-4fb6-b138-5ca6f6944d6d",
        "symbol": "SDCRV",
        "protocol": "stake-dao",
        "chain": "Ethereum",
        "apy": 17.51,
        "apy_base": 0,
        "apy_reward": 17.51,
        "apy_mean_30d": 16.61,
        "tvl_usd": 26093458,
        "risk_grade": "B",
        "risk_score": 71,
        "prediction": "Down",
        "stablecoin": false,
        "il_risk": "no",
        "exposure": "single"
      }
    ],
    "total_matching": 146,
    "total_scanned": 16642,
    "filters_applied": {
      "chain": "Ethereum",
      "min_tvl": 10000000,
      "min_apy": 3,
      "max_risk": "B",
      "limit": 5
    }
  },
  "confidence": 0.92,
  "data_freshness": "2026-04-12T02:31:10.638795+00:00",
  "tool": "discover_yields",
  "tier": "pro",
  "powered_by": "profitspot.live"
}

O que você obtém: 146 pools Ethereum correspondidos de 16.642 verificados. Cada pool vem com pontuação de risco (A–F), com APY médio de 30 dias e direção de previsão do APY. Ordenados por APY decrescente.

2. Pontuação de Risco — Análise detalhada de um pool Uniswap V3

risk_score(pool_id="fc9f488e-8183-416f-a61e-4e5c571d4395")

{
  "data": {
    "type": "pool",
    "pool_id": "fc9f488e-8183-416f-a61e-4e5c571d4395",
    "symbol": "WETH-USDT",
    "protocol": "uniswap-v3",
    "chain": "Ethereum",
    "grade": "B",
    "score": 71,
    "summary": "Moderate Risk — Solid fundamentals, minor concerns. Good for diversified portfolios.",
    "factors": {
      "tvl_stability": {
        "score": 20,
        "max": 25,
        "detail": "$73.9M TVL — strong"
      },
      "apy_sustainability": {
        "score": 10,
        "max": 20,
        "detail": "31.5% APY — moderate | Volatility: extreme (CV=1.04)"
      },
      "protocol_reputation": {
        "score": 20,
        "max": 20,
        "detail": "uniswap-v3 — Tier 1 Blue Chip (est. 48+ months)"
      },
      "il_exposure": {
        "score": 8,
        "max": 15,
        "detail": "Medium IL — monitor price divergence"
      },
      "pair_stability": {
        "score": 3,
        "max": 10,
        "detail": "Non-stable pair — volatile"
      },
      "security_audit": {
        "score": 10,
        "max": 10,
        "detail": "Blue chip + deep TVL — high confidence"
      }
    }
  },
  "confidence": 0.88,
  "data_freshness": "2026-04-12T02:31:11.516026+00:00",
  "tool": "risk_score",
  "tier": "pro",
  "powered_by": "profitspot.live"
}

O que você obtém: Uma nota composta B (71/100) com análise de 6 fatores. Este pool pontua perfeitamente em reputação do protocolo (Uniswap é Tier 1 Blue Chip, 48+ meses) e segurança, mas é penalizado na volatilidade do APY (CV=1.04) e no risco de par não-stablecoin. Um agente de IA pode ler isso e explicar exatamente por que um pool recebeu sua nota.

3. Perda Impermanente — ETH +50%, USDC −10%

calculate_impermanent_loss(token_a_price_change=50, token_b_price_change=-10, investment_amount=10000)

{
  "data": {
    "token_a_change_pct": 50.0,
    "token_b_change_pct": -10.0,
    "investment_amount": 10000.0,
    "il_percent": 3.1754,
    "il_usd": 381.05,
    "value_if_held": 12000.0,
    "value_in_lp": 11618.95,
    "net_with_fees": {
      "5%": {
        "fees_earned": 500.0,
        "net_gain_usd": 2118.95,
        "net_roi_pct": 21.19
      },
      "10%": {
        "fees_earned": 1000.0,
        "net_gain_usd": 2618.95,
        "net_roi_pct": 26.19
      },
      "20%": {
        "fees_earned": 2000.0,
        "net_gain_usd": 3618.95,
        "net_roi_pct": 36.19
      },
      "50%": {
        "fees_earned": 5000.0,
        "net_gain_usd": 6618.95,
        "net_roi_pct": 66.19
      }
    },
    "interpretation": "Moderate IL — needs decent APY to compensate."
  },
  "confidence": 0.99,
  "data_freshness": "2026-04-12T02:31:11.517000+00:00",
  "tool": "calculate_impermanent_loss",
  "tier": "pro",
  "powered_by": "profitspot.live"
}

O que você obtém: IL exata de 3,18% ($381) em uma posição de $10K. Seu LP vale $11.619 vs $12.000 se você apenas tivesse mantido. Mas aqui está o insight principal — a tabela net_with_fees mostra que mesmo um modesto APY de taxa de 5% torna você +$2.119 (+21,2% ROI) líquido. A ferramenta dá ao seu agente de IA o quadro completo para fazer uma recomendação informada.

📖 Referência de Ferramentas

Todas as 7 ferramentas disponíveis através do protocolo MCP:

discover_yields 🟢 Grátis

Encontre as melhores oportunidades de rendimento em 86 chains. Filtre, pontue por risco e classifique.

analyze_pool 🔒 Pro

Análise aprofundada de um único pool: tendências de APY, análise de risco, cenários de IL, retornos projetados.

Retorna: APY histórico (médias de 7d/30d/90d), direção da tendência, desvio padrão da volatilidade, análise completa da nota de risco, estimativa de IL para 3 cenários de divergência e retornos projetados para $1K/$10K/$100K em 30/90/365 dias.

calculate_impermanent_loss 🟢 Sempre Grátis

Matemática pura — IL exata para qualquer par LP 50/50. Nenhuma chamada de API necessária.

Retorna: IL em USD e %, valor-se-mantido vs valor-no-LP, ganho/perda líquido em níveis de APY de taxa de 5%/10%/20%/50% e uma interpretação legível por humanos.

simulate_profit 🔒 Pro

Projeção de lucro Monte Carlo usando modelo de APY Ornstein-Uhlenbeck. 1.000 simulações.

Retorna: Cenários Pessimista/Base/Otimista com valores em dólares, distribuição completa de percentis (P5–P95), probabilidade de lucro, fatores de risco e parâmetros do modelo.

risk_score 🔒 Pro

Nota de risco A–F para qualquer pool ou protocolo inteiro. Análise ponderada de 6 fatores.

Pelo menos um parâmetro é obrigatório. Para protocolos, pontua os 10 principais pools por TVL e retorna uma nota agregada.

6 Fatores: Estabilidade do TVL (25pts), Sustentabilidade + Volatilidade do APY (20pts), Reputação + Idade do Protocolo (20pts), Exposição a IL (15pts), Estabilidade do Par (10pts), Proxy de Segurança/Auditoria (10pts).

track_whales 🔒 Pro

Detecte grandes movimentos de capital — dinheiro inteligente entrando ou saindo de pools.

Retorna: Lista de pools com grandes mudanças de TVL, direção (entrada/saída), valor em dólares, variação percentual e se isso correlaciona com mudanças de APY. A primeira chamada estabelece uma linha de base; chamadas subsequentes detectam movimentos reais.

defi_overview 🟢 Grátis (básico) / Pro (completo)

Painel DeFi de visão geral em todas as chains.

Grátis: TVL total, 10 principais chains, 10 principais protocolos, contagem de pools, APY médio. Pro: + Rendimentos médios por nota de risco, capitalização de mercado de stablecoins, oportunidades quentes (novos pools com APY crescente + boa nota de risco).

💰 Preços

# Unlock Pro / Enterprise
export PROFITSPOT_API_KEY=ps_live_xxxxxxxxxxxxxxxx

🚀 Obter Pro — $29/mês   |   🏢 Obter Enterprise — $99/mês   |   Comparar Planos

🏠 Self-Hosting

Opção 1: uvx (recomendado)

uvx profitspot-mcp

Instalação zero, executa diretamente. Requer uv.

Opção 2: pip + execução

pip install profitspot-mcp
profitspot-mcp                          # stdio (for MCP clients)
python -m profitspot_mcp                # HTTP/SSE on :8080

Opção 3: Docker

docker build -t profitspot-mcp .
docker run -p 8080:8080 -e PROFITSPOT_API_KEY=your-key profitspot-mcp

Opção 4: A partir do código-fonte

git clone https://github.com/profitspot/profitspot-mcp.git
cd profitspot-mcp
python -m venv .venv && source .venv/bin/activate
pip install -e ".[dev]"

# Development with inspector UI
fastmcp dev run_server.py

# Production
fastmcp run run_server.py --transport sse --port 8080

🧠 Por Dentro do Funcionamento

Classificação de Risco — Pontuação Composta de 6 Fatores

Cada pool é pontuado em 100 pontos em 6 fatores ponderados:

Notas: A (85–100) · B (70–84) · C (55–69) · D (40–54) · F (0–39)

Motor Monte Carlo — Não Apenas APY × Days

A ferramenta simulate_profit executa 1.000 simulações usando:

• Processo Ornstein-Uhlenbeck — O APY reverte em direção a uma média de longo prazo (pools com APY alto decaem mais rápido)
• Movimento Browniano Geométrico — Simula perda impermanente a partir da divergência de preços
• Eventos de falha de pool — Probabilidade de morte do pool com base no nível de TVL + APY
• Eventos de queda de APY — Mudanças aleatórias de regime onde o APY cai 60–95%

Retorna valores reais em dólares em cenários pessimista/base/otimista.

Fonte de Dados

100% alimentado pelas APIs do DeFiLlama — gratuito, sem chave, sem limites de requisições. Cobre 86+ blockchains, 6.500+ pools e todos os principais protocolos.

📄 Licença

AGPL-3.0 — Livre para usar, modificar e distribuir. Uso em rede (execução como serviço) exige compartilhar suas modificações sob a mesma licença.

Desenvolvido por ProfitSpot
_{O Terminal Bloomberg para DeFi — agora disponível para todo agente de IA.}

🔎 Confira também Scout Intel MCP — inteligência de negócios e mercado para agentes de IA. Pesquise qualquer empresa, mercado ou concorrente em segundos.