{ "markdown": "\n

\n

ProfitSpot MCP

\n

\n Cross-chain DeFi intelligence for AI agents.
\n Risk-scored yields, Monte Carlo simulations, whale tracking
\n across 86 chains and 6,500+ pools.\n

\n

\n\n

\n \"PyPI\n \"License:\n \"MCP\n \"Python\n \"Built\n \"PyPI\n

\n\n

\n Quick Install •\n Examples •\n Tool Reference •\n Pricing •\n Self-Hosting\n

\n\n---\n\n## What is this?\n\nProfitSpot 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**.\n\nExisting 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.\n\n**No API key required to get started.** Free tier gives you yield discovery, market overview, and IL calculations immediately.\n\n---\n\n## 🚀 Quick Install\n\n### Claude Desktop\n\nAdd to your `claude_desktop_config.json`:\n\n\n\n\n
macOS~/Library/Application Support/Claude/claude_desktop_config.json
Windows%APPDATA%\\Claude\\claude_desktop_config.json
\n\n```json\n{\n \"mcpServers\": {\n \"profitspot\": {\n \"command\": \"uvx\",\n \"args\": [\"profitspot-mcp\"],\n \"env\": {\n \"PROFITSPOT_API_KEY\": \"your-pro-key-here\"\n }\n }\n }\n}\n```\n\n> **Free tier?** Just remove the `\"env\"` block entirely. No key needed.\n\n### Cursor\n\nAdd to `.cursor/mcp.json` in your project root:\n\n```json\n{\n \"mcpServers\": {\n \"profitspot\": {\n \"command\": \"uvx\",\n \"args\": [\"profitspot-mcp\"],\n \"env\": {\n \"PROFITSPOT_API_KEY\": \"your-pro-key-here\"\n }\n }\n }\n}\n```\n\n### VS Code (Copilot)\n\nAdd to your `.vscode/mcp.json`:\n\n```json\n{\n \"servers\": {\n \"profitspot\": {\n \"type\": \"stdio\",\n \"command\": \"uvx\",\n \"args\": [\"profitspot-mcp\"],\n \"env\": {\n \"PROFITSPOT_API_KEY\": \"your-pro-key-here\"\n }\n }\n }\n}\n```\n\n### pip (manual install)\n\n```bash\npip install profitspot-mcp\n```\n\n---\n\n## 💡 Example Tool Calls\n\nReal responses from live DeFiLlama data. Every response includes `confidence` (0–1) and `data_freshness` (ISO timestamp).\n\n### 1. Discover Yields — Ethereum, grade B or better\n\n```\ndiscover_yields(chain=\"Ethereum\", min_tvl=10000000, min_apy=3, max_risk=\"B\", limit=5)\n```\n\n
\nFull JSON Response (click to expand)\n\n```json\n{\n \"data\": {\n \"pools\": [\n {\n \"pool_id\": \"fc9f488e-8183-416f-a61e-4e5c571d4395\",\n \"symbol\": \"WETH-USDT\",\n \"protocol\": \"uniswap-v3\",\n \"chain\": \"Ethereum\",\n \"apy\": 31.53,\n \"apy_base\": 31.53,\n \"apy_reward\": 0,\n \"apy_mean_30d\": 37.11,\n \"tvl_usd\": 73909084,\n \"risk_grade\": \"B\",\n \"risk_score\": 74,\n \"prediction\": \"Down\",\n \"stablecoin\": false,\n \"il_risk\": \"yes\",\n \"exposure\": \"multi\"\n },\n {\n \"pool_id\": \"3dd2c646-c05a-4483-98f4-d7a924a6d6d3\",\n \"symbol\": \"WBTC-USDT\",\n \"protocol\": \"uniswap-v3\",\n \"chain\": \"Ethereum\",\n \"apy\": 22.24,\n \"apy_base\": 22.24,\n \"apy_reward\": 0,\n \"apy_mean_30d\": 21.92,\n \"tvl_usd\": 16180215,\n \"risk_grade\": \"B\",\n \"risk_score\": 74,\n \"prediction\": \"Down\",\n \"stablecoin\": false,\n \"il_risk\": \"yes\",\n \"exposure\": \"multi\"\n },\n {\n \"pool_id\": \"49717ee2-9808-4288-b76d-e658195b7979\",\n \"symbol\": \"USDC-WETH\",\n \"protocol\": \"uniswap-v3\",\n \"chain\": \"Ethereum\",\n \"apy\": 18.24,\n \"apy_base\": 18.24,\n \"apy_reward\": 0,\n \"apy_mean_30d\": 20.65,\n \"tvl_usd\": 23656801,\n \"risk_grade\": \"B\",\n \"risk_score\": 78,\n \"prediction\": \"Down\",\n \"stablecoin\": false,\n \"il_risk\": \"yes\",\n \"exposure\": \"multi\"\n },\n {\n \"pool_id\": \"0d9e7113-c9bc-4fb6-b138-5ca6f6944d6d\",\n \"symbol\": \"SDCRV\",\n \"protocol\": \"stake-dao\",\n \"chain\": \"Ethereum\",\n \"apy\": 17.51,\n \"apy_base\": 0,\n \"apy_reward\": 17.51,\n \"apy_mean_30d\": 16.61,\n \"tvl_usd\": 26093458,\n \"risk_grade\": \"B\",\n \"risk_score\": 71,\n \"prediction\": \"Down\",\n \"stablecoin\": false,\n \"il_risk\": \"no\",\n \"exposure\": \"single\"\n }\n ],\n \"total_matching\": 146,\n \"total_scanned\": 16642,\n \"filters_applied\": {\n \"chain\": \"Ethereum\",\n \"min_tvl\": 10000000,\n \"min_apy\": 3,\n \"max_risk\": \"B\",\n \"limit\": 5\n }\n },\n \"confidence\": 0.92,\n \"data_freshness\": \"2026-04-12T02:31:10.638795+00:00\",\n \"tool\": \"discover_yields\",\n \"tier\": \"pro\",\n \"powered_by\": \"profitspot.live\"\n}\n```\n\n
\n\n**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.\n\n---\n\n### 2. Risk Score — Deep breakdown for a Uniswap V3 pool\n\n```\nrisk_score(pool_id=\"fc9f488e-8183-416f-a61e-4e5c571d4395\")\n```\n\n
\nFull JSON Response (click to expand)\n\n```json\n{\n \"data\": {\n \"type\": \"pool\",\n \"pool_id\": \"fc9f488e-8183-416f-a61e-4e5c571d4395\",\n \"symbol\": \"WETH-USDT\",\n \"protocol\": \"uniswap-v3\",\n \"chain\": \"Ethereum\",\n \"grade\": \"B\",\n \"score\": 71,\n \"summary\": \"Moderate Risk — Solid fundamentals, minor concerns. Good for diversified portfolios.\",\n \"factors\": {\n \"tvl_stability\": {\n \"score\": 20,\n \"max\": 25,\n \"detail\": \"$73.9M TVL — strong\"\n },\n \"apy_sustainability\": {\n \"score\": 10,\n \"max\": 20,\n \"detail\": \"31.5% APY — moderate | Volatility: extreme (CV=1.04)\"\n },\n \"protocol_reputation\": {\n \"score\": 20,\n \"max\": 20,\n \"detail\": \"uniswap-v3 — Tier 1 Blue Chip (est. 48+ months)\"\n },\n \"il_exposure\": {\n \"score\": 8,\n \"max\": 15,\n \"detail\": \"Medium IL — monitor price divergence\"\n },\n \"pair_stability\": {\n \"score\": 3,\n \"max\": 10,\n \"detail\": \"Non-stable pair — volatile\"\n },\n \"security_audit\": {\n \"score\": 10,\n \"max\": 10,\n \"detail\": \"Blue chip + deep TVL — high confidence\"\n }\n }\n },\n \"confidence\": 0.88,\n \"data_freshness\": \"2026-04-12T02:31:11.516026+00:00\",\n \"tool\": \"risk_score\",\n \"tier\": \"pro\",\n \"powered_by\": \"profitspot.live\"\n}\n```\n\n
\n\n**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.\n\n---\n\n### 3. Impermanent Loss — ETH +50%, USDC −10%\n\n```\ncalculate_impermanent_loss(token_a_price_change=50, token_b_price_change=-10, investment_amount=10000)\n```\n\n
\nFull JSON Response (click to expand)\n\n```json\n{\n \"data\": {\n \"token_a_change_pct\": 50.0,\n \"token_b_change_pct\": -10.0,\n \"investment_amount\": 10000.0,\n \"il_percent\": 3.1754,\n \"il_usd\": 381.05,\n \"value_if_held\": 12000.0,\n \"value_in_lp\": 11618.95,\n \"net_with_fees\": {\n \"5%\": {\n \"fees_earned\": 500.0,\n \"net_gain_usd\": 2118.95,\n \"net_roi_pct\": 21.19\n },\n \"10%\": {\n \"fees_earned\": 1000.0,\n \"net_gain_usd\": 2618.95,\n \"net_roi_pct\": 26.19\n },\n \"20%\": {\n \"fees_earned\": 2000.0,\n \"net_gain_usd\": 3618.95,\n \"net_roi_pct\": 36.19\n },\n \"50%\": {\n \"fees_earned\": 5000.0,\n \"net_gain_usd\": 6618.95,\n \"net_roi_pct\": 66.19\n }\n },\n \"interpretation\": \"Moderate IL — needs decent APY to compensate.\"\n },\n \"confidence\": 0.99,\n \"data_freshness\": \"2026-04-12T02:31:11.517000+00:00\",\n \"tool\": \"calculate_impermanent_loss\",\n \"tier\": \"pro\",\n \"powered_by\": \"profitspot.live\"\n}\n```\n\n
\n\n**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.\n\n---\n\n## 📖 Tool Reference\n\nAll 7 tools available through the MCP protocol:\n\n### `discover_yields` 🟢 Free\n\n> Find top yield opportunities across 86 chains. Filter, risk-score, and rank.\n\n| Parameter | Type | Default | Description |\n|-----------|------|---------|-------------|\n| `chain` | `string \\| null` | `null` | Filter by chain name (e.g., `\"Ethereum\"`, `\"Arbitrum\"`) |\n| `min_tvl` | `float` | `1000000` | Minimum TVL in USD |\n| `min_apy` | `float` | `0` | Minimum APY percentage |\n| `max_risk` | `string` | `\"F\"` | Maximum risk grade: `A`, `B`, `C`, `D`, or `F` *(Pro only)* |\n| `limit` | `int` | `20` | Max results to return (Free: 10, Pro: 50) |\n\n---\n\n### `analyze_pool` 🔒 Pro\n\n> Deep-dive analysis of a single pool: APY trends, risk breakdown, IL scenarios, projected returns.\n\n| Parameter | Type | Default | Description |\n|-----------|------|---------|-------------|\n| `pool_id` | `string` | *required* | Pool UUID from `discover_yields` results |\n\n**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.\n\n---\n\n### `calculate_impermanent_loss` 🟢 Always Free\n\n> Pure math — exact IL for any 50/50 LP pair. No API call needed.\n\n| Parameter | Type | Default | Description |\n|-----------|------|---------|-------------|\n| `token_a_price_change` | `float` | *required* | % price change for token A (e.g., `50` for +50%) |\n| `token_b_price_change` | `float` | *required* | % price change for token B (e.g., `-20` for −20%) |\n| `investment_amount` | `float` | `10000` | Initial investment in USD |\n\n**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.\n\n---\n\n### `simulate_profit` 🔒 Pro\n\n> Monte Carlo profit projection using Ornstein-Uhlenbeck APY model. 1,000 simulations.\n\n| Parameter | Type | Default | Description |\n|-----------|------|---------|-------------|\n| `pool_id` | `string` | *required* | Pool UUID from `discover_yields` results |\n| `investment` | `float` | `10000` | Investment amount in USD |\n| `days` | `int` | `365` | Projection horizon (1–730 days) |\n| `compound` | `bool` | `true` | Whether to compound returns daily |\n\n**Returns:** Bearish/Base/Optimistic scenarios with dollar amounts, full percentile distribution (P5–P95), probability of profit, risk factors, and model parameters.\n\n---\n\n### `risk_score` 🔒 Pro\n\n> A–F risk grade for any pool or entire protocol. 6-factor weighted breakdown.\n\n| Parameter | Type | Default | Description |\n|-----------|------|---------|-------------|\n| `pool_id` | `string \\| null` | `null` | Score a specific pool |\n| `protocol` | `string \\| null` | `null` | Score an entire protocol (e.g., `\"aave-v3\"`) |\n\nAt least one parameter required. For protocols, scores the top 10 pools by TVL and returns an aggregate grade.\n\n**6 Factors:** TVL Stability (25pts), APY Sustainability + Volatility (20pts), Protocol Reputation + Age (20pts), IL Exposure (15pts), Pair Stability (10pts), Security/Audit Proxy (10pts).\n\n---\n\n### `track_whales` 🔒 Pro\n\n> Detect large capital movements — smart money entering or exiting pools.\n\n| Parameter | Type | Default | Description |\n|-----------|------|---------|-------------|\n| `chain` | `string \\| null` | `null` | Filter by chain |\n| `min_tvl_change` | `float` | `500000` | Minimum TVL change to flag (USD) |\n| `timeframe` | `string` | `\"24h\"` | Detection window |\n\n**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.\n\n---\n\n### `defi_overview` 🟢 Free (basic) / Pro (full)\n\n> Big-picture DeFi dashboard across all chains.\n\n| Parameter | Type | Default | Description |\n|-----------|------|---------|-------------|\n| `chain` | `string \\| null` | `null` | Filter to a specific chain |\n\n**Free:** Total TVL, top 10 chains, top 10 protocols, pool counts, average APY.\n**Pro:** + Average yields by risk grade, stablecoin market cap, hot opportunities (new pools with rising APY + good risk grade).\n\n---\n\n## 💰 Pricing\n\n\n\n\n\n\n\n
\n\n### 🆓 Free\n**$0/mo**\n\n3 tools, 50 calls/day\n\nNo API key needed\n\n\n\n### ⚡ Pro\n**$29/mo**\n\nAll 7 tools, 1K calls/day\n\n[**→ Get Pro**](https://buy.stripe.com/3cIaEZ0Gf1DrgQodvh4wM00)\n\n\n\n### 🏢 Enterprise\n**$99/mo**\n\nAll 7 tools, 10K calls/day\n\n[**→ Get Enterprise**](https://buy.stripe.com/7sY28t9cL81P8jS1Mz4wM01)\n\n
\n\n| | Free | Pro ($29/mo) | Enterprise ($99/mo) |\n|:---|:---:|:---:|:---:|\n| `discover_yields` | ✅ 10 results | ✅ 50 results + risk filter | ✅ 50 results + risk filter |\n| `defi_overview` | ✅ Basic | ✅ Full + hot opportunities | ✅ Full + hot opportunities |\n| `calculate_impermanent_loss` | ✅ | ✅ | ✅ |\n| `analyze_pool` | ❌ | ✅ | ✅ |\n| `simulate_profit` | ❌ | ✅ | ✅ |\n| `risk_score` | ❌ | ✅ | ✅ |\n| `track_whales` | ❌ | ✅ | ✅ |\n| **Daily rate limit** | 50 | 1,000 | 10,000 |\n| **Support** | Community | Email | Priority |\n\n```bash\n# Unlock Pro / Enterprise\nexport PROFITSPOT_API_KEY=ps_live_xxxxxxxxxxxxxxxx\n```\n\n

\n 🚀 Get Pro — $29/mo\n   |  \n 🏢 Get Enterprise — $99/mo\n   |  \n Compare Plans\n

\n\n---\n\n## 🏠 Self-Hosting\n\n### Option 1: uvx (recommended)\n\n```bash\nuvx profitspot-mcp\n```\n\nZero install, runs directly. Requires [uv](https://docs.astral.sh/uv/).\n\n### Option 2: pip + run\n\n```bash\npip install profitspot-mcp\nprofitspot-mcp # stdio (for MCP clients)\npython -m profitspot_mcp # HTTP/SSE on :8080\n```\n\n### Option 3: Docker\n\n```bash\ndocker build -t profitspot-mcp .\ndocker run -p 8080:8080 -e PROFITSPOT_API_KEY=your-key profitspot-mcp\n```\n\n### Option 4: From source\n\n```bash\ngit clone https://github.com/profitspot/profitspot-mcp.git\ncd profitspot-mcp\npython -m venv .venv && source .venv/bin/activate\npip install -e \".[dev]\"\n\n# Development with inspector UI\nfastmcp dev run_server.py\n\n# Production\nfastmcp run run_server.py --transport sse --port 8080\n```\n\n---\n\n## 🧠 Under the Hood\n\n### Risk Grading — 6-Factor Composite Score\n\nEvery pool is scored on 100 points across 6 weighted factors:\n\n| Factor | Weight | What It Measures |\n|--------|:------:|------------------|\n| TVL Stability | 25 pts | Liquidity depth, rug risk. $100M+ = full marks. |\n| APY Sustainability | 20 pts | Yield level (is it realistic?) + volatility (stdev from historical data). |\n| Protocol Reputation | 20 pts | Tier 1/2 classification (Aave, Uniswap, Curve = Tier 1) + estimated age. |\n| IL Exposure | 15 pts | Single-asset, stablecoin pair, or volatile LP? |\n| Pair Stability | 10 pts | Stablecoin pool detection for minimal price risk. |\n| Security/Audit Proxy | 10 pts | Protocol trust signal derived from tier + TVL depth. |\n\n**Grades:** A (85–100) · B (70–84) · C (55–69) · D (40–54) · F (0–39)\n\n### Monte Carlo Engine — Not Just `APY × Days`\n\nThe `simulate_profit` tool runs **1,000 simulations** using:\n\n- **Ornstein-Uhlenbeck process** — APY reverts toward a long-term mean (high APY pools decay faster)\n- **Geometric Brownian Motion** — Simulates impermanent loss from price divergence\n- **Pool failure events** — Probability of pool death based on TVL + APY level\n- **APY crash events** — Random regime changes where APY drops 60–95%\n\nReturns real dollar amounts across bearish/base/optimistic scenarios.\n\n### Data Source\n\n100% powered by [**DeFiLlama**](https://defillama.com/) APIs — free, no key, no rate limits. Covers 86+ chains, 6,500+ pools, all major protocols.\n\n---\n\n## 📄 License\n\n[AGPL-3.0](LICENSE) — Free to use, modify, and distribute. Network use (running as a service) requires sharing your modifications under the same license.\n\n---\n\n

\n Built by ProfitSpot
\n The Bloomberg Terminal for DeFi — now available to every AI agent.\n

\n\n---\n\n

\n 🔎 Also check out Scout Intel MCP — business & market intelligence for AI agents. Research any company, market, or competitor in seconds.\n

", "bytes": 18255, "sha": "bacdccd587acdc360d89120c456cba891d9577974fbb9d91f8587fd0e0ecec95", "repo_slug": "", "fonte": "pypi", "truncated": false, "api": "https://agentalog.com/api/listings/mcp_io_github_omniologynow_rgb_profitspot_mc_170bb219/readme" }