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

# Manage Storage Volumes with AI Agents

> Use MCP tools to create, list, and delete persistent storage volumes across regions — all through conversation with your AI agent.

export const RuncrateStyles = () => {
  if (typeof document !== 'undefined' && !document.getElementById('runcrate-overrides')) {
    const s = document.createElement('style');
    s.id = 'runcrate-overrides';
    s.textContent = `
      /* Match Runcrate's rounding scale (--radius: 0.75rem) */
      .rounded-sm { border-radius: 0.5rem !important; }   /* 8px */
      .rounded-md { border-radius: 0.625rem !important; } /* 10px */
      .rounded-lg { border-radius: 0.75rem !important; }  /* 12px */
      .rounded-l-sm { border-top-left-radius: 0.5rem !important; border-bottom-left-radius: 0.5rem !important; }
      .rounded-r-sm { border-top-right-radius: 0.5rem !important; border-bottom-right-radius: 0.5rem !important; }
      .rounded-l-md { border-top-left-radius: 0.625rem !important; border-bottom-left-radius: 0.625rem !important; }
      .rounded-r-md { border-top-right-radius: 0.625rem !important; border-bottom-right-radius: 0.625rem !important; }
      .rounded-l-lg { border-top-left-radius: 0.75rem !important; border-bottom-left-radius: 0.75rem !important; }
      .rounded-r-lg { border-top-right-radius: 0.75rem !important; border-bottom-right-radius: 0.75rem !important; }

      /* Cards: never pure white in light mode */
      .card { background-color: #fcfcfc !important; border-radius: 0.75rem !important; }
      html.dark .card { background-color: #141414 !important; }

      /* Docs hero box */
      .rc-hero { background-color: #fcfcfc; border: 1px solid #e0e0e0; }
      html.dark .rc-hero { background-color: #141414; border-color: #242424; }
      html.dark .rc-hero h1 { color: #f5f5f5; }

      /* Runcrate scrollbar — thin, transparent track, hide-until-hover thumb */
      ::-webkit-scrollbar { width: 6px; height: 6px; background-color: transparent; }
      ::-webkit-scrollbar-track { background-color: transparent; }
      ::-webkit-scrollbar-thumb { background-color: rgba(155, 155, 155, 0.5); border-radius: 10px; transition: opacity 0.3s ease; opacity: 0; }
      ::-webkit-scrollbar-thumb:hover { background-color: rgba(155, 155, 155, 0.7); }
      *:hover::-webkit-scrollbar-thumb,
      *:focus::-webkit-scrollbar-thumb,
      *:active::-webkit-scrollbar-thumb { opacity: 1; }
      * { scrollbar-width: thin; scrollbar-color: rgba(155, 155, 155, 0.5) transparent; }
    `;
    document.head.appendChild(s);
  }
  return null;
};

<RuncrateStyles />

Persistent volumes survive instance termination. Your AI agent can create volumes, check available regions, list existing storage, and clean up unused volumes.

***

## "I need a 500GB volume for my training dataset. What regions are available?"

The agent checks regions and creates the volume:

1. **`list_storage_regions`** — returns available regions with capacity
2. **`create_volume`** — creates the volume in your chosen region

> **Available storage regions:**
>
> | Region         | Location      |
> | -------------- | ------------- |
> | us-east-1      | Virginia, US  |
> | us-west-2      | Oregon, US    |
> | eu-central-1   | Frankfurt, DE |
> | ap-southeast-1 | Singapore     |
>
> Which region do you want? (I'd suggest us-east-1 if your instances are in the US.)

After you reply "us-east-1":

3. **`create_volume`** — creates `training-data` (500 GB) in us-east-1

> Created volume **training-data** (500 GB) in us-east-1.
> Mount it to any instance in the same region from the dashboard or CLI.

***

## "Show me all my volumes and how much storage I'm using."

The agent lists your storage:

1. **`list_volumes`** — returns all volumes with sizes, regions, and status

> You have 3 volumes:
>
> | Volume            | Size   | Region       | Status    | Created     |
> | ----------------- | ------ | ------------ | --------- | ----------- |
> | training-data     | 500 GB | us-east-1    | available | 2 hours ago |
> | model-checkpoints | 200 GB | us-east-1    | attached  | 3 days ago  |
> | old-experiment    | 100 GB | eu-central-1 | available | 2 weeks ago |
>
> Total storage: **800 GB**.
> **old-experiment** has been idle for 2 weeks and is in a different region from your instances. Want me to delete it?

***

## "Delete old-experiment and create a new 1TB volume for my image dataset."

The agent handles both operations:

1. **`delete_volume`** — deletes `old-experiment` (unused credits refunded)
2. **`list_storage_regions`** — confirms region availability for 1TB
3. **`create_volume`** — creates `image-dataset` (1000 GB) in us-east-1

> Deleted **old-experiment** (100 GB) in eu-central-1. Unused time refunded to your balance.
> Created **image-dataset** (1,000 GB) in us-east-1.
>
> Updated storage summary:
>
> * training-data: 500 GB (us-east-1)
> * model-checkpoints: 200 GB (us-east-1)
> * image-dataset: 1,000 GB (us-east-1)
>
> Total: **1,700 GB** across 3 volumes.

***

## Tools used in this workflow

| Tool                   | Purpose                                         |
| ---------------------- | ----------------------------------------------- |
| `list_storage_regions` | Check available regions before creating volumes |
| `create_volume`        | Provision new persistent storage                |
| `list_volumes`         | Audit existing storage and identify waste       |
| `delete_volume`        | Remove unused volumes and reclaim credits       |