> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nonce.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Available Tools

> MCP tools for managing mining operations through AI assistants

## Workspace

| Tool             | Description                                                    |
| ---------------- | -------------------------------------------------------------- |
| `ListWorkspaces` | List all workspaces you have access to, with your role in each |

## Farm

| Tool                     | Description                                                              |
| ------------------------ | ------------------------------------------------------------------------ |
| `ListFarms`              | List all farms in a workspace                                            |
| `ListFarmMetricsHistory` | Daily historical metrics for a farm (hashrate, online count, efficiency) |
| `ListAgents`             | List all agents (edge devices) in a workspace                            |

## Miner

| Tool                 | Description                                                              |
| -------------------- | ------------------------------------------------------------------------ |
| `ListMiners`         | Real-time status for all miners in a farm (hashrate, power, temperature) |
| `ListMinerHistory`   | Performance history for a single miner                                   |
| `ListMinerPoolDiffs` | Pool configuration change history for miners in a farm                   |
| `GetMinerTasks`      | Task execution history for a specific miner                              |

## Search

| Tool                | Description                                                                             |
| ------------------- | --------------------------------------------------------------------------------------- |
| `SearchMiners`      | Search miners with structured filters (status, IP range, serial number, etc.)           |
| `SearchAgents`      | Search agents with structured filters (status, farm)                                    |
| `SearchTaskBatches` | Search task batches with structured filters (task name, status, actor type, date range) |

## Task

| Tool              | Description                                                 |
| ----------------- | ----------------------------------------------------------- |
| `ListTaskBatches` | List task batches for a farm                                |
| `GetTaskBatch`    | Detailed status of a task batch including per-miner results |

### CreateTaskBatch (write operations)

Each task type has its own tool with a dedicated parameter schema. See [Task Parameters](/api-guide/tasks#task-parameters) for details.

| Tool                                      | Task Name                    | Description                             |
| ----------------------------------------- | ---------------------------- | --------------------------------------- |
| `CreateTaskBatch_MinerSystemReboot`       | `miner.system.reboot`        | Reboot miner devices                    |
| `CreateTaskBatch_MinerLogGet`             | `miner.log.get`              | Collect diagnostic logs from miners     |
| `CreateTaskBatch_MinerLightUpdate`        | `miner.light.update`         | Toggle miner LED indicator light        |
| `CreateTaskBatch_MinerPowerModeUpdate`    | `miner.power_mode.update`    | Change mining power mode                |
| `CreateTaskBatch_MinerFirmwareUpdate`     | `miner.firmware.update`      | Update miner firmware                   |
| `CreateTaskBatch_MinerPoolLock`           | `miner.pool.lock`            | Lock or unlock miner pool configuration |
| `CreateTaskBatch_AgentScanCreate`         | `agent.scan.create`          | Scan the network for miners             |
| `CreateTaskBatch_AgentSelfUpdate`         | `agent.self.update`          | Update agent software                   |
| `CreateTaskBatch_MinerAssetUpdate`        | `miner.asset.update`         | Update miner asset status               |
| `CreateTaskBatch_MinerAssetDelete`        | `miner.asset.delete`         | Mark miner asset as deleted             |
| `CreateTaskBatch_MinerRackLocationUpdate` | `miner.rack_location.update` | Update miner rack location              |