store_artifact
Upload a file as an artifact, either via base64 content (up to 10 MB) or local path (up to 500 MB), with metadata tagging for later retrieval.
Instructions
Upload a file as a new artifact in a single call. Provide EITHER up to ~10 MB of base64-encoded bytes via content, OR a local filesystem path that the MCP server reads and streams as multipart/form-data (up to 500 MB). For files larger than 500 MB, use request_upload_url (Pro only) instead — store_artifact returns file_too_large for them. Tags the artifact with session_id / agent_id / metadata for later retrieval and returns the full artifact record including its new artifact_id and content_hash.
Path uploads are confined. The path argument is constrained to the launcher-configured allow-list (default: the MCP server's CWD). Paths outside the allow-list, paths traversing symlinks out of it, and paths to known-sensitive locations (~/.ssh, ~/.aws, /etc/, etc.) are refused with invalid_request.
For crash-safe retries, supply your own idempotency_key (any string ≤256 chars): a replay within 24h returns the original artifact and never double-bills. If you omit it, the server auto-generates one and returns it under _meta.idempotency_key, but that key protects only in-process retries within a single call — it is lost if the server restarts, so pre-commit your own key when durability matters.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| filename | Yes | ||
| content | No | Base64-encoded bytes. Use for content under 10 MB or when no local path is available. | |
| path | No | Absolute local path inside the launcher-configured allow-list. The MCP server reads and streams this as multipart. Mutually exclusive with `content`. Paths outside the allow-list are refused. | |
| content_type | No | MIME type. If omitted, guessed from filename. | |
| session_id | No | ||
| agent_id | No | ||
| metadata | No | ||
| ttl | No | Duration suffix (e.g. `7d`, `30d`) or `never` (Pro only). Defaults to plan default. | |
| idempotency_key | No |