About Asic Rs MCP
Asic Rs MCP is an MCP server published by s0kil in the Blockchain category: mCP server for asic-rs, Bitcoin ASIC miner management.
The repository has 2 stars and 0 forks, with the last commit 7 months ago. Six months or more without a commit doesn't mean the server is broken, but check the open issues before depending on it in production.
Install
git clone https://github.com/s0kil/asic-rs-mcpThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Tools (4)
--
Parameters not published.
get_minerConnect to a single miner by IP. Returns device info and supported capabilities.
Parameters not published.
listen_for_minersPassive UDP discovery (AntMiner port 14235, WhatsMiner port 8888).
Parameters not published.
scan_networkScan a subnet/range for miners. Supports make/firmware filters, configurable timeouts and concurrency.
Parameters not published.
Ask AI
Ask AI about Asic Rs MCP
Powered by Claude · Grounded in docs
Security checks
- ✓README presentThe repository ships documentation.
5 checks have not been run yet.
README
asic-rs-mcp
MCP server for Bitcoin ASIC miner management. Wraps asic-rs to expose miner discovery, data gathering, and control as MCP tools.
Install
cargo install --path .
Usage
asic-rs-mcp # uses ./asic-rs-mcp.toml if present
asic-rs-mcp --config /etc/asic-rs.toml # explicit config path
ASIC_RS_MCP_CONFIG=~/.config/asic-rs-mcp.toml asic-rs-mcp
The server communicates over stdio (stdin/stdout). Tracing logs go to stderr. Set RUST_LOG=debug for verbose output.
Claude Desktop
{
"mcpServers": {
"asic-rs": {
"command": "asic-rs-mcp",
"args": ["--config", "/path/to/asic-rs-mcp.toml"]
}
}
}
Configuration
Copy and edit asic-rs-mcp.toml:
[server]
data_timeout_secs = 30 # per-miner data calls
control_timeout_secs = 60 # control operations (restart, set_pools, etc.)
identification_timeout_secs = 10 # miner identification during discovery
scan_timeout_secs = 300 # total scan_network timeout
fleet_timeout_secs = 120 # total get_fleet_data timeout
fleet_concurrency_limit = 50 # max concurrent connections in fleet ops
[credentials.default]
username = "root"
password = "root"
# Per-firmware overrides
[credentials.antminer]
username = "root"
password = "root"
[credentials.whatsminer]
username = "admin"
password = "admin"
[credentials.vnish]
password = "admin"
[credentials.epic]
password = "letmein"
# Per-IP overrides (highest priority)
[credentials.miners."192.168.1.50"]
username = "custom_user"
password = "custom_pass"
Credential resolution order: per-IP > per-firmware > default.
Note: asic-rs v0.2.x hardcodes credentials in each backend and does not expose a credential injection API. The config is forward-compatible infrastructure -- credentials will be wired automatically once upstream adds support.
Tools (29)
Discovery
| Tool | Description |
|---|---|
scan_network |
Scan a subnet/range for miners. Supports make/firmware filters, configurable timeouts and concurrency. |
get_miner |
Connect to a single miner by IP. Returns device info and supported capabilities. |
listen_for_miners |
Passive UDP discovery (AntMiner port 14235, WhatsMiner port 8888). |
Data Gathering
| Tool | Description |
|---|---|
get_miner_data |
All data in one call (30 fields). |
get_fleet_data |
Concurrent get_miner_data across multiple IPs. |
get_hashrate |
Current hashrate with unit and algorithm. |
get_expected_hashrate |
Expected/nominal hashrate. |
get_wattage |
Current power consumption (watts). |
get_wattage_limit |
Configured power limit. |
get_hashboards |
Per-board temps, hashrate, chip details. |
get_fans |
Fan speeds. |
get_psu_fans |
PSU fan speeds. |
get_fluid_temperature |
Coolant temperature (immersion setups). |
get_hostname |
Network hostname. |
get_mac |
MAC address. |
get_serial_number |
Serial number. |
get_api_version |
Miner API version. |
get_firmware_version |
Firmware version string. |
get_uptime |
System uptime. |
get_is_mining |
Whether the miner is actively hashing. |
get_light_flashing |
Fault light status. |
get_messages |
Miner log messages with severity. |
get_pools |
Current pool configuration. |
Control
Each control tool checks supports_* before executing and returns { "supported": false } if the miner doesn't support the operation.
| Tool | Description |
|---|---|
restart_miner |
Restart the miner. |
set_fault_light |
Turn locate/fault LED on or off. |
pause_mining |
Pause mining (optional delay). |
resume_mining |
Resume mining (optional delay). |
set_pools |
Replace pool configuration (destructive). |
set_wattage_limit |
Set power limit in watts. |
Typical Workflow
scan_network("192.168.1.0/24") -> list of IPs
get_fleet_data([ips]) -> health data for all miners
get_hashboards("192.168.1.10") -> drill into a specific miner
set_fault_light("192.168.1.10", true) -> locate it physically
Supported Hardware
All miners supported by asic-rs: AntMiner, WhatsMiner, AvalonMiner, Bitaxe, NerdAxe, and firmware variants BraiinsOS, VNish, LuxOS, EPic, Marathon, HiveOS.
License
MIT
README copy captured when this server was indexed; it may lag the repository. The original is authoritative.