🪙 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

SaqibHussain44/MCP_coingecko

README