# open_uploader

Canonical HTML page: https://bitterclip.com/docs/assistants/tools/open_uploader

Surface: app-only

Product release: 185ad8f4adfa21ae055b5bd6f97968d9044480d1
Public contract commit: d2ab41fab4088c07c0f6b924fa4f3c63481b936a
Public contract SHA-256: 2365c73c2aef7b9f85e8434d8e29ea29f40824bc3a46a72a356155ea328757fc
Descriptor SHA-256: ef560141873b318181e4a3e6c2c93c1bbe9d49fc3c3fd417cce2e079ef1c4bee
Captured: 2026-10-29T03:35:56.855Z
Source: https://app.bitterclip.com/api/v1/mcp_descriptors.json

Use this when the user wants to add a local audio or video recording to BitterClip. Returns a shareable, token-gated upload link (a hosted drop-zone page) the user opens in a browser to drop their file — it uploads straight to storage and starts transcribing on its own. `project` (a project name, slug, or public ID) scopes the upload to that project; without it, uploads land in the account's default uploads project. The returned `upload_url` is the page the user opens, so no public download URL is needed.

The JSON blocks below are the exact MCP descriptor projections served by Rails for the named profiles at capture time. Security schemes and resource URIs may vary by connected host.

## App descriptor

```json
{
  "name": "open_uploader",
  "title": "Get a recording upload link",
  "description": "Use this when the user wants to add a local audio or video recording to BitterClip. Returns a shareable, token-gated upload link (a hosted drop-zone page) the user opens in a browser to drop their file — it uploads straight to storage and starts transcribing on its own. `project` (a project name, slug, or public ID) scopes the upload to that project; without it, uploads land in the account's default uploads project. The returned `upload_url` is the page the user opens, so no public download URL is needed.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "project": {
        "type": "string",
        "description": "Optional project to attach uploads to: a project name, slug, or public ID; absent means the default uploads project."
      },
      "capture_session_id": {
        "type": "string",
        "description": "Optional footage-session public ID. Every file uploaded through the link joins this same capture chronology."
      }
    },
    "required": [],
    "additionalProperties": false
  },
  "annotations": {
    "title": "Get a recording upload link",
    "readOnlyHint": false,
    "destructiveHint": false,
    "idempotentHint": false,
    "openWorldHint": false
  },
  "securitySchemes": [
    {
      "type": "noauth"
    }
  ],
  "_meta": {
    "securitySchemes": [
      {
        "type": "noauth"
      }
    ],
    "ui": {
      "visibility": [
        "app"
      ]
    },
    "openai/widgetAccessible": true,
    "openai/visibility": "private"
  },
  "outputSchema": {
    "type": "object",
    "properties": {
      "mode": {
        "type": "string",
        "description": "\"upload_link\" when a shareable upload link is returned."
      },
      "upload_url": {
        "type": "string",
        "description": "The token-gated drop-zone page URL for the user."
      },
      "project": {
        "type": "object",
        "description": "The resolved project the uploads land in, or null for the default project."
      },
      "capture_session": {
        "type": "object",
        "description": "The footage session the uploads join, when requested."
      },
      "expires_at": {
        "type": "string",
        "description": "ISO8601 link expiry (7 days out)."
      },
      "accepted_content_types": {
        "type": "array",
        "items": {
          "type": "string"
        }
      },
      "max_bytes": {
        "type": "integer"
      }
    },
    "required": [],
    "additionalProperties": false
  }
}
```

## Errors

```json
[
  "invalid_input"
]
```

## Examples

```json
[]
```
