@sharpe-labs/mcp-server

Model Context Protocol (MCP) server for the Sharpe crypto derivatives and market data API. Enables AI agents (Claude, Cursor, Windsurf, etc.) to query real-time crypto market data including funding rates, futures, options, arbitrage opportunities, narratives, ecosystems, and more.

Installation

npx (no install)

npx @sharpe-labs/mcp-server

Global install

npm install -g @sharpe-labs/mcp-server
sharpe-mcp

Configuration

Environment Variables

| Variable | Required | Default | Description | |---|---|---|---| | SHARPE_API_KEY | No | — | Your Sharpe API key (sk_...). When set, uses the authenticated /v1/ endpoints with higher rate limits. | | SHARPE_API_URL | No | https://api.sharpe.ai | Base URL for the authenticated API. |

Without an API key, the server falls back to the free public endpoints at https://www.sharpe.ai/api/.

Claude Desktop

Add to your claude_desktop_config.json (usually at ~/Library/Application Support/Claude/claude_desktop_config.json on macOS or %APPDATA%\Claude\claude_desktop_config.json on Windows):

{
  "mcpServers": {
    "sharpe": {
      "command": "npx",
      "args": ["-y", "@sharpe-labs/mcp-server"],
      "env": {
        "SHARPE_API_KEY": "sk_your_api_key_here"
      }
    }
  }
}

Claude Code

claude mcp add sharpe -- npx -y @sharpe-labs/mcp-server

Or with an API key:

SHARPE_API_KEY=sk_your_key claude mcp add sharpe -- npx -y @sharpe-labs/mcp-server

Cursor

Add to your .cursor/mcp.json:

{
  "mcpServers": {
    "sharpe": {
      "command": "npx",
      "args": ["-y", "@sharpe-labs/mcp-server"],
      "env": {
        "SHARPE_API_KEY": "sk_your_api_key_here"
      }
    }
  }
}

Local development (from source)

cd packages/mcp-server
npm install
npm run build
node dist/index.js

Available Tools

Derivatives

| Tool | Description | |---|---| | get_funding_rates | Perpetual funding rates across exchanges (current, accumulated, or historical) | | get_futures_data | Futures chart data: OI, volume, liquidations, long/short ratios, basis, term structure | | get_futures_coins | List of coins with futures data and exchange capability flags | | get_options_data | Options chart data: IV surfaces, OI by expiry, Greeks, vol cones, block trades |

Market Data

| Tool | Description | |---|---| | get_heatmap | Market heatmap by coins, narratives, or ecosystems | | get_correlation_matrix | Price correlation matrix for portfolio analysis | | get_market_overview | Total market cap, BTC dominance, top gainers/losers, trending coins | | get_price_prediction | ML-based price predictions with confidence intervals | | search_market_cap | Search coins by name or ticker with market cap data | | get_news | Aggregated crypto news with category and coin filters | | get_gem_finder | Curated low-cap, high-potential token discovery |

Arbitrage

| Tool | Description | |---|---| | get_arbitrage_spot_perp | Spot-perpetual funding rate arbitrage opportunities | | get_arbitrage_cross_exchange | Cross-exchange price discrepancy arbitrage |

Categories

| Tool | Description | |---|---| | get_narratives | Narrative-level data: L1, L2, DeFi, AI Agents, DePIN, RWA, etc. | | get_ecosystems | Ecosystem-level data: Ethereum, Solana, Arbitrum, Base, etc. with TVL | | get_memecoins | Memecoin narrative data: Dog, Cat, Frog, AI, Political, etc. |

Example Prompts

Once connected, you can ask your AI agent things like:

• "What are the current BTC funding rates across exchanges?"
• "Show me the top spot-perp arbitrage opportunities"
• "Get the ETH options volatility surface"
• "What's the correlation between BTC, ETH, and SOL over the last 90 days?"
• "Show me the DeFi narrative performance data"
• "Search for Solana in the market cap tracker"
• "What are the latest crypto news about Bitcoin?"
• "Get the futures open interest chart for ETH over the last month"

License

MIT