Buckets

This reference is auto-generated from the registered MCP tool providers in perspectapiworkers. It reflects the tools exposed by the per-site Perspect MCP server.

Connection

Use the per-site MCP endpoint:

https://perspect.com/mcp/{siteName}

Authenticate with OAuth or an MCP API key using Authorization: Bearer sk_mcp_....

Tools

bucket_create

Title: Create R2 Bucket

Provision a new Cloudflare R2 bucket for the organization. The bucket name is auto-generated — no name input is needed or accepted. The bucket is created in the org pool, unattached to any site. Managed WfP scripts attach at most one R2 bucket as env.BUCKET; attach/detach/delete must be done manually through the admin console.

Required permission: app.write

Parameters

This tool accepts no arguments.

Example call

{
  "tool": "bucket_create",
  "arguments": {}
}

Output schema

{
  "type": "object",
  "additionalProperties": true
}

bucket_delete

Title: Delete R2 Bucket

Deleting an R2 bucket is not available as an agent action. Direct the user to do this manually through the admin console.

Required permission: app.write

Parameters

Parameter	Type	Required	Default	Description
bucket_id	string	Yes	—	The site bucket ID to delete

Example call

{
  "tool": "bucket_delete",
  "arguments": {
    "bucket_id": "string"
  }
}

Output schema

{
  "type": "object",
  "additionalProperties": true
}

bucket_list

Title: List R2 Buckets

List all R2 buckets in the organization's pool, including which site each is attached to and whether it is bound as env.BUCKET.

Required permission: app.read

Parameters

This tool accepts no arguments.

Example call

{
  "tool": "bucket_list",
  "arguments": {}
}

Output schema

{
  "type": "object",
  "additionalProperties": true
}

bucket_unbind

Title: Unbind R2 Bucket

Removing an R2 bucket binding is not available as an agent action. Direct the user to do this manually through the admin console.

Required permission: app.deploy

Parameters

Parameter	Type	Required	Default	Description
bucket_id	string	Yes	—	The site bucket ID to unbind

Example call

{
  "tool": "bucket_unbind",
  "arguments": {
    "bucket_id": "string"
  }
}

Output schema

{
  "type": "object",
  "additionalProperties": true
}

---

This page is generated from the registered MCP tool providers. Do not edit it by hand.