Repository avatar
Monitoring
v1.2.0
active

startmining-mcp

io.github.TIBSP/startmining-mcp

Bitcoin mining data from a self-hosted node: hashprice, profitability, weekly/monthly stats, history

Documentation

@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/mcp

Or 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

ToolDescription
get_market_dataCurrent BTC price, hashprice, difficulty, network stats
get_hashpriceHashprice breakdown ($/PH/day)
get_difficultyCurrent difficulty + next adjustment prediction
get_halving_infoHalving era, next date, supply stats
get_price_historyHistorical BTC prices (from, to, granularity)
get_difficulty_historyHistorical difficulty & hashrate
get_monthly_averagesCalendar-month averages (UTC) of BTC price, hashrate, hashprice USD & BTC (month: YYYY-MM)
get_weekly_statsClosed ISO-week stats (UTC): block time, real fees, implied hashrate, real hashprice BTC & USD, difficulty adjustments, daily rows (default: last 2 weeks)
calculate_profitabilityMining profitability for given setup
calculate_breakevenBreakeven BTC price
get_mempoolMempool status & fee estimates
get_recent_blocksRecent blocks info (max 50)
get_asic_pricesASIC 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

📄 License

MIT © Startmining

NPM
@startminingmcp/mcp
Install Command
npm install @startminingmcp/mcp
Runtime: npx