ProfitSpot MCP
Cross-chain DeFi intelligence for AI agents.
Risk-scored yields, Monte Carlo simulations, whale tracking
across 86 chains and 6,500+ pools.
Quick Install •
Examples •
Tool Reference •
Pricing •
Self-Hosting
---
## 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](https://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`:
| macOS | ~/Library/Application Support/Claude/claude_desktop_config.json |
| Windows | %APPDATA%\Claude\claude_desktop_config.json |
```json
{
"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:
```json
{
"mcpServers": {
"profitspot": {
"command": "uvx",
"args": ["profitspot-mcp"],
"env": {
"PROFITSPOT_API_KEY": "your-pro-key-here"
}
}
}
}
```
### VS Code (Copilot)
Add to your `.vscode/mcp.json`:
```json
{
"servers": {
"profitspot": {
"type": "stdio",
"command": "uvx",
"args": ["profitspot-mcp"],
"env": {
"PROFITSPOT_API_KEY": "your-pro-key-here"
}
}
}
}
```
### pip (manual install)
```bash
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)
```
Full JSON Response (click to expand)
```json
{
"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"
}
```
**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")
```
Full JSON Response (click to expand)
```json
{
"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"
}
```
**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)
```
Full JSON Response (click to expand)
```json
{
"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"
}
```
**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
|
### ⚡ Pro
**$29/mo**
All 7 tools, 1K calls/day
[**→ Get Pro**](https://buy.stripe.com/3cIaEZ0Gf1DrgQodvh4wM00)
|
### 🏢 Enterprise
**$99/mo**
All 7 tools, 10K calls/day
[**→ Get Enterprise**](https://buy.stripe.com/7sY28t9cL81P8jS1Mz4wM01)
|
| | 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 |
```bash
# Unlock Pro / Enterprise
export PROFITSPOT_API_KEY=ps_live_xxxxxxxxxxxxxxxx
```
🚀 Get Pro — $29/mo
|
🏢 Get Enterprise — $99/mo
|
Compare Plans
---
## 🏠 Self-Hosting
### Option 1: uvx (recommended)
```bash
uvx profitspot-mcp
```
Zero install, runs directly. Requires [uv](https://docs.astral.sh/uv/).
### Option 2: pip + run
```bash
pip install profitspot-mcp
profitspot-mcp # stdio (for MCP clients)
python -m profitspot_mcp # HTTP/SSE on :8080
```
### Option 3: Docker
```bash
docker build -t profitspot-mcp .
docker run -p 8080:8080 -e PROFITSPOT_API_KEY=your-key profitspot-mcp
```
### Option 4: From source
```bash
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**](https://defillama.com/) APIs — free, no key, no rate limits. Covers 86+ chains, 6,500+ pools, all major protocols.
---
## 📄 License
[AGPL-3.0](LICENSE) — Free to use, modify, and distribute. Network use (running as a service) requires sharing your modifications under the same license.
---
Built by ProfitSpot
The Bloomberg Terminal for DeFi — now available to every AI agent.
---
🔎 Also check out Scout Intel MCP — business & market intelligence for AI agents. Research any company, market, or competitor in seconds.