🪙 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:

Category	Description
🧰 Tools	Functions or APIs that an LLM can call (like get_price)
📚 Resources	Static or dynamic data references (like coin lists, config files)
💬 Prompt Templates	Predefined prompts or instruction templates

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

Tool	Description	Example
get_price	Get current price, market cap, and 24h change	{ "ids": "bitcoin", "vs_currencies": "usd" }
get_coin_details	Get metadata about a specific coin	{ "id": "ethereum" }
get_market_data	Paginated market cap data	{ "vs_currency": "usd", "per_page": 10, "page": 1 }
search_coins	Search for cryptocurrencies	{ "query": "solana" }
get_trending	Get trending cryptocurrencies	{}

---

🛠️ 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