Provides real-time Bitcoin mining data, profitability calculations, and historical network statistics to AI clients.
Also known as TIBSP/startmining-mcp, startmining-mcp, @startminingmcp/mcp
- Stars
- 0
- Tools
- 13
- Downloads, 30 days
- —
- Latest version
- 1.2.0
- Last commit
- Nov 2, 2026
- License
- MIT
What is Startmining MCP?
Startmining provides real-time Bitcoin mining data, profitability calculations, and historical network statistics to AI clients. It exposes 13 tools, such as get_market_data, get_hashprice, get_difficulty.
Summary generated from the project's README
About Startmining MCP server
Accessing real-time Bitcoin mining metrics and profitability analysis from within an AI client is what this server enables. It provides developers and miners with direct access to network statistics, including hashprice, difficulty, and mempool fee estimates. By connecting this server to Claude Desktop via npx, users can query live market data or examine historical trends dating back to 2009.
Users can perform complex financial modeling using tools like calculate_profitability to determine ROI for specific ASIC hardware setups or calculate_breakeven to find necessary Bitcoin prices. The server also tracks halving eras and provides ASIC market prices categorized by efficiency tiers. While it works out of the box, providing a STARTMINING_API_KEY in the environment configuration allows for higher rate limits during intensive data retrieval tasks.
What you can do with it
- 1Calculate mining hardware ROIDetermine the profitability of a specific ASIC model based on its hashrate and electricity costs.
- 2Analyze historical network trendsRetrieve Bitcoin price and difficulty data from previous years to identify patterns.
- 3Monitor network congestionCheck current mempool status and estimated transaction fees.
- 4Track halving eventsIdentify the current mining era and the date of the upcoming halving.
Written from the project's README. Every use case is checked against a quote from it.
How to install Startmining MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Startmining MCP in Claude Code
$ claude mcp add startmining-mcp -- npx -y @startminingmcp/mcpInstall Startmining MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"startmining-mcp": {
"command": "npx",
"args": [
"-y",
"@startminingmcp/mcp"
]
}
}
}Install Startmining MCP in VS Code
.vscode/mcp.json
{
"servers": {
"startmining-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@startminingmcp/mcp"
]
}
}
}Install Startmining MCP in VS Code CLI
$ code --add-mcp '{"name":"startmining-mcp","type":"stdio","command":"npx","args":["-y","@startminingmcp/mcp"]}'Install Startmining MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"startmining-mcp": {
"command": "npx",
"args": [
"-y",
"@startminingmcp/mcp"
]
}
}
}Install Startmining MCP in Codex
$ codex mcp add startmining-mcp -- npx -y @startminingmcp/mcpInstall Startmining MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.startmining-mcp] command = "npx" args = ["-y", "@startminingmcp/mcp"]
Install Startmining MCP in Gemini CLI
$ gemini mcp add -s user startmining-mcp npx -- -y @startminingmcp/mcpInstall Startmining MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"startmining-mcp": {
"command": "npx",
"args": [
"-y",
"@startminingmcp/mcp"
]
}
}
}Startmining MCP tools 13
Detected from the READMEget_market_dataget_hashpriceget_difficultyget_halving_infoget_price_historyget_difficulty_historyget_monthly_averagesget_weekly_statscalculate_profitabilitycalculate_breakevenget_mempoolget_recent_blocks
| get_market_data | — | |
| get_hashprice | — | |
| get_difficulty | — | |
| get_halving_info | — | |
| get_price_history | — | |
| get_difficulty_history | — | |
| get_monthly_averages | — | |
| get_weekly_stats | — | |
| calculate_profitability | — | |
| calculate_breakeven | — | |
| get_mempool | — | |
| get_recent_blocks | — |
Show all 13 toolsShow fewer tools
get_asic_prices
| get_asic_prices | — |
Configuration
STARTMINING_API_KEY
| Name | Description | |
|---|---|---|
| STARTMINING_API_KEY | — |
Automated checks
Ran Nov 13, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachablePass
- Open source license (OSI)Pass
- Commit or release in the last yearPass
- Package name not close to a popular packagePass
- Remote endpoint uses HTTPSNot checked
- Destructive tools are labelledPass
- No hidden instructions to the modelPass
- No critical advisory in the package or its dependenciesPass
README
View on GitHub@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
| 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
Startmining MCP questions
How do I add Startmining MCP to Claude Code?
Run claude mcp add startmining-mcp -- npx -y @startminingmcp/mcp in your terminal. Add --scope user to make it available in every project.
How do I add Startmining MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools does Startmining MCP provide?
It exposes 13 tools, including get_market_data, get_hashprice, get_difficulty, get_halving_info, get_price_history.
Can I calculate the profitability of my mining hardware?
Yes, the server includes a tool to calculate mining profitability for a given ASIC setup.
Does this server require an API key?
An API key is optional and can be used to access higher rate limits.