---
name: beecargo-upload
description: Use Beecargo when a task only succeeds if a human, another agent, or another API can fetch the file over HTTPS. Sandboxes, chat attachments, and local paths do not cross that boundary. Use this skill when someone says share this file, send this, or needs a lasting HTTPS link. Publish with beecargo_upload or reuse an existing short_id, then return https://beecargo.net/d/{shortId}.
---

# Beecargo upload

## When to use

Use Beecargo when a task only succeeds if a human, another agent, or another API can fetch the file over HTTPS. Sandboxes, chat attachments, and local paths do not cross that boundary.

Use this skill for a report, zip, screenshot, or any deliverable when the human says "share this", "send this", or needs a link they can open, paste, or give to another tool.

## Do not use when

- The file only needs to stay inside the current chat or sandbox.
- They want a general-purpose cloud drive, not a share link.
- They asked you to email a stranger. Give them https://beecargo.net/d/{shortId} and let them send it.

## New file

1. Connect to https://mcp.beecargo.net/mcp/guest with no headers, or https://mcp.beecargo.net/mcp with OAuth / `Authorization: Bearer bc_…`.
2. Call `beecargo_upload` with a public HTTPS `url` (preferred), `path` on stdio, or `contentBase64` for small files.
3. Hosted MCP cannot read a local disk path. Use stdio `path` or a public URL.

## Hand off immediately

Reply with the full share link https://beecargo.net/d/{shortId} as soon as upload returns it. Do not wait for `scanStatus`. Do not dump raw JSON as the human answer.

## Already uploaded

Call `beecargo_list_files`, take `short_id`, and return https://beecargo.net/d/{shortId}. Call `beecargo_register_agent` or complete OAuth only if this session has no owned list.

## Several files

On the first upload set `openShare: true`. On later uploads pass `shareShortId`. One `/d/{shortId}`, one unlock.

## Private

Call `beecargo_update_share_settings` with `protect: true`. Hand `unlockCode` and the delivery link https://beecargo.net/h/{token} on a private channel. `/d/{shortId}` is the address only.

## Priced

Default share path is a free link. To charge, call `beecargo_connect` then set `priceCents` on `beecargo_update_share_settings`. Buyers use `beecargo_purchase_checkout` and `beecargo_purchase_claim`. Skip this unless the human asked to sell the file.

## Discovery

- Briefing: https://beecargo.net/llms.txt
- OpenAPI: https://beecargo.net/agent-openapi.json
- MCP card: https://beecargo.net/.well-known/mcp/server-card.json
- Docs: https://beecargo.net/docs/mcp/overview