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.
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ámetro | Tipo | Predeterminado | Descripción |
|---|---|---|---|
chain | string | null | null | Filtra por nombre de cadena (p. ej., "Ethereum", "Arbitrum") |
min_tvl | float | 1000000 | TVL mínimo en USD |
min_apy | float | 0 | Porcentaje de APY mínimo |
max_risk | string | "F" | Calificación de riesgo máxima: A, B, C, D o F (solo Pro) |
limit | int | 20 | Má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ámetro | Tipo | Predeterminado | Descripción |
|---|---|---|---|
pool_id | string | obligatorio | UUID 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ámetro | Tipo | Predeterminado | Descripción |
|---|---|---|---|
token_a_price_change | float | obligatorio | % de cambio de precio para el token A (p. ej., 50 para +50%) |
token_b_price_change | float | obligatorio | % de cambio de precio para el token B (p. ej., -20 para −20%) |
investment_amount | float | 10000 | Inversió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ámetro | Tipo | Predeterminado | Descripción |
|---|---|---|---|
pool_id | string | obligatorio | UUID del pool de los resultados de discover_yields |
investment | float | 10000 | Monto de inversión en USD |
days | int | 365 | Horizonte de proyección (1–730 días) |
compound | bool | true | Si 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ámetro | Tipo | Predeterminado | Descripción |
|---|---|---|---|
pool_id | string | null | null | Puntúa un pool específico |
protocol | string | null | null | Puntú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ámetro | Tipo | Predeterminado | Descripción |
|---|---|---|---|
chain | string | null | null | Filtra por cadena |
min_tvl_change | float | 500000 | Cambio mínimo de TVL para marcar (USD) |
timeframe | string | "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ámetro | Tipo | Predeterminado | Descripción |
|---|---|---|---|
chain | string | null | null | Filtra 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 |
🏢 Empresa$99/mes Las 7 herramientas, 10K llamadas/día |
| Gratis | Pro ($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 llamadas | 50 | 1,000 | 10,000 |
| Soporte | Comunidad | Correo electrónico | Prioritario |
# 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:
| Factor | Peso | Qué mide |
|---|---|---|
| Estabilidad de TVL | 25 pts | Profundidad de liquidez, riesgo de rug pull. $100M+ = puntuación completa. |
| Sostenibilidad del APY | 20 pts | Nivel de rendimiento (¿es realista?) + volatilidad (desviación estándar de datos históricos). |
| Reputación del protocolo | 20 pts | Clasificación Tier 1/2 (Aave, Uniswap, Curve = Tier 1) + edad estimada. |
| Exposición a IL | 15 pts | ¿Activo único, par de stablecoins o LP volátil? |
| Estabilidad del par | 10 pts | Detección de pool de stablecoins para riesgo de precio mínimo. |
| Proxy de seguridad/auditoría | 10 pts | Señ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.