<h1 align="center">ProfitSpot MCP</h1> Cross-chain DeFi intelligence for AI agents. Risk-scored yields, Monte Carlo simulations, whale tracking across 86 chains and 6,500+ pools.

<a href="#-quick-install">Quick Install</a> • <a href="#-example-tool-calls">Examples</a> • <a href="#-tool-reference">Tool Reference</a> • <a href="#-pricing">Pricing</a> • <a href="#-self-hosting">Self-Hosting</a>

---

What is this?

ProfitSpot MCP gives any AI agent — Claude, GPT, Gemini, or your custom agent — instant access to the same DeFi intelligence that powers profitspot.live. Think of it as the Bloomberg Terminal for AI agents.

Existing DeFi MCP servers are either basic DeFiLlama wrappers with 1 tool, or locked to a single chain. ProfitSpot MCP covers 86 chains, 6,500+ pools, and adds an intelligence layer — risk grades, Monte Carlo profit simulation, whale detection — that no competitor has.

No API key required to get started. Free tier gives you yield discovery, market overview, and IL calculations immediately.

---

🚀 Quick Install

Claude Desktop

Add to your claude_desktop_config.json:

<table> <tr><td>macOS</td><td><code>~/Library/Application Support/Claude/claude_desktop_config.json</code></td></tr> <tr><td>Windows</td><td><code>%APPDATA%\Claude\claude_desktop_config.json</code></td></tr> </table>

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

Free tier? Just remove the "env" block entirely. No key needed.

Cursor

Add to .cursor/mcp.json in your project root:

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

VS Code (Copilot)

Add to your .vscode/mcp.json:

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

pip (manual install)

pip install profitspot-mcp

---

💡 Example Tool Calls

Real responses from live DeFiLlama data. Every response includes confidence (0–1) and data_freshness (ISO timestamp).

1. Discover Yields — Ethereum, grade B or better

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

<details> <summary>Full JSON Response (click to expand)</summary>

{
  "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"
}

</details>

What you get: 146 Ethereum pools matched from 16,642 scanned. Each pool comes risk-scored (A–F), with 30-day mean APY and APY prediction direction. Sorted by APY descending.

---

2. Risk Score — Deep breakdown for a Uniswap V3 pool

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

<details> <summary>Full JSON Response (click to expand)</summary>

{
  "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"
}

</details>

What you get: A composite B grade (71/100) with 6-factor breakdown. This pool scores perfectly on protocol reputation (Uniswap is Tier 1 Blue Chip, 48+ months) and security, but gets dinged on APY volatility (CV=1.04) and non-stablecoin pair risk. An AI agent can read this and explain exactly why a pool got its grade.

---

3. Impermanent Loss — ETH +50%, USDC −10%

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

<details> <summary>Full JSON Response (click to expand)</summary>

{
  "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"
}

</details>

What you get: Exact IL of 3.18% ($381) on a $10K position. Your LP is worth $11,619 vs $12,000 if you just held. But here's the key insight — the net_with_fees table shows that even a modest 5% fee APY makes you net +$2,119 (+21.2% ROI). The tool gives your AI agent the full picture to make an informed recommendation.

---

📖 Tool Reference

All 7 tools available through the MCP protocol:

`discover_yields` 🟢 Free

Find top yield opportunities across 86 chains. Filter, risk-score, and rank.

| Parameter | Type | Default | Description | |-----------|------|---------|-------------| | chain | string \| null | null | Filter by chain name (e.g., "Ethereum", "Arbitrum") | | min_tvl | float | 1000000 | Minimum TVL in USD | | min_apy | float | 0 | Minimum APY percentage | | max_risk | string | "F" | Maximum risk grade: A, B, C, D, or F (Pro only) | | limit | int | 20 | Max results to return (Free: 10, Pro: 50) |

---

`analyze_pool` 🔒 Pro

Deep-dive analysis of a single pool: APY trends, risk breakdown, IL scenarios, projected returns.

| Parameter | Type | Default | Description | |-----------|------|---------|-------------| | pool_id | string | required | Pool UUID from discover_yields results |

Returns: Historical APY (7d/30d/90d averages), trend direction, volatility stdev, full risk grade breakdown, IL estimate for 3 divergence scenarios, and projected returns for $1K/$10K/$100K at 30/90/365 days.

---

`calculate_impermanent_loss` 🟢 Always Free

Pure math — exact IL for any 50/50 LP pair. No API call needed.

| Parameter | Type | Default | Description | |-----------|------|---------|-------------| | token_a_price_change | float | required | % price change for token A (e.g., 50 for +50%) | | token_b_price_change | float | required | % price change for token B (e.g., -20 for −20%) | | investment_amount | float | 10000 | Initial investment in USD |

Returns: IL in USD and %, value-if-held vs value-in-LP, net gain/loss at 5%/10%/20%/50% fee APY levels, and a human-readable interpretation.

---

`simulate_profit` 🔒 Pro

Monte Carlo profit projection using Ornstein-Uhlenbeck APY model. 1,000 simulations.

| Parameter | Type | Default | Description | |-----------|------|---------|-------------| | pool_id | string | required | Pool UUID from discover_yields results | | investment | float | 10000 | Investment amount in USD | | days | int | 365 | Projection horizon (1–730 days) | | compound | bool | true | Whether to compound returns daily |

Returns: Bearish/Base/Optimistic scenarios with dollar amounts, full percentile distribution (P5–P95), probability of profit, risk factors, and model parameters.

---

`risk_score` 🔒 Pro

A–F risk grade for any pool or entire protocol. 6-factor weighted breakdown.

| Parameter | Type | Default | Description | |-----------|------|---------|-------------| | pool_id | string \| null | null | Score a specific pool | | protocol | string \| null | null | Score an entire protocol (e.g., "aave-v3") |

At least one parameter required. For protocols, scores the top 10 pools by TVL and returns an aggregate grade.

6 Factors: TVL Stability (25pts), APY Sustainability + Volatility (20pts), Protocol Reputation + Age (20pts), IL Exposure (15pts), Pair Stability (10pts), Security/Audit Proxy (10pts).

---

`track_whales` 🔒 Pro

Detect large capital movements — smart money entering or exiting pools.

| Parameter | Type | Default | Description | |-----------|------|---------|-------------| | chain | string \| null | null | Filter by chain | | min_tvl_change | float | 500000 | Minimum TVL change to flag (USD) | | timeframe | string | "24h" | Detection window |

Returns: List of pools with large TVL changes, direction (inflow/outflow), dollar amount, percentage change, and whether this correlates with APY changes. First call establishes a baseline; subsequent calls detect actual movements.

---

`defi_overview` 🟢 Free (basic) / Pro (full)

Big-picture DeFi dashboard across all chains.

| Parameter | Type | Default | Description | |-----------|------|---------|-------------| | chain | string \| null | null | Filter to a specific chain |

Free: Total TVL, top 10 chains, top 10 protocols, pool counts, average APY. Pro: + Average yields by risk grade, stablecoin market cap, hot opportunities (new pools with rising APY + good risk grade).

---

💰 Pricing

🆓 Free

$0/mo

3 tools, 50 calls/day

No API key needed

</td> <td align="center" width="33%">

⚡ Pro

$29/mo

All 7 tools, 1K calls/day

→ Get Pro

</td> <td align="center" width="33%">

🏢 Enterprise

$99/mo

All 7 tools, 10K calls/day

→ Get Enterprise

</td> </tr> </table>

| | Free | Pro ($29/mo) | Enterprise ($99/mo) | |:---|:---:|:---:|:---:| | discover_yields | ✅ 10 results | ✅ 50 results + risk filter | ✅ 50 results + risk filter | | defi_overview | ✅ Basic | ✅ Full + hot opportunities | ✅ Full + hot opportunities | | calculate_impermanent_loss | ✅ | ✅ | ✅ | | analyze_pool | ❌ | ✅ | ✅ | | simulate_profit | ❌ | ✅ | ✅ | | risk_score | ❌ | ✅ | ✅ | | track_whales | ❌ | ✅ | ✅ | | Daily rate limit | 50 | 1,000 | 10,000 | | Support | Community | Email | Priority |

# Unlock Pro / Enterprise
export PROFITSPOT_API_KEY=ps_live_xxxxxxxxxxxxxxxx

<a href="https://buy.stripe.com/3cIaEZ0Gf1DrgQodvh4wM00">🚀 Get Pro — $29/mo</a>   |   <a href="https://buy.stripe.com/7sY28t9cL81P8jS1Mz4wM01">🏢 Get Enterprise — $99/mo</a>   |   <a href="https://profitspot.live/pricing">Compare Plans</a>

---

🏠 Self-Hosting

Option 1: uvx (recommended)

uvx profitspot-mcp

Zero install, runs directly. Requires uv.

Option 2: pip + run

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

Option 3: Docker

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

Option 4: From source

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

---

🧠 Under the Hood

Risk Grading — 6-Factor Composite Score

Every pool is scored on 100 points across 6 weighted factors:

| Factor | Weight | What It Measures | |--------|:------:|------------------| | TVL Stability | 25 pts | Liquidity depth, rug risk. $100M+ = full marks. | | APY Sustainability | 20 pts | Yield level (is it realistic?) + volatility (stdev from historical data). | | Protocol Reputation | 20 pts | Tier 1/2 classification (Aave, Uniswap, Curve = Tier 1) + estimated age. | | IL Exposure | 15 pts | Single-asset, stablecoin pair, or volatile LP? | | Pair Stability | 10 pts | Stablecoin pool detection for minimal price risk. | | Security/Audit Proxy | 10 pts | Protocol trust signal derived from tier + TVL depth. |

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

Monte Carlo Engine — Not Just `APY × Days`

The simulate_profit tool runs 1,000 simulations using:

Ornstein-Uhlenbeck process — APY reverts toward a long-term mean (high APY pools decay faster)
Geometric Brownian Motion — Simulates impermanent loss from price divergence
Pool failure events — Probability of pool death based on TVL + APY level
APY crash events — Random regime changes where APY drops 60–95%

Returns real dollar amounts across bearish/base/optimistic scenarios.

Data Source

100% powered by DeFiLlama APIs — free, no key, no rate limits. Covers 86+ chains, 6,500+ pools, all major protocols.

---

📄 License

AGPL-3.0 — Free to use, modify, and distribute. Network use (running as a service) requires sharing your modifications under the same license.

---

Built by <a href="https://profitspot.live">ProfitSpot</a> The Bloomberg Terminal for DeFi — now available to every AI agent.

---

🔎 Also check out <a href="https://github.com/omniologynow-rgb/scout-intel-mcp">Scout Intel MCP</a> — business & market intelligence for AI agents. Research any company, market, or competitor in seconds.

profitspot-mcp

What is this?

🚀 Quick Install

Claude Desktop

Cursor

VS Code (Copilot)

pip (manual install)

💡 Example Tool Calls

1. Discover Yields — Ethereum, grade B or better

2. Risk Score — Deep breakdown for a Uniswap V3 pool

3. Impermanent Loss — ETH +50%, USDC −10%

📖 Tool Reference

`discover_yields` 🟢 Free

`analyze_pool` 🔒 Pro

`calculate_impermanent_loss` 🟢 Always Free

`simulate_profit` 🔒 Pro

`risk_score` 🔒 Pro

`track_whales` 🔒 Pro

`defi_overview` 🟢 Free (basic) / Pro (full)

💰 Pricing

🆓 Free

⚡ Pro

🏢 Enterprise

🏠 Self-Hosting

Option 1: uvx (recommended)

Option 2: pip + run

Option 3: Docker

Option 4: From source

🧠 Under the Hood

Risk Grading — 6-Factor Composite Score

Monte Carlo Engine — Not Just `APY × Days`

Data Source

📄 License

Score

Proud of your score? Add this badge to your README.

profitspot-mcp FAQ

How do I install profitspot-mcp?

Is profitspot-mcp an official MCP server?

Related MCP servers

Related guides

profitspot-mcp

What is this?

🚀 Quick Install

Claude Desktop

Cursor

VS Code (Copilot)

pip (manual install)

💡 Example Tool Calls

1. Discover Yields — Ethereum, grade B or better

2. Risk Score — Deep breakdown for a Uniswap V3 pool

3. Impermanent Loss — ETH +50%, USDC −10%

📖 Tool Reference

discover_yields 🟢 Free

analyze_pool 🔒 Pro

calculate_impermanent_loss 🟢 Always Free

simulate_profit 🔒 Pro

risk_score 🔒 Pro

track_whales 🔒 Pro

defi_overview 🟢 Free (basic) / Pro (full)

💰 Pricing

🆓 Free

⚡ Pro

🏢 Enterprise

🏠 Self-Hosting

Option 1: uvx (recommended)

Option 2: pip + run

Option 3: Docker

Option 4: From source

🧠 Under the Hood

Risk Grading — 6-Factor Composite Score

Monte Carlo Engine — Not Just APY × Days

Data Source

📄 License

Score

Proud of your score? Add this badge to your README.

profitspot-mcp FAQ

How do I install profitspot-mcp?

Is profitspot-mcp an official MCP server?

Related MCP servers

Related guides

`discover_yields` 🟢 Free

`analyze_pool` 🔒 Pro

`calculate_impermanent_loss` 🟢 Always Free

`simulate_profit` 🔒 Pro

`risk_score` 🔒 Pro

`track_whales` 🔒 Pro

`defi_overview` 🟢 Free (basic) / Pro (full)

Monte Carlo Engine — Not Just `APY × Days`