MCP Server

The Sharpe MCP Server exposes 41 tools (38 endpoint tools + 3 composite workflows), 4 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, arbitrage, screeners, narratives, ecosystems, memecoins, new listings, project dashboards, 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 --from sharpe-terminal-mcp sharpe-mcp

uv tool install sharpe-terminal-mcp

pipx install sharpe-terminal-mcp

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

Configuration

Claude Desktop

Add to your claude_desktop_config.json:

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

Claude Code

claude mcp add sharpe -- uvx --from sharpe-terminal-mcp sharpe-mcp

Cursor

Add to .cursor/mcp.json:

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

Tools

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

Tool behavior

All Sharpe MCP tools are read-only market-data calls. Tools advertise MCP annotations for readOnlyHint, destructiveHint=false, idempotentHint, and openWorldHint so compatible clients can classify them safely. Endpoint tools return both MCP structuredContent ({ "result": ... }) and text JSON for clients that still read only the content array. Composite workflow tools return { "report": "..." } in structuredContent plus the same formatted markdown in text content.

Large list responses are capped at 200 rows before they are returned to the client. When truncation happens, the payload includes truncated, total, and showing fields so agents can tell that a longer result exists.

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, 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 and futures charts.

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 24 MCP/API futures chart types: open interest, liquidations, volume, long/short ratios, funding, basis, term structure, and signal views.

get_futures_coins

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

No parameters.

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--100 consensus score, RSI, EMA trends, derivatives signals).

search_market_cap

Search for coins by name or ticker symbol to find canonical asset 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.

get_stablecoins

Stablecoin overview, detail, and yield data including market cap, peg deviation, mechanism mix, and chain supply.

get_mindshare

Narrative mindshare rankings, token-level attention rows, rolling windows, and historical snapshots.

get_web_traffic

Attention rankings, search trends, social snapshots, and market-level traffic signals for exchanges, coins, and narratives.

Screener tools

DEX and token-discovery workflows for pair screening, token scanning, and contract risk review.

get_dexscreener_data

Live DEX pair screening by category, network, or search phrase.

get_dexscreener_security

Token contract security signals for a DEX Screener token by address and chain ID.

get_token_scanner

Read-only scanner modes for hot tokens, new runners, alpha drops, AI tokens, and top-new pairs.

get_rug_check_security

Token contract and liquidity risk signals for rug-check review.

get_rug_check_trending

Trending tokens suitable for rug-check review.

get_insider_selling

Insider selling pressure signals across crypto assets, including wallet concentration, holder-quality risk, sell-side flow, and derivatives confirmation.

get_pump_dump

Pump-and-dump manipulation risk signals across crypto assets, including derivatives pressure, holder concentration, liquidity quality, DEX flow, and price behavior.

Project tools

get_katana

Katana Network TVL, token, holder, sentiment, pool, mover, and ecosystem analytics.

No parameters.

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.

get_arbitrage_dated_futures_basis

Spot-futures cash-and-carry scanner rows for buying spot and selling dated futures.

get_arbitrage_futures_calendar_spread

Near-versus-far dated futures curve scanner rows with forward yield and net roll APY.

get_arbitrage_perp_dated_carry

Perp funding versus dated futures carry rows comparing expected funding to expiry against locked dated basis.

get_arbitrage_cex_spot_transfer

CEX spot-transfer rows after common network, withdrawal/deposit status, withdrawal fee, depth, slippage, and spread-lifetime checks.

Category tools

Sector, chain, and memecoin narrative analytics.

get_narratives

Analytics for 22 MCP narrative slugs: 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 grouped categories: Dog, Cat, Frog, AI, Solana, Base, Pump.fun, and more. Returns market cap, market share, volume, freshness, calculation method, short-term momentum score, and top coins per category.

get_memecoin_launches

Recently launched memecoin pairs screened by age, liquidity, volume, and transaction count. This is a discovery feed, not a contract-security verdict.

get_news

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

get_curated_news

AI-curated crypto news highlights across crypto, AI, markets, and geopolitics. Updated every 15 minutes.

New listings tools

Listing lifecycle events across CEXs and Perp DEXs, tagged by narrative and source confidence. Use these as a forward signal for where exchange liquidity 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.

get_listing_events

Canonical listing event feed across spot, perp, futures, and options markets. Returns event type, instrument id, status, source URL, source kind, and source confidence.

get_listing_exchanges

Typed connector registry for supported listing venues, including market coverage, source docs, enabled status, polling group, and parser confidence.

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 4 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), funding history, correlations, price prediction, and a final synthesis with key levels and risk factors.

Environment variables

Custom base URLs must use https://, except local development hosts such as http://localhost, http://127.0.0.1, and http://[::1]. The server refuses HTTP redirects from API calls so credentials are not forwarded to unexpected hosts.

Works without an API key

Get an API key

Create a key from the API key dashboard, then set it as SHARPE_API_KEY in your MCP client configuration. The full key is shown once at creation time.

Example prompts

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