truss44/mcp-crypto-price

A Model Context Protocol (MCP) server that provides comprehensive cryptocurrency analysis using the CoinCap API. This server offers real-time price data, market analysis, and historical trends through an easy-to-use interface. Supports both STDIO and Streamable HTTP transports.
## Requirements
Node.js 22.14+
CoinCap API key via COINCAPAPIKEY
## What's New
BREAKING: CoinCap v2 API removed. Now uses v3 API exclusively. A COINCAPAPIKEY is required (free tier available at pro.coincap.io/dashboard)
Streamable HTTP transport added (while keeping STDIO compatibility)
Runs fully standalone over STDIO and Streamable HTTP - no external registry or runtime required
6 new tools: assets-search, market-global, assets-compare, analysis-candlestick, price-convert, assets-info
Hierarchical tool naming: All tools organized into category-prefixed names (price-, market-, assets-, analysis-)
Output schemas: All tools now declare outputSchema with structuredContent for type-safe responses
MCP best practices: isError flag on validation errors, server description, and asset://{symbol} resource template
## Usage
Add this configuration to your Claude Desktop config file:
MacOS: ~/Library/Application Support/Claude/claudedesktopconfig.json
Windows: %APPDATA%/Claude/claudedesktopconfig.json
json
"mcpServers": {
"mcp-crypto-price": {
"command": "npx",
"args": ["-y", "mcp-crypto-price"],
"env": {
"COINCAPAPIKEY": "YOURAPIKEYHERE"
If your MCP client requires launching via cmd.exe on Windows:
json
"mcpServers": {
"mcp-crypto-price": {
"command": "cmd",
"args": ["/c", "npx", "-y", "mcp-crypto-price"],
"env": {
"COINCAPAPIKEY": "YOURAPIKEYHERE"
### Development scripts
bash
pnpm watch # Development: recompile on change (tsc --watch); pair with node --watch dist/http.js for HTTP hot reload
pnpm build # Compile TypeScript → dist/
pnpm format # Format source files with Prettier
pnpm lint # Check for lint errors (ESLint + typescript-eslint)
pnpm lint:fix # Auto-fix lint errors
pnpm types:check # TypeScript type-check without emitting files
pnpm test # Run all tests with Vitest
pnpm test:coverage # Run tests with coverage report (Vitest)
pnpm inspector # Open MCP inspector for interactive debugging
### Run as Streamable HTTP server
You can run the server over HTTP for environments that support MCP over HTTP streaming.
During development, rebuild and restart on change:
bash
pnpm watch # terminal 1: recompile TypeScript
node --watch dist/http.js # terminal 2: restart the HTTP server on rebuild
Build and run the HTTP server:
bash
# Build (outputs to dist/)
pnpm build
# Start the HTTP server
pnpm start:http
Build and run the STDIO server:
bash
# Build (outputs to dist/)
pnpm build
# Start the STDIO server
pnpm start:stdio
The server listens on port 3000 by default (override with PORT). For clients that connect over HTTP (e.g. Claude.ai, Cursor), pass your API key as a query parameter:
http://localhost:3000/mcp?COINCAPAPIKEY=YOURAPIKEYHERE
For remote deployments:
https://mcp-crypto-price.codemonkeyinnovations.com/mcp?COINCAPAPIKEY=YOURAPIKEYHERE
## Required: CoinCap API Key
This server uses the CoinCap v3 API, which requires an API key. A free tier is available.
1. Sign up and get your API key at pro.coincap.io/dashboard