coincap

The CoinCap MCP Server exposes the CoinCap.io API as MCP tools that can be consumed by MCP clients such as Claude Desktop or MCP Inspector. It dynamically loads all available CoinCap endpoints from the Swagger specification at runtime, giving you access to assets, markets, exchanges, technical analysis indicators, conversion rates, and more, all exposed as tools that can be invoked via MCP calls. The server supports both stdio transport (for Claude Desktop integrations) and a streamable HTTP transport (for MCP Inspector and other HTTP-based clients). To get started, configure the server with your CoinCap API key and run it in your preferred mode. When using the HTTP mode, tools are accessible over HTTP at the provided endpoint and can be discovered and called via the MCP Inspector or curl-style RPC calls.

Available tools cover categories like Asset Tools (listing assets, details, historical data, markets), Technical Analysis Tools (RSI, SMA/EMA, MACD, VWAP, candlestick data), and Market & Exchange Tools (exchange listings, market data, conversion rates). Because tools are loaded from the CoinCap Swagger spec at runtime, the exact set of available endpoints may vary as the API evolves. Use the included examples to list tools or call specific methods once the server is running to see the current capabilities.

Prerequisites:

• Node.js 18 or later
• Yarn package manager
• A CoinCap API key (free tier available at https://pro.coincap.io)

Option A: Run with npx (no installation)

1. Ensure you have Node.js installed.
2. Run the server directly with npx:

# Run directly without installation
npx coincap-mcp-server

# For HTTP mode (streamable HTTP)
npx coincap-mcp-server --port=3001

Option B: Install locally and run from build

1. Clone the repository and install dependencies:

git clone https://github.com/CC3-0/coincap-mcp-server
cd coincap-mcp-server

# Install dependencies
yarn install

# Build the project
yarn build

2. Start in stdio mode (default) or point to the built file in your client configuration.

Option C: Run via Claude Desktop Extension (optional)

1. Use the Claude Desktop extension file provided in the repository if you have Claude Desktop. This option requires Claude Desktop and uses the extension to start the MCP server with the CoinCap API key configured in the extension settings.

Prerequisites recap:

• Node.js >= 18
• Yarn
• COINCAP_API_KEY environment variable with a valid API key

Environment variables and configuration tips:

• Always set COINCAP_API_KEY in the environment where you run the server, and pass it to clients via the server configuration (as shown in the examples).
• When using HTTP mode, the default endpoint is http://127.0.0.1:3001/mcp. You can customize the port if needed via the --port flag (or by configuring your hosting environment).
• The server loads tools dynamically from CoinCap’s Swagger specification. If a particular endpoint is not visible, ensure your API key has access to the CoinCap Pro endpoints and wait for the server to load the latest spec at startup.
• If you encounter issues with environment variables not being picked up, verify that your shell session has the variables exported before launching the server (for example, export COINCAP_API_KEY=...).
• For MCP Inspector usage, select streamable HTTP mode and point the inspector to http://127.0.0.1:3001/mcp to browse and call tools.