@startminingmcp/mcp
v1.2.0
Published
MCP server for Bitcoin mining data - hashprice, difficulty, profitability calculations
Maintainers
Readme
@startminingmcp/mcp
MCP (Model Context Protocol) server for Bitcoin mining data. Get real-time hashprice, difficulty, profitability calculations, and more.
🚀 Features
- Real-time market data — BTC price, hashprice, difficulty, network stats
- Profitability calculator — Calculate ROI for any ASIC setup
- Historical data — Price and difficulty history since 2009
- Halving tracker — Current era, next halving, supply stats
- Mempool & blocks — Fee estimates and recent blocks
- ASIC prices — Market prices by efficiency tier
📦 Installation
npm install -g @startminingmcp/mcpOr use directly with npx:
npx @startminingmcp/mcp⚙️ Configuration
Claude Desktop
Add to your claude_desktop_config.json:
{
"mcpServers": {
"startmining": {
"command": "npx",
"args": ["@startminingmcp/mcp"]
}
}
}With API Key (optional, for higher rate limits)
{
"mcpServers": {
"startmining": {
"command": "npx",
"args": ["@startminingmcp/mcp"],
"env": {
"STARTMINING_API_KEY": "your_api_key"
}
}
}
}🛠️ Available Tools
| Tool | Description |
|------|-------------|
| get_market_data | Current BTC price, hashprice, difficulty, network stats |
| get_hashprice | Hashprice breakdown ($/PH/day) |
| get_difficulty | Current difficulty + next adjustment prediction |
| get_halving_info | Halving era, next date, supply stats |
| get_price_history | Historical BTC prices (from, to, granularity) |
| get_difficulty_history | Historical difficulty & hashrate |
| get_monthly_averages | Calendar-month averages (UTC) of BTC price, hashrate, hashprice USD & BTC (month: YYYY-MM) |
| get_weekly_stats | Closed ISO-week stats (UTC): block time, real fees, implied hashrate, real hashprice BTC & USD, difficulty adjustments, daily rows (default: last 2 weeks) |
| calculate_profitability | Mining profitability for given setup |
| calculate_breakeven | Breakeven BTC price |
| get_mempool | Mempool status & fee estimates |
| get_recent_blocks | Recent blocks info (max 50) |
| get_asic_prices | ASIC market prices by efficiency |
💡 Example Queries
Once configured, you can ask Claude:
- "What's the current hashprice?"
- "Calculate profitability for an S21 (200 TH/s, 3500W) at $0.05/kWh"
- "When is the next halving?"
- "Show me BTC price history for last month"
- "What's the mempool fee situation?"
- "Give me the September 2026 monthly averages for price, hashrate and hashprice"
- "Compare the last two closed weeks: block time, fees and hashprice"
📊 Data Sources
- Price data: Internal database (since 2009-01-03)
- Network data: Direct Bitcoin Core node
- Calculations: Real-time based on current conditions
🔗 Links
- Website: pro.startmining.io
- Company: startmining.io
- API Docs: mining-api.startmining.io
📄 License
MIT © Startmining
