@sharpe-terminal/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, arbitrage opportunities, narratives, ecosystems, and more.

Installation

Requires Node.js 18 or later.

npx (no install)

npx @sharpe-terminal/mcp-server

Global install

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

Configuration

Environment Variables

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

Without an API key, the server falls back to free public endpoints when a matching public route exists. Authenticated-only /api/v1/* tools require SHARPE_API_KEY.

Custom base URLs must use https://, except http://localhost/127.0.0.1/::1 for local development. The server refuses API redirects so credentials are not forwarded to unexpected hosts.

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-terminal/mcp-server"],
      "env": {
        "SHARPE_API_KEY": "sk_live_your_key_here"
      }
    }
  }
}

Claude Code

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

Or with an API key:

SHARPE_API_KEY=sk_live_your_key_here claude mcp add sharpe -- npx -y @sharpe-terminal/mcp-server

Cursor

Add to your .cursor/mcp.json:

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

Local development (from source)

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

Available Tools

The TypeScript package exposes 41 tools: 38 endpoint tools plus 3 composite workflows (analyze_coin, market_briefing, find_opportunities). The Python sharpe-terminal-mcp package mirrors this surface and is the primary distribution for the companion CLI.

All tools are read-only market-data calls. They advertise MCP annotations for readOnlyHint, destructiveHint=false, idempotentHint, and openWorldHint. Endpoint tools return both structuredContent ({ "result": ... }) and text JSON for older clients. Composite workflow tools return { "report": "..." } in structuredContent plus the same markdown report in text content.

Large list responses are capped at 200 rows before they are returned to the MCP client. Truncated payloads include truncated, total, and showing fields.

Release checklist and cross-package synchronization notes live in ../../docs/release-packages.md.

Composite Workflows

| Tool | Description | |---|---| | analyze_coin | Single-coin analysis combining funding, futures OI, and prediction data | | market_briefing | Market overview, narrative leaders, and funding highlights in one briefing | | find_opportunities | Funding-rate and arbitrage opportunity scan across multiple sources |

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_derivatives_overview | Market-wide derivatives snapshot: total OI, weighted funding, top coins, and exchange counts |

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_curated_news | Curated crypto news highlights | | get_gem_finder | Curated low-cap, high-potential token discovery | | get_stablecoins | Stablecoin overview, detail, peg, chain supply, and yield data | | get_mindshare | Narrative mindshare, token-level attention, and historical snapshots | | get_web_traffic | Attention rankings, search trends, and social/developer snapshots | | get_katana | Katana Network TVL, token, holder, sentiment, pool, and ecosystem analytics |

Screener

| Tool | Description | |---|---| | get_dexscreener_data | Live DEX pair screening by category, network, or search phrase | | get_dexscreener_security | Token contract security signals for DEX Screener tokens | | get_token_scanner | Read-only hot token, new runner, alpha drop, AI token, and top-new scans | | get_rug_check_security | Token contract and liquidity risk signals | | get_rug_check_trending | Trending tokens suitable for rug-check review | | get_insider_selling | Insider selling pressure and holder-quality risk signals | | get_pump_dump | Pump-and-dump manipulation risk signals |

Arbitrage

| Tool | Description | |---|---| | get_arbitrage_spot_perp | Spot-perpetual funding rate arbitrage opportunities | | get_arbitrage_cross_exchange | Cross-exchange price discrepancy arbitrage | | get_arbitrage_dated_futures_basis | Spot-futures cash-and-carry basis rows | | get_arbitrage_futures_calendar_spread | Near-versus-far dated futures curve rows | | get_arbitrage_perp_dated_carry | Perp funding versus dated futures carry rows | | get_arbitrage_cex_spot_transfer | CEX spot-transfer rows with network, fee, depth, and slippage checks |

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, Solana, Base, Pump.fun, etc. | | get_memecoin_launches | Recently launched memecoin pairs screened by age, liquidity, volume, and transactions | | get_exchange_listings | New Listings aggregate activity by narrative and venue | | get_recent_listings | Recent token listings feed | | get_listing_events | Canonical listing lifecycle events with source confidence | | get_listing_exchanges | Listing connector coverage and parser status |

System

| Tool | Description | |---|---| | get_api_coverage | Available data products, exchanges, timeframes, and chart coverage |

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"
• "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