MCP Server

The Sharpe MCP Server exposes 24 tools (21 endpoint tools + 3 composite workflows), 5 resources, and 2 prompts for crypto derivatives and market data via the Model Context Protocol. It connects AI agents in Claude Desktop, Claude Code, Cursor, and any MCP-compatible client to data across 13 funding-rate exchanges and the rest of the Sharpe API surface — funding rates, futures, options, arbitrage, narratives, ecosystems, memecoins, exchange listings, and more.

Installation

The recommended method uses uvx which always runs the latest version with zero install. For a persistent install that keeps the sharpe-mcp binary on your PATH, use uv tool install, pipx, or pip inside a venv.

uvx sharpe-mcp

uv tool install sharpe-mcp

pipx install sharpe-mcp

python3 -m venv ~/.venvs/sharpe
source ~/.venvs/sharpe/bin/activate
pip install sharpe-mcp

Configuration

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "sharpe": {
      "command": "uvx",
      "args": ["sharpe-mcp"],
      "env": {
        "SHARPE_API_KEY": "sk_live_your_key_here"
      }
    }
  }
}

Claude Code

claude mcp add sharpe -- uvx sharpe-mcp

Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "sharpe": {
      "command": "uvx",
      "args": ["sharpe-mcp"],
      "env": {
        "SHARPE_API_KEY": "sk_live_your_key_here"
      }
    }
  }
}

Tools

The server exposes 24 tools organized into 6 categories. All tools accept optional parameters with sensible defaults and return structured data.

Composite tools

High-level tools that combine multiple API calls into a single consolidated response. Best for broad questions.

analyze_coin

Comprehensive single-coin analysis combining funding rates, futures OI, options IV, and AI price prediction into one view. Best tool for "what's happening with BTC?" questions.

market_briefing

Full market briefing combining market overview, top narratives, and funding rate highlights. Best tool for "what's going on in crypto?" or morning briefings.

No parameters. Returns formatted text with market stats, Fear and Greed, top gainers/losers, narrative rankings, and funding highlights.

find_opportunities

Scans for the best funding rate arbitrage opportunities across all exchanges, combining spot-perp basis trades and cross-exchange funding arb.

No parameters. Returns top opportunities sorted by annualized APR with a funding rate sentiment summary.

Derivatives tools

Granular derivatives data for funding rates, futures charts, and options analytics.

get_funding_rates

Perpetual funding rates across 13 exchanges (Binance, Bybit, OKX, Deribit, Hyperliquid, and more). Positive rate means longs pay shorts.

get_futures_data

Time-series or snapshot data for 19 futures chart types: open interest, liquidations, volume, long/short ratios, funding, basis, and term structure.

get_futures_coins

Lists coins with futures data available, including per-coin capability flags (hasOI, hasLiquidations, hasLongShort).

No parameters.

get_options_data

Options analytics for BTC, ETH, and SOL across 22 chart types: implied volatility, Greeks, GEX, vol surface, flow, and more.

get_derivatives_overview

Market-wide derivatives snapshot: total OI, average funding rate, OI-weighted funding, top 20 coins by OI, and exchange/coin counts.

No parameters.

Market data tools

Broad market data covering heatmaps, correlations, price predictions, and token discovery.

get_heatmap

Market heatmap data with tokens sized by market cap and colored by price performance.

get_correlation_matrix

Pearson correlation matrix for crypto and TradFi assets over a given lookback period.

get_market_overview

Broad crypto market overview: total market cap, 24h volume, BTC dominance, Fear and Greed Index, top gainers/losers, and trending coins.

No parameters. Use this as the first call for any general market question.

get_price_prediction

AI-powered price prediction scores with sub-signal breakdowns for bias assessment (bullish/bearish/neutral, 0--10 score, RSI, EMA trends, derivatives signals).

search_market_cap

Search for coins by name or ticker symbol to find CoinGecko IDs and basic market stats.

get_gem_finder

Curated list of low-cap, high-potential tokens identified by the gem finder algorithm. Returns score, ATH distance, FDV/MCap ratio, and exchange listing counts.

Arbitrage tools

Delta-neutral and yield-generating trade opportunities from funding rate differentials.

get_arbitrage_spot_perp

Spot-perp basis trade opportunities: long spot + short perp (or vice versa) to capture funding. Sorted by APR descending.

get_arbitrage_cross_exchange

Cross-exchange funding rate arbitrage: long where funding is negative, short where positive. Sorted by spread descending.

Category tools

Sector, chain, and memecoin narrative analytics.

get_narratives

Analytics for 22 crypto narratives: L1, L2, DeFi, AI Agents, DePIN, RWA, Gaming, and more. Returns market cap, volume, performance, and social sentiment per narrative.

get_ecosystems

Analytics for 23 blockchain ecosystems: Ethereum, Solana, BNB Chain, Arbitrum, Base, and more. Returns market cap, volume, TVL, and performance per ecosystem.

get_memecoins

Memecoin narrative data across 17 curated categories: Dog, Cat, Frog, AI, Political, and more. Returns market cap, volume, dominance, momentum score, and top coins per category.

get_news

Aggregated crypto news feed from multiple sources, ranked by reliability tier.

Exchange listings tools

Which tokens got listed on the top 5 retail CEXs (Binance, OKX, Bybit, Gate.io, MEXC), tagged by narrative. Use these as a forward signal for where retail capital is being deployed.

get_exchange_listings

Aggregated hub payload: weekly + monthly listing counts by narrative and exchange, last 90 days of recent listings, and summary stats (WoW/MoM deltas, top narratives of the month, top exchanges of the month). Best tool for "which narratives are CEXs deploying listing slots toward?".

get_recent_listings

Flat feed of recent listings, one row per token-exchange pair. Best for trade-signal consumers scanning fresh listings or agents building per-token context.

System tools

get_api_coverage

Metadata about all available data products: supported exchanges, coins, chart types, timeframes, and update frequencies. Call this first to discover what data is available before making specific queries.

No parameters.

Resources

The server exposes 5 MCP resources that provide reference data for valid parameter values.

Prompts

The server includes 2 guided prompt templates that walk AI agents through multi-step analysis workflows.

market_analysis

Guides the agent through a 6-step comprehensive market analysis: market overview, derivatives health, sector rotation, ecosystem flows, arbitrage opportunities, and synthesis into a bullish/bearish/neutral verdict.

No parameters.

coin_deep_dive

Guides the agent through an in-depth single-coin analysis: quick analysis, futures deep dive (OI, long/short, liquidations, basis), options analysis (IV, skew, put/call, GEX), funding history, correlations, price prediction, and a final synthesis with key levels and risk factors.

Environment variables

Works without an API key

Get an API key

Example prompts

These natural language prompts show how AI agents route to the correct tools.