Truss44 Crypto Price MCP server

Crypto Price & Market Analysis MCP Server

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)
• Smithery CLI scripts to build and run the HTTP server
• 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

{
  "mcpServers": {
    "mcp-crypto-price": {
      "command": "npx",
      "args": ["-y", "mcp-crypto-price"],
      "env": {
        "COINCAP_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

If your MCP client requires launching via cmd.exe on Windows:

{
  "mcpServers": {
    "mcp-crypto-price": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "mcp-crypto-price"],
      "env": {
        "COINCAP_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

Development scripts

pnpm dev          # Development (HTTP server with hot reload via Smithery CLI)
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.

• Dev server (recommended during development):

pnpm dev

• Build and run the HTTP server:

# Build (outputs to dist/)
pnpm build

# Start the HTTP server
pnpm start:http

• Build and run the STDIO server:

# 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. Smithery, Claude.ai), pass your API key as a query parameter:

http://localhost:3000/mcp?COINCAP_API_KEY=YOUR_API_KEY_HERE

For remote deployments:

https://mcp-crypto-price.codemonkeyinnovations.com/mcp?COINCAP_API_KEY=YOUR_API_KEY_HERE

Required: CoinCap API Key

This server uses the CoinCap v3 API, which requires an API key. A free tier is available.

Shortened. The full README is on GitHub.