IronShard Object Storage Sandbox

Official8 tools

by ironshard

Create a free sandbox object storage bucket; upload, download, list, inspect, and delete objects.

ai.ironshard/agent-storage-sandbox — MCP Server

The ai.ironshard/agent-storage-sandbox MCP server creates a free sandbox object storage bucket and provides tools to upload, download, list, inspect, and delete objects. It is designed for working with stored files within the sandbox bucket for developer workflows.

🛠️ Key Features

Create a free sandbox object storage bucket
Upload objects
Download objects
List objects
Inspect objects
Delete objects

🚀 Use Cases

Sandbox object storage for agent-related development
Testing storage operations such as upload, retrieval, enumeration, inspection, and cleanup

⚡ Developer Benefits

Focused tool set for common object lifecycle tasks
Direct support for inspecting stored objects in the sandbox bucket

⚠️ Limitations

Limited to sandbox object storage bucket operations as described (no additional services provided)

Captured live from the server via tools/list.

create_bucket

Create a strictly limited, agent-owned sandbox bucket.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

get_bucket_permissions

Return the buckets and operations allowed by the active access policy. Each rule refers to an existing bucket and the operations permitted on it. The result reflects the current policy and may change when policy settings are updated.

Parameters2

bucket_name	string	required
bucket_token	string	required

Raw schema

{
  "type": "object",
  "properties": {
    "bucket_name": {
      "type": "string"
    },
    "bucket_token": {
      "type": "string"
    }
  },
  "required": [
    "bucket_name",
    "bucket_token"
  ],
  "additionalProperties": false
}

get_bucket

Return configuration and policy-visible state for one bucket.

Parameters2

bucket_name	string	required
bucket_token	string	required

Raw schema

{
  "type": "object",
  "properties": {
    "bucket_name": {
      "type": "string"
    },
    "bucket_token": {
      "type": "string"
    }
  },
  "required": [
    "bucket_name",
    "bucket_token"
  ],
  "additionalProperties": false
}

upload_object

Create a short-lived presigned URL for uploading an object. Send the object's bytes as the body of an HTTP PUT request to the returned URL. The maximum content size is 5 GB. If the key does not exist, this creates a new object. If it exists in a versioned bucket, this creates a new version; in a non-versioned bucket, this overwrites the object's contents. See the "Object uploads" section of the object-storage guide at ``ironshard://docs/object-storage`` for encryption, content type, custom metadata, and tagging behavior. Treat the returned URL as a secret bearer capability: do not log, share, or retain it beyond the requested transfer.

Parameters3

bucket_name	string	required
object_key	string	required
bucket_token	string	required

Raw schema

{
  "type": "object",
  "properties": {
    "bucket_name": {
      "type": "string"
    },
    "object_key": {
      "type": "string"
    },
    "bucket_token": {
      "type": "string"
    }
  },
  "required": [
    "bucket_name",
    "object_key",
    "bucket_token"
  ],
  "additionalProperties": false
}

download_object

Create a short-lived presigned URL for downloading an object. Send an HTTP GET request to the returned URL; the response body contains the object's bytes. Treat it as a secret bearer capability: do not log, share, or retain it beyond the requested transfer.

Parameters3

bucket_name	string	required
object_key	string	required
bucket_token	string	required

Raw schema

{
  "type": "object",
  "properties": {
    "bucket_name": {
      "type": "string"
    },
    "object_key": {
      "type": "string"
    },
    "bucket_token": {
      "type": "string"
    }
  },
  "required": [
    "bucket_name",
    "object_key",
    "bucket_token"
  ],
  "additionalProperties": false
}

list_objects

List objects in a bucket, ordered by key. When ``recursive`` is false, the result contains immediate child prefixes; when true, it contains a flat object listing. Use ``page_token`` to fetch subsequent pages.

Parameters6

bucket_name	string	required
bucket_token	string	required
prefix	any	optional
recursive	boolean	optional	False for directory-like listing, True for flat object list
page_size	integer	optional
page_token	any	optional

Raw schema

{
  "type": "object",
  "properties": {
    "bucket_name": {
      "type": "string"
    },
    "bucket_token": {
      "type": "string"
    },
    "prefix": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    },
    "recursive": {
      "default": false,
      "description": "False for directory-like listing, True for flat object list",
      "type": "boolean"
    },
    "page_size": {
      "default": 100,
      "maximum": 1000,
      "minimum": 1,
      "type": "integer"
    },
    "page_token": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null
    }
  },
  "required": [
    "bucket_name",
    "bucket_token"
  ],
  "additionalProperties": false
}

delete_object

Delete an object.

Parameters3

bucket_name	string	required
object_key	string	required
bucket_token	string	required

Raw schema

{
  "type": "object",
  "properties": {
    "bucket_name": {
      "type": "string"
    },
    "object_key": {
      "type": "string"
    },
    "bucket_token": {
      "type": "string"
    }
  },
  "required": [
    "bucket_name",
    "object_key",
    "bucket_token"
  ],
  "additionalProperties": false
}

get_object_metadata

Return metadata of an object like size, creation time, ETag, content type, user-given metadata, and tags.

Parameters3

bucket_name	string	required
object_key	string	required
bucket_token	string	required

Raw schema

{
  "type": "object",
  "properties": {
    "bucket_name": {
      "type": "string"
    },
    "object_key": {
      "type": "string"
    },
    "bucket_token": {
      "type": "string"
    }
  },
  "required": [
    "bucket_name",
    "object_key",
    "bucket_token"
  ],
  "additionalProperties": false
}

Install

Tools (8)

create_bucketget_bucket_permissionsget_bucketupload_objectdownload_objectlist_objectsdelete_objectget_object_metadata

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://agents-mcp.ironshard.ai/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "agent-storage-sandbox": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://agents-mcp.ironshard.ai/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

ai.ironshard/agent-storage-sandbox — MCP Server

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

create_bucket

get_bucket_permissions

get_bucket

upload_object

download_object

list_objects

delete_object

get_object_metadata

Install

Remote endpoint

Related servers