# 🪙 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](https://www.coingecko.com/en/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
```bash
git clone https://github.com/<your-username>/crypto-mcp-server.git
cd crypto-mcp-server
````
### 2️⃣ Install dependencies
```bash
npm install
```
> Make sure your `package.json` includes `"type": "module"`
### 3️⃣ Run the server manually
```bash
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:
```bash
nano ~/Library/Application\ Support/Claude/claude_desktop_config.json
```
Add the following entry under `mcpServers`:
```json
{
"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:
```bash
/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](https://www.linkedin.com/in/saqib-hussain-635780105/)
🏢 Founder — [DevInspect](https://devinspect.co)
