Braiins Hashpower MCP Server
An MCP (Model Context Protocol) server that wraps the Braiins Hashpower Spot Market API, exposing it as tools for Claude and other MCP clients.
Features
- Query live market data: stats, orderbook, recent trades, OHLCV bars
- Manage bids: create, update, cancel, and inspect active or historical bids
- View account balance and transaction history
- All price values use the API's native unit: sat/EH/day
Prerequisites
- A Braiins Hashpower API key (get one at market.braiins.com)
- uv — provides the
uvxcommand used below
Installation
No manual installation needed. uvx fetches and runs the package from PyPI automatically on first use.
If you prefer pip:
pip install braiins-hashpower-mcp
Connecting to Claude Code (VS Code)
Add to your .mcp.json (using uvx):
{
"mcpServers": {
"braiins-hashpower": {
"command": "uvx",
"args": ["braiins-hashpower-mcp"],
"env": {
"BRAIINS_API_KEY": "your_api_key_here"
}
}
}
}
Or if using pip, replace "command": "uvx" and "args": ["braiins-hashpower-mcp"] with "command": "braiins-hashpower-mcp" and "args": [].
Then reload the VS Code window (Cmd+Shift+P → Developer: Reload Window).
Connecting to Claude Code (CLI)
claude mcp add braiins-hashpower \
-e BRAIINS_API_KEY=your_api_key_here \
-- uvx braiins-hashpower-mcp
To remove it later:
claude mcp remove braiins-hashpower
Available Tools
Public (no API key required)
| Tool | Description |
|---|---|
get_market_stats |
Best bid/ask prices, 24h volume, matched/available hashrate |
get_orderbook |
Current order book snapshot (bids and asks) |
get_recent_trades |
Most recently executed trades |
get_market_bars |
OHLCV candlestick bars (specify period and optional limit) |
Authenticated (require API key)
| Tool | Description |
|---|---|
get_market_settings |
Trading rules: price/speed limits, tick size, hr_unit |
get_fee_structure |
Spot market fee structure |
get_account_balance |
BTC balances across subaccounts |
get_transactions |
Account transactions (deposits, withdrawals, trades) |
get_onchain_transactions |
On-chain Bitcoin transactions |
get_current_bids |
All currently active bids |
get_bids |
Historical and active bids with optional filters |
get_bid_detail |
Full details for a specific bid |
get_bid_speed_history |
Hashrate time series for a bid |
get_bid_delivery_history |
Share delivery history for a bid |
create_bid |
Place a new bid |
update_bid |
Modify price, amount, or speed of an active bid |
cancel_bid |
Cancel an active bid |
Units
| Field | Unit |
|---|---|
Price (price_sat) |
sat/EH/day |
Speed (speed_limit_ph) |
PH/s |
Amount (amount_sat) |
satoshis |
Note: The Braiins web UI displays prices in sat/PH/day. To convert: multiply UI price × 1,000 to get the API value (e.g. 48,000 sat/PH/day → 48,000,000 sat/EH/day).
License
MIT
Metadata
Release files for braiins-hashpower-mcp 1.0.6
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| braiins_hashpower_mcp-1.0.6.tar.gz | 7.8 kB | Without provenance | Details for braiins_hashpower_mcp-1.0.6.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| braiins_hashpower_mcp-1.0.6-py3-none-any.whl | Python 3 | none | any | Details for braiins_hashpower_mcp-1.0.6-py3-none-any.whl |
Total release size: 14.0 kB
Release files / braiins_hashpower_mcp-1.0.6.tar.gz
| Download URL | braiins_hashpower_mcp-1.0.6.tar.gz |
|---|---|
| Size | 7.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
3899bb51e353592fda4930c6ae137895193ab0a6a1648cc5dde249a674e9eaf3
|
|
BLAKE2b-256 checksum How to use checksums |
8a7308fdf964bef84b4b2b48f8ac2c614978346e0c169aa60c9fcf34641ae82a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Release files / braiins_hashpower_mcp-1.0.6-py3-none-any.whl
| Download URL | braiins_hashpower_mcp-1.0.6-py3-none-any.whl |
|---|---|
| Size | 6.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
5ff3dbbc69b0618bb46af912e4654803a8c3b02f60f9d17fd9332aad13d2fe46
|
|
BLAKE2b-256 checksum How to use checksums |
7a0b31f9b91fecce64b6fef04e0328ac21e20bdd9e6e564e5b963e520c1e49f2
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Security for braiins-hashpower-mcp 1.0.6
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.