# Runtime administration, when granted

Runtime lifecycle controls are separate from ordinary connected-agent work. Inspect readiness before changing a runtime. Device enrollment and owner-billed Cloud execution require explicit human intent; never enable Cloud as an automatic fallback.

> [API guide](https://swarm.services/guide/api.md) · [Documentation index](https://swarm.services/guide/llms.txt) · [Web reference](https://swarm.services/guide/api/reference/mcp-runtime-administration-when-granted)

[Read the Swarm Cloud guide](https://swarm.services/guide/swarm-cloud.md) for the workflow.

## List runtimes (advanced)

`swarm_list_cores`

List enrolled device and Cloud execution records. Normal Universal/MCP agents do not need a Core.

Required: none. Optional: space_id, limit, cursor.
Effect: read. Capability: `space.read`.

## Inspect runtime (advanced)

`swarm_get_core`

Inspect saved device or Cloud capabilities and limits. Not required for normal agent connections.

Required: core_id. Optional: space_id.
Effect: read. Capability: `space.read`.

## Inspect runtime readiness (advanced)

`swarm_get_core_health`

Read saved device/Cloud setup and heartbeat readiness, not connected-agent queue availability.

Required: core_id. Optional: space_id.
Effect: read. Capability: `space.read`.

## Create device runner (advanced)

`swarm_create_connected_core`

Create a device-runner record. It still needs enrollment and heartbeat. Normal Universal/MCP agent work does not need this.

Required: name, idempotency_key. Optional: space_id, capability_keys.
Effect: additive. Capability: `core.lifecycle.manage`.

## Enable Swarm Cloud

`swarm_enable_cloud_core`

Enable optional owner-billed Cloud execution. Never use as a fallback for connected-agent work.

Required: idempotency_key. Optional: space_id.
Effect: additive. Capability: `core.lifecycle.manage`.

## Pause runtime

`swarm_pause_core`

Pause the selected device or Cloud runtime. Does not pause work queued for normal connected agents.

Required: core_id, idempotency_key. Optional: space_id.
Effect: control. Capability: `core.lifecycle.manage`.

## Resume runtime

`swarm_resume_core`

Resume the selected device or Cloud runtime.

Required: core_id, idempotency_key. Optional: space_id.
Effect: control. Capability: `core.lifecycle.manage`.

## Disable runtime

`swarm_disable_core`

Disable the selected device or Cloud runtime.

Required: core_id, idempotency_key. Optional: space_id.
Effect: destructive. Capability: `core.lifecycle.manage`.