realtime-crypto-mcp-server

A real-time cryptocurrency data provider for Model Context Protocol (MCP) servers. This package integrates with the CoinCap API to provide cryptocurrency exchange details and current rates.

Features

Get detailed cryptocurrency exchange information (volumes, rankings, trading pairs)
Fetch current cryptocurrency rates in USD
Built-in rate limiting and retry mechanisms for API requests
Fully typed with TypeScript
Compatible with MCP server SDK

🚀 Quick Start

To get started, add this configuration to your MCP Client config json:

{
  "mcpServers": {
    "realtime-crypto": {
      "command": "npx",
      "args": ["realtime-crypto-mcp-server"]
    }
  }
}

Prerequisites

Node.js 18+
npx

Development

Install dependencies:

npm install

Build the server:

npm run build

Crypto Exchange & Rates Toolkit

This package provides tools to retrieve detailed information about cryptocurrency exchanges and current exchange rates for cryptocurrencies using the CoinCap API.

API Reference

`getExchangeDetailsTool`

Get detailed information about cryptocurrency exchanges.

Input:

exchange (string): Exchange ID (e.g., binance, coinbase, kraken)

Example Response: Exchange details for Binance:

Name: Binance
Rank: 1
Volume (USD): $14,789,244,354.70
% of Total Volume: 31.39%
Trading Pairs: 1078
Website: https://www.binance.com/
Last Updated: 4/5/2025, 12:34:56 PM

`getRatesTool`

Get current exchange rates for cryptocurrencies.

Input:

currency (string): Cryptocurrency ID (e.g., bitcoin, ethereum, litecoin)

Example Response: Current rate for bitcoin:

Symbol: BTC ₿ Type: crypto USD Rate: $82,821.30

🧠 Data Source

This package uses data from the CoinCap API, a free cryptocurrency market data API that provides real-time pricing and market activity for over 1,000 cryptocurrencies.

⏱️ Rate Limiting

The package includes built-in rate limiting and retry mechanisms to handle CoinCap API's rate limits.

Maximum 3 retries for rate-limited requests
Exponential backoff starting at 1 second

📄 License

MIT

👨‍💻 Author

Mohan Kumar

🙏 Acknowledgements

CoinCap API for providing cryptocurrency market data
Model Context Protocol for the MCP server framework