ProfitSpot MCP

Inteligencia DeFi entre cadenas para agentes de IA: 86 cadenas, más de 6500 pools, simulaciones de Monte Carlo

Documentación

ProfitSpot MCP

Inteligencia DeFi cross-chain para agentes de IA.
Rendimientos con puntuación de riesgo, simulaciones de Monte Carlo, seguimiento de ballenas
en 86 cadenas y más de 6,500 pools.

PyPI version License: AGPL-3.0 MCP Compatible Python 3.11+ Built by ProfitSpot PyPI Downloads/month

Instalación rápida • Ejemplos • Referencia de herramientas • Precios • Autoalojamiento


¿Qué es esto?

ProfitSpot MCP brinda a cualquier agente de IA — Claude, GPT, Gemini, o tu agente personalizado — acceso instantáneo a la misma inteligencia DeFi que impulsa profitspot.live. Piénsalo como el Bloomberg Terminal para agentes de IA.

Los servidores MCP DeFi existentes son o envoltorios básicos de DeFiLlama con 1 herramienta, o están limitados a una sola cadena. ProfitSpot MCP cubre 86 cadenas, más de 6,500 pools, y añade una capa de inteligencia — calificaciones de riesgo, simulación de ganancias Monte Carlo, detección de ballenas — que ningún competidor tiene.

No se requiere clave API para comenzar. El plan gratuito te brinda descubrimiento de rendimientos, visión general del mercado y cálculos de pérdida impermanente de inmediato.


🚀 Instalación rápida

Claude Desktop

Añade a tu claude_desktop_config.json:

macOS~/Library/Application Support/Claude/claude_desktop_config.json
Windows%APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "profitspot": {
      "command": "uvx",
      "args": ["profitspot-mcp"],
      "env": {
        "PROFITSPOT_API_KEY": "your-pro-key-here"
      }
    }
  }
}

¿Plan gratuito? Simplemente elimina el bloque "env" por completo. No se necesita clave.

Cursor

Añade a .cursor/mcp.json en la raíz de tu proyecto:

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

VS Code (Copilot)

Añade a tu .vscode/mcp.json:

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

pip (instalación manual)

pip install profitspot-mcp

💡 Ejemplos de llamadas a herramientas

Respuestas reales de datos en vivo de DeFiLlama. Cada respuesta incluye confidence (0–1) y data_freshness (marca de tiempo ISO).

1. Descubre rendimientos — Ethereum, calificación B o mejor

discover_yields(chain="Ethereum", min_tvl=10000000, min_apy=3, max_risk="B", limit=5)
Respuesta JSON completa (clic para expandir)
{
  "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"
}

Lo que obtienes: 146 pools de Ethereum coincidieron de 16,642 escaneados. Cada pool viene con puntuación de riesgo (A–F), con APY medio de 30 días y dirección de predicción del APY. Ordenados por APY descendente.


2. Puntuación de riesgo — Desglose detallado para un pool de Uniswap V3

risk_score(pool_id="fc9f488e-8183-416f-a61e-4e5c571d4395")
Respuesta JSON completa (clic para expandir)
{
  "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"
}

Lo que obtienes: Una calificación B compuesta (71/100) con desglose de 6 factores. Este pool puntúa perfectamente en reputación del protocolo (Uniswap es Tier 1 Blue Chip, más de 48 meses) y seguridad, pero se ve penalizado por la volatilidad del APY (CV=1.04) y el riesgo de par no estable. Un agente de IA puede leer esto y explicar exactamente por qué un pool obtuvo su calificación.


3. Pérdida impermanente — ETH +50%, USDC −10%

calculate_impermanent_loss(token_a_price_change=50, token_b_price_change=-10, investment_amount=10000)
Respuesta JSON completa (clic para expandir)
{
  "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"
}

Lo que obtienes: IL exacta de 3.18% ($381) en una posición de $10K. Tu LP vale $11,619 frente a $12,000 si simplemente hubieras mantenido. Pero aquí está la idea clave — la tabla net_with_fees muestra que incluso un modesto APY de comisión del 5% te hace neto +$2,119 (+21.2% ROI). La herramienta le da a tu agente de IA la imagen completa para tomar una recomendación informada.


📖 Referencia de herramientas

Las 7 herramientas disponibles a través del protocolo MCP:

discover_yields 🟢 Gratis

Encuentra las mejores oportunidades de rendimiento en 86 cadenas. Filtra, puntúa por riesgo y clasifica.

ParámetroTipoPredeterminadoDescripción
chainstring | nullnullFiltra por nombre de cadena (p. ej., "Ethereum", "Arbitrum")
min_tvlfloat1000000TVL mínimo en USD
min_apyfloat0Porcentaje de APY mínimo
max_riskstring"F"Calificación de riesgo máxima: A, B, C, D o F (solo Pro)
limitint20Máximo de resultados a devolver (Gratis: 10, Pro: 50)

analyze_pool 🔒 Pro

Análisis profundo de un solo pool: tendencias de APY, desglose de riesgo, escenarios de IL, rendimientos proyectados.

ParámetroTipoPredeterminadoDescripción
pool_idstringobligatorioUUID del pool de los resultados de discover_yields

Devuelve: APY histórico (promedios de 7d/30d/90d), dirección de la tendencia, desviación estándar de volatilidad, desglose completo de la calificación de riesgo, estimación de IL para 3 escenarios de divergencia y rendimientos proyectados para $1K/$10K/$100K a 30/90/365 días.


calculate_impermanent_loss 🟢 Siempre gratis

Matemática pura — IL exacta para cualquier par LP 50/50. No se necesita llamada API.

ParámetroTipoPredeterminadoDescripción
token_a_price_changefloatobligatorio% de cambio de precio para el token A (p. ej., 50 para +50%)
token_b_price_changefloatobligatorio% de cambio de precio para el token B (p. ej., -20 para −20%)
investment_amountfloat10000Inversión inicial en USD

Devuelve: IL en USD y %, valor-si-se-mantuvo vs valor-en-LP, ganancia/pérdida neta en niveles de APY de comisión del 5%/10%/20%/50%, y una interpretación legible para humanos.


simulate_profit 🔒 Pro

Proyección de ganancias Monte Carlo usando modelo de APY Ornstein-Uhlenbeck. 1,000 simulaciones.

ParámetroTipoPredeterminadoDescripción
pool_idstringobligatorioUUID del pool de los resultados de discover_yields
investmentfloat10000Monto de inversión en USD
daysint365Horizonte de proyección (1–730 días)
compoundbooltrueSi se componen los rendimientos diariamente

Devuelve: Escenarios bajista/base/optimista con montos en dólares, distribución percentil completa (P5–P95), probabilidad de ganancia, factores de riesgo y parámetros del modelo.


risk_score 🔒 Pro

Calificación de riesgo A–F para cualquier pool o protocolo completo. Desglose ponderado de 6 factores.

ParámetroTipoPredeterminadoDescripción
pool_idstring | nullnullPuntúa un pool específico
protocolstring | nullnullPuntúa un protocolo completo (p. ej., "aave-v3")

Se requiere al menos un parámetro. Para protocolos, puntúa los 10 mejores pools por TVL y devuelve una calificación agregada.

6 Factores: Estabilidad de TVL (25 pts), Sostenibilidad + Volatilidad del APY (20 pts), Reputación + Edad del Protocolo (20 pts), Exposición a IL (15 pts), Estabilidad del Par (10 pts), Proxy de Seguridad/Auditoría (10 pts).


track_whales 🔒 Pro

Detecta movimientos grandes de capital — dinero inteligente entrando o saliendo de pools.

ParámetroTipoPredeterminadoDescripción
chainstring | nullnullFiltra por cadena
min_tvl_changefloat500000Cambio mínimo de TVL para marcar (USD)
timeframestring"24h"Ventana de detección

Devuelve: Lista de pools con cambios grandes de TVL, dirección (entrada/salida), monto en dólares, cambio porcentual y si esto se correlaciona con cambios en el APY. La primera llamada establece una línea base; las llamadas posteriores detectan movimientos reales.


defi_overview 🟢 Gratis (básico) / Pro (completo)

Panel DeFi de visión general en todas las cadenas.

ParámetroTipoPredeterminadoDescripción
chainstring | nullnullFiltra a una cadena específica

Gratis: TVL total, top 10 cadenas, top 10 protocolos, conteos de pools, APY promedio. Pro: + Rendimientos promedio por calificación de riesgo, capitalización de mercado de stablecoins, oportunidades destacadas (pools nuevos con APY creciente + buena calificación de riesgo).


💰 Precios

🆓 Gratis

$0/mes

3 herramientas, 50 llamadas/día

No se necesita clave API

⚡ Pro

$29/mes

Las 7 herramientas, 1K llamadas/día

→ Obtener Pro

🏢 Empresa

$99/mes

Las 7 herramientas, 10K llamadas/día

→ Obtener Empresa

GratisPro ($29/mes)Empresa ($99/mes)
discover_yields✅ 10 resultados✅ 50 resultados + filtro de riesgo✅ 50 resultados + filtro de riesgo
defi_overview✅ Básico✅ Completo + oportunidades destacadas✅ Completo + oportunidades destacadas
calculate_impermanent_loss✅✅✅
analyze_pool❌✅✅
simulate_profit❌✅✅
risk_score❌✅✅
track_whales❌✅✅
Límite diario de llamadas501,00010,000
SoporteComunidadCorreo electrónicoPrioritario
# Unlock Pro / Enterprise
export PROFITSPOT_API_KEY=ps_live_xxxxxxxxxxxxxxxx

🚀 Obtener Pro — $29/mes   |   🏢 Obtener Empresa — $99/mes   |   Comparar planes


🏠 Autoalojamiento

Opción 1: uvx (recomendada)

uvx profitspot-mcp

Instalación cero, se ejecuta directamente. Requiere uv.

Opción 2: pip + ejecutar

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

Opción 3: Docker

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

Opción 4: Desde el código fuente

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

🧠 Bajo el capó

Calificación de riesgo — Puntuación compuesta de 6 factores

Cada pool se puntúa sobre 100 puntos en 6 factores ponderados:

FactorPesoQué mide
Estabilidad de TVL25 ptsProfundidad de liquidez, riesgo de rug pull. $100M+ = puntuación completa.
Sostenibilidad del APY20 ptsNivel de rendimiento (¿es realista?) + volatilidad (desviación estándar de datos históricos).
Reputación del protocolo20 ptsClasificación Tier 1/2 (Aave, Uniswap, Curve = Tier 1) + edad estimada.
Exposición a IL15 pts¿Activo único, par de stablecoins o LP volátil?
Estabilidad del par10 ptsDetección de pool de stablecoins para riesgo de precio mínimo.
Proxy de seguridad/auditoría10 ptsSeñal de confianza del protocolo derivada del tier + profundidad de TVL.

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

Motor Monte Carlo — No solo APY × Days

La herramienta simulate_profit ejecuta 1,000 simulaciones usando:

  • Proceso de Ornstein-Uhlenbeck — El APY revierte hacia una media a largo plazo (los pools con APY alto decaen más rápido)
  • Movimiento Browniano Geométrico — Simula la pérdida impermanente por divergencia de precios
  • Eventos de fallo del pool — Probabilidad de muerte del pool basada en el nivel de TVL + APY
  • Eventos de caída del APY — Cambios de régimen aleatorios donde el APY cae 60–95%

Devuelve montos reales en dólares en escenarios bajista/base/optimista.

Fuente de datos

100% impulsado por las APIs de DeFiLlama — gratis, sin clave, sin límites de tasa. Cubre más de 86 cadenas, más de 6,500 pools, todos los protocolos principales.


📄 Licencia

AGPL-3.0 — Libre de usar, modificar y distribuir. El uso en red (ejecutarlo como servicio) requiere compartir tus modificaciones bajo la misma licencia.


Creado por ProfitSpot
El Bloomberg Terminal para DeFi — ahora disponible para cada agente de IA.


🔎 También echa un vistazo a Scout Intel MCP — inteligencia empresarial y de mercado para agentes de IA. Investiga cualquier empresa, mercado o competidor en segundos.