> For the complete documentation index, see [llms.txt](https://docs.apolo.us/index/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.apolo.us/index/apolo-mcp/capabilities/skills/apolo-resource-management.md).

# Apolo Resource Management

1. Resolve and display cluster/organization/project with `$apolo-platform-user-context`. Fully qualify short resource references and reject cross-context targets.
2. Prefer metadata and bounded text operations. Cap every model-visible list, wait, log, byte count, and duration; return a truthful truncation marker. Single-file transfers stream outside model context and may use a caller-selected timeout. Never move binary objects, container layers, or large directory trees through model context.
3. Use native bounded MCP operations for single-file storage and bucket transfers. Use deterministic local CLI/scripts only for recursive or bulk storage, image, or bucket transfer. Set explicit duration, overwrite, and write controls. For image creation, follow the [Flow-first image-build workflow](https://github.com/neuro-inc/apolo-mcp/tree/master/docs/capabilities/skills/apolo-flow-workloads/references/image-builds.md). Use the Flow project's image definitions when available; otherwise use the documented `apolo-extras image build` fallback. Treat its remote builder as bounded build work and deploy the resulting service through an App rather than a long-running job.
4. Before every write, state the exact operation, target, context, and effect, then invoke it so the MCP host can apply its approval UI. Require `managed` or `full` policy. Mark exact deletes destructive; reject project roots, ambiguous names, and unbounded recursion.
5. Preflight the protected ledger before creation and append the exact returned type, ID, context, and operation immediately afterward. Automatic cleanup requires an exact ledger match and never a naming convention.
6. List secrets as metadata only. Create them only from a named local environment variable, protected file, or approved secret source read internally. Never accept, fetch into, return, or log a secret value.
7. On service-account creation, preflight an exact Apolo-secret or protected `0600` file sink. Atomically write the one-time token directly to that sink and return only account metadata and destination. Never return a token even on failure.
8. Treat signed bucket URLs as temporary credentials. Require explicit scope/expiry, write them only to a new protected `0600` file, and return only sink metadata. List persistent bucket credentials with `list_bucket_credentials`, which discards provider values. Create them with `create_bucket_credentials` and export an exact existing credential with `export_bucket_credentials`; both write directly to a new protected `0600` file and never return values. Delete only an exact `delete_bucket_credentials` ID permitted by policy and lifecycle ownership. Never read the sink back into model context.

When a safe public SDK contract is absent, state the precise CLI fallback or future-scoped limitation instead of inventing a tool.

For recursive local transfers, recommend these explicit CLI fallbacks. Use full same-context URIs, inspect the local tree before upload, choose a new uniquely scoped destination, disable interactive progress, verify the downloaded tree byte-for-byte, and clean up only that exact destination:

```bash
# Local directory -> Apolo storage, then Apolo storage -> new local directory
apolo storage cp --no-progress --recursive --no-target-directory \
  LOCAL_SOURCE storage://CLUSTER/ORG/PROJECT/REMOTE_PATH
apolo storage cp --no-progress --recursive --no-target-directory \
  storage://CLUSTER/ORG/PROJECT/REMOTE_PATH LOCAL_DESTINATION

# Local directory -> bucket, then bucket -> new local directory
apolo blob cp --no-progress --recursive --no-target-directory \
  LOCAL_SOURCE blob://CLUSTER/ORG/PROJECT/BUCKET
apolo blob cp --no-progress --recursive --no-target-directory \
  blob://CLUSTER/ORG/PROJECT/BUCKET LOCAL_DESTINATION
```

Do not serialize transferred files through MCP. Prefer an MCP-created storage directory or bucket so managed-mode cleanup remains ledger-owned; otherwise require the user to approve the exact CLI cleanup target.