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