@sharpe-terminal/mcp-server

@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