🪙 Crypto Tracker MCP Server Example

A Model Context Protocol (MCP) server that connects AI agents (like Claude Desktop or other MCP clients) to real-time cryptocurrency market data using the CoinGecko API.

This project demonstrates how to build and run a complete MCP server in Node.js, featuring:

• 🧰 Tools for interacting with crypto data

• 📚 (Optional) Resources for reusable info sets

• 💬 (Optional) Prompt Templates for AI-assisted responses

🚀 Features

✅ Get Real-Time Prices — Fetch live prices, market cap, and 24h change for any cryptocurrency
✅ Detailed Coin Info — Retrieve full metadata for a specific coin
✅ Market Data — Paginated list of coins ranked by market cap
✅ Search Coins — Find coins by name or symbol
✅ Trending Coins — Get currently trending cryptocurrencies on CoinGecko

🧠 What Is MCP?

MCP (Model Context Protocol) is a new open standard that connects Large Language Models (LLMs) to external tools, APIs, and data sources through a single unified interface.

Each MCP Server can expose:

Your LLM can then access and execute these capabilities safely and consistently.

🧩 Project Structure

crypto-mcp-server/
├── server.js          # Main MCP server implementation
├── package.json       # Dependencies and module config
└── README.md          # Documentation (this file)

⚙️ Setup

1️⃣ Clone the repository

git clone https://github.com/<your-username>/crypto-mcp-server.git
cd crypto-mcp-server

2️⃣ Install dependencies

npm install

Make sure your package.json includes "type": "module"

3️⃣ Run the server manually

node server.js

You should see:

CoinGecko MCP Server running on stdio

🧩 Integration with Claude Desktop

To connect this MCP server with Claude Desktop, edit your configuration file:

nano ~/Library/Application\ Support/Claude/claude_desktop_config.json

Add the following entry under mcpServers:

{
  "mcpServers": {
    "coingecko": {
      "command": "/Users/<your-username>/.nvm/versions/node/v22.17.1/bin/node",
      "args": ["/Users/<your-username>/work/crypto-mcp-server/server.js"]
    }
  }
}

Then restart Claude Desktop. You’ll now be able to call this server using /mcp commands like:

/mcp coingecko get_price { "ids": "bitcoin", "vs_currencies": "usd" }

🧰 Available Tools

🛠️ Tech Stack

• Node.js 22+

• @modelcontextprotocol/sdk

• CoinGecko REST API

• ES Modules (import/export syntax)

💡 Future Enhancements

• Add Resources to store coin metadata or cached lookups

• Add Prompt Templates for summarizing market trends

• Add Persistent local caching for performance optimization

• Integrate with other APIs (Binance, CoinMarketCap, etc.)

🧑‍💻 Author

Saqib Hussain 🚀 Software Engineer | DevOps | AI Integrations 🔗 LinkedIn 🏢 Founder — DevInspect