CryptoSense MCP

Real-time crypto market intelligence for AI assistants.

CryptoSense MCP wraps theCoinGeckofree API (no key needed) into a production-readyModel Context Protocolserver built withFastMCP. Connect it to Claude, Cursor, Windsurf, or any MCP-compatible client and ask natural-language questions about crypto markets.

All tools require aCryptoSense API key(seeAuthentication).

# 1. Clone git clone https://github.com/your-org/cryptosense-mcp.git cd cryptosense-mcp # 2. Create venv and install uv venv && uv pip install -e . # 3. Copy and edit environment variables cp .env.example .env # Edit .env: set CMC_API_KEY if you have one, adjust MCP_PORT if needed # 4. Generate your first API key python -c " import asyncio from src.cryptosense.auth import generate_api_key key = asyncio.run(generate_api_key('you@example.com')) print('Your API key:', key) " # 5. Start the server cryptosense-mcp # or: python -m cryptosense.server

pip install -e . cp .env.example .env python -m cryptosense.server

docker build -t cryptosense-mcp . docker run -p 8000:8000 \ -e CMC_API_KEY=your_key \ -v cryptosense-data:/app/data \ cryptosense-mcp

import asyncio from cryptosense.auth import generate_api_key key = asyncio.run(generate_api_key(email="you@example.com", plan="free")) print(key) # cs_Abc123...

CoinGecko's free public API works without a key. If you experience rate limiting (30 calls/min on the free tier), sign up athttps://www.coingecko.com/en/apifor a free Demo API key and add it to your.env:

{ "mcpServers": { "cryptosense": { "command": "python", "args": ["-m", "cryptosense.server"], "cwd": "/absolute/path/to/cryptosense-mcp", "env": { "MCP_HOST": "127.0.0.1", "MCP_PORT": "8000" } } } }

Or if the server is already running remotely, use the HTTP transport URL:

{ "mcpServers": { "cryptosense": { "url": "http://localhost:8000/mcp" } } }

OpenSettings → MCP → Add new MCP serverand enter:

{ "mcpServers": { "cryptosense": { "url": "http://localhost:8000/mcp" } } }

Add to~/.codeium/windsurf/mcp_config.json:

{ "mcpServers": { "cryptosense": { "serverUrl": "http://localhost:8000/mcp" } } }

"What is the price of Bitcoin?" "How much is Ethereum worth in EUR?" "Show me Solana's 24h change and market cap."

price(coin="bitcoin", currency="usd", api_key="cs_...") # → { "coin": "bitcoin", "price": 67420.0, "market_cap": 1.32T, "change_24h_percent": 2.4, ... }

"Show me top 10 coins." "What are the top 20 cryptocurrencies by market cap?" "List the 5 biggest coins in EUR."

top_coins(limit=10, currency="usd", api_key="cs_...") # → { "coins": [{ "rank": 1, "name": "Bitcoin", "price": 67420, ... }, ...] }

"What is trending in crypto today?" "Which coin is everyone searching for?" "Show me the hottest altcoins right now."

trending(api_key="cs_...") # → { "trending_coins": [{ "name": "Pepe", "symbol": "PEPE", "market_cap_rank": 54, ... }] }

"Calculate my portfolio: 0.5 BTC, 5 ETH, 100 SOL." "How much is my crypto worth? I have 1 bitcoin and 10 ethereum." "What is my total if I hold 0.1 BTC, 500 DOGE, and 2 ETH?"

portfolio_value( holdings={"bitcoin": 0.5, "ethereum": 5, "solana": 100}, currency="usd", api_key="cs_...", ) # → { "total_value": 54230.00, "best_performer": {...}, "breakdown": [...] }

"Compare Bitcoin and Ethereum." "Which performs better: Solana, Avalanche, or Polkadot?" "Show me BTC vs ETH vs BNB."

compare(coins=["bitcoin", "ethereum", "solana"], currency="usd", api_key="cs_...") # → { "comparison": [...], "best_performer_24h": "solana", "worst_performer_24h": "bitcoin" }

"What is the total crypto market cap?" "What is Bitcoin's market dominance today?" "Give me a global crypto summary."

market_overview(api_key="cs_...") # → { "total_market_cap_usd": 2.45T, "btc_dominance_percent": 52.3, ... }

All tools return a friendly{"error": "..."}dict on failure — no stack traces are ever returned to the client. Handled conditions:

- Invalid / missing API key→ prompt to generate one
- Coin not found→ suggests using the full CoinGecko ID
- Rate limit (429)→ asks to wait and retry
- Network errors→ descriptive message
- Invalid parameters→ caught before the API call

Remote MCP server for historical crypto & prediction-market data: search ~500K instruments, live market stats (OHLC, turnover, spreads, depth, slippage) and tick-data purchase. Keyless for catalog & stats; optional OAuth for account tools. Endpoint: https://cryptostruct.com/mcp

Read-only MCP server for your Evibe investment portfolio + live market data (holdings, performance, dividends, benchmarks, screeners). Works with Claude & ChatGPT.

Remote MCP server with real-money crypto casino audit data: trust scores, rankings, live payout tests, and T&C-decoded bonuses. No API key, Ed25519-signed answers. Endpoint: https://wagerx.io/mcp

Alpaca’s official MCP Server lets you trade stocks, ETFs, crypto, and options, run data analysis, and build strategies in plain English directly from your favorite LLM tools and IDEs

Live cross-DEX crypto prices read from on-chain pool state: per-venue price, liquidity depth and gross cross-venue spread across BSC, Polygon, Arbitrum, Base, Avalanche and Optimism. Works keyless, no account.

Bottom/top market-timing verdicts for 8 markets (crypto, stocks, commodities, FX, property) — x402 pay-per-call, no API key.

Read-only, sourced and timestamped prices for nine Binance Spot USDT markets through a public Streamable HTTP MCP endpoint.

Read-only crypto derivatives data for agents: funding, open interest, liquidations, options flow, COT, ETF flows, VPIN. 20 tools, no API key, hosted at https://mcp.bykaranteli.com

Pre-trade safety check for Solana tokens — traces coordinated wallet funding, same-block bundle buys and serial-launcher deployer history into one Exit-Liquidity Risk verdict before an agent buys.

Free crypto address labels. Identify known addresses on major networks with a free API.