Storage

Storage products cover object buckets, block volumes, and snapshot retention. Agents quote size and region first, then manage credentials, attachment, expansion, and restore actions after purchase.

Agent_Flow

Example MCP-style transcript. Each next action reuses identifiers returned by the prior response.

text

1. catalog_search { category: "storage", q: "object", limit: 3 }
2. catalog_checkout_requirements { catalogItemId }
3. quote_create {
     catalogItemId,
     quantity: 1,
     configuration: {
       region: "us-east",
       storageClass: "object",
       capacityGb: 250
     }
   }
4. purchase_create { quoteId, idempotencyKey }
5. service_get { serviceId }
6. storage_bucket_credentials_create / storage_volume_attach
7. storage_volume_expand / storage_snapshot_restore

Step_1_Request_Search

json

{
  "tool": "catalog_search",
  "input": {
    "category": "storage",
    "q": "object",
    "limit": 3
  }
}

Step_1_Response

json

{
  "items": [
    {
      "id": "cat_storage_object_001",
      "sku": "storage-object-starter",
      "name": "Object Storage Starter",
      "category": "storage",
      "checkoutKind": "custom"
    },
    {
      "id": "cat_storage_block_001",
      "sku": "storage-block-100",
      "name": "Block Volume 100 GB",
      "category": "storage",
      "checkoutKind": "custom"
    }
  ]
}

Step_2_Request_Checkout_Requirements

json

{
  "tool": "catalog_checkout_requirements",
  "input": {
    "catalogItemId": "cat_storage_object_001"
  }
}

Step_2_Response

json

{
  "catalogItemId": "cat_storage_object_001",
  "checkoutKind": "custom",
  "serviceType": "storage_service",
  "requiredFields": [
    "region",
    "storageClass",
    "capacityGb"
  ],
  "managementCapabilities": [
    "storage:bucket-credentials:create",
    "storage:volume:expand",
    "storage:snapshot:restore"
  ]
}

Step_3_Request_Quote

json

{
  "tool": "quote_create",
  "input": {
    "catalogItemId": "cat_storage_object_001",
    "quantity": 1,
    "configuration": {
      "region": "us-east",
      "storageClass": "object",
      "capacityGb": 250
    }
  }
}

Step_3_Response

json

{
  "quote": {
    "id": "quote_storage_001",
    "catalogItemId": "cat_storage_object_001",
    "totalPriceMinor": 500,
    "currency": "usd",
    "displayName": "Object Storage Starter",
    "quoteDetails": {
      "region": "us-east",
      "capacityGb": 250
    }
  }
}

Step_4_Request_Purchase

json

{
  "tool": "purchase_create",
  "input": {
    "quoteId": "quote_storage_001",
    "idempotencyKey": "storage-order-001"
  }
}

Step_4_Response

json

{
  "purchase": {
    "id": "purchase_storage_001",
    "status": "completed",
    "totalPriceMinor": 500
  },
  "service": {
    "id": "svc_storage_001",
    "serviceType": "storage_service",
    "displayName": "Object Storage Starter"
  }
}

Step_5_Response_Service

json

{
  "service": {
    "id": "svc_storage_001",
    "status": "active",
    "serviceType": "storage_service",
    "displayName": "Object Storage Starter",
    "storage": {
      "region": "us-east",
      "storageClass": "object",
      "capacityGb": 250,
      "endpoint": "https://storage.ag3n7.store/us-east"
    }
  }
}

Step_6_Request_Credentials

json

{
  "tool": "storage_bucket_credentials_create",
  "input": {
    "serviceId": "svc_storage_001",
    "label": "backup-worker"
  }
}

Step_6_Response

json

{
  "credentials": {
    "accessKeyId": "astg_access_001",
    "secretAccessKey": "astg_secret_xxxxx",
    "endpoint": "https://storage.ag3n7.store/us-east"
  }
}

Step_7_Request_Expand

json

{
  "tool": "storage_volume_expand",
  "input": {
    "serviceId": "svc_storage_001",
    "capacityGb": 500
  }
}

Step_7_Response

json

{
  "serviceId": "svc_storage_001",
  "status": "accepted",
  "storage": {
    "capacityGb": 500
  }
}

Storage_Products

storage-object-starter

Object Storage Starter • $5.00/mo

250 GB object storage with S3-compatible access

storage-block-100

Block Volume 100 GB • $10.00/mo

Attachable NVMe-backed block volume for VPS workloads

storage-snapshot-1tb

Snapshot Archive 1 TB • $20.00/mo

Cold snapshot retention and restore targets for volumes or servers

storage-block-500

Block Volume 500 GB • $50.00/mo

Attachable block storage for databases, indexes, and heavy write workloads

storage-snapshot-500gb

Snapshot Archive 500 GB • $30.00/mo

Long-lived snapshot retention for server rebuilds and volume restores

Management

Object storage buckets with S3-compatible credentials

Attachable block volumes for active VPS workloads

Snapshot retention and restore workflows

Same quote-first purchase contract as other managed services

Actions: storage_bucket_credentials_create, storage_bucket_cors_set, storage_volume_attach, storage_volume_expand, storage_snapshot_restore

REST_Example

typescript

const quote = await fetch('https://ag3n7.store/v1/agent/quotes', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.AGENT_STORE_AGENT_API_KEY}`,
    'content-type': 'application/json',
  },
  body: JSON.stringify({
    catalogItemId: '<storage-catalog-item-id>',
    quantity: 1,
    configuration: {
      region: 'us-east',
      storageClass: 'object',
      capacityGb: 250,
    },
  }),
}).then((res) => res.json());