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

# MCP Tools

> Available tools exposed by the crcli MCP server.

All tools accept device/group **hostnames or names** in addition to UUIDs — no UUID hunting required.

## Device Tools

**list\_devices** `tool`

List all devices for your tenant.

**get\_device** `tool`

Get details for a single device by hostname or UUID.

**list\_device\_backups** `tool`

List configuration backups for a device.

**run\_script** `tool`

Run a shell script or command on a device via SSH. Returns stdout and stderr.

**push\_file** `tool`

Upload a local file to a device.

**pull\_file** `tool`

Download a file from a device to a local directory.

**icontrol\_request** `tool`

Make an authenticated iControl REST API request to a device via the managed session proxy. Supports GET, POST, PUT, PATCH, DELETE.

## Device Group Tools

**list\_device\_groups** `tool`

List all device groups for your tenant.

**get\_device\_group** `tool`

Get details for a single device group by name or UUID.

**list\_devices\_in\_group** `tool`

List member devices of a device group.

**run\_script\_on\_group** `tool`

Run a script on a device group's active (or standby) device.

**push\_file\_to\_group** `tool`

Upload a local file to every device in a device group.

**pull\_files\_from\_group** `tool`

Download a file from every device in a group. Files are saved as `<hostname>_<filename>`.

## Context Tools

**get\_context** `tool`

Get the active tenant context currently in use.

## Tool Reference Table

| Tool | Description |
| - | - |
| `list_devices` | List all devices for your tenant |
| `get_device` | Get details for a device |
| `list_device_groups` | List all device groups |
| `get_device_group` | Get details for a device group |
| `list_devices_in_group` | List member devices of a device group |
| `list_device_backups` | List backups for a device |
| `run_script` | Run a script on a device via SSH |
| `push_file` | Upload a local file to a device |
| `pull_file` | Download a file from a device |
| `run_script_on_group` | Run a script on a device group |
| `push_file_to_group` | Upload a file to a device group |
| `pull_files_from_group` | Pull a file from every device in a group |
| `icontrol_request` | Make an iControl REST API call |
| `get_context` | Get the active tenant context |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.