Bitcoin Price MCP Server
A Model Context Protocol (MCP) server that provides Claude AI with real-time access to Bitcoin price data. This server allows Claude to fetch the current price of Bitcoin and related market information.
Features
- Provides Claude with real-time Bitcoin price information
- Returns price in USD, 24-hour change percentage, and market cap
- Handles API calls to cryptocurrency data providers
- Automatic fallback between CoinMarketCap and CoinGecko APIs
Prerequisites
- Node.js and npm installed
- A CoinMarketCap API key (get one at pro.coinmarketcap.com)
- Note: If you don't have a CoinMarketCap API key, the tool will automatically use CoinGecko API instead
Installation
# Clone this repository
git clone [your-repository-url]
cd btc-price-mcp
# Install dependencies
npm install
# Build the TypeScript code
npm run build
Configuration
-
Copy the
.env.examplefile to.env:cp .env.example .env -
Edit the
.envfile and add your CoinMarketCap API key:COINMARKETCAP_API_KEY=your_api_key_here
Using as CLI Tool
You can use this as a command-line tool to check Bitcoin prices:
# Using npm
npm start
# Or directly with node
node dist/index.js
You can also use the included batch files:
bt-price.batorbtc-price.bat
Integration with Claude Desktop
To integrate this MCP server with Claude Desktop:
-
Locate the Claude Desktop configuration file:
- On Windows:
%APPDATA%\Claude\claude_desktop_config.json - On macOS:
~/Library/Application\ Support/Claude/claude_desktop_config.json - On Linux:
~/.config/Claude/claude_desktop_config.json
- On Windows:
-
Add the following configuration to the file:
{
"mcpServers": {
"btc": {
"command": "node",
"args": ["<FULL_PATH_TO_YOUR_PROJECT>/dist/index.js"],
"env": {
"COINMARKETCAP_API_KEY": "your-api-key-here"
}
}
}
}
Replace <FULL_PATH_TO_YOUR_PROJECT> with the absolute path to your project directory.
For example on Windows: C:/Users/RITESH YADAV/Desktop/Lab/dist/index.js
Usage in Claude
Once configured, you can ask Claude about Bitcoin prices:
- "What's the current price of Bitcoin?"
- "How much has Bitcoin changed in the last 24 hours?"
- "What's the market cap of Bitcoin right now?"
Development
This project is designed to work with the Model Context Protocol specification. You can modify the available tools or add new cryptocurrency endpoints by editing the src/index.ts file and rebuilding the project.
License
MIT