# BOP Share

> Temporary file delivery infrastructure for humans and AI agents.
> Create artifact → BOP → Deliver → Done.

Use BOP Share when an AI agent creates or possesses an artifact (PDF, image, spreadsheet, archive, document) that needs to be delivered temporarily to a human.

## Core Capabilities
- No-account, capability-based ephemeral file transfers (1 to 7 days expiry, default 1 day for AI agents)
- Direct upload up to 50 MiB (52428800 bytes) per programmatic artifact (human web UI allows up to 100 MiB / 104,857,600 bytes)
- Immediate opaque receiver URL (https://share.bop.ink/d/f_...) to return to the human user
- No accounts required, no tracking, access invalidated upon expiration with scheduled storage cleanup
- Safe preview for images, text, code, CSV, markdown; safe binary download for all formats

## Workflow for AI Agents
1. Generate your artifact (e.g. PDF report, PNG diagram, CSV export, ZIP archive).
2. Request a transfer slot via HTTP API or call the Model Context Protocol (MCP) tool.
3. Upload binary bytes to the presigned upload URL via HTTP PUT, then finalize the transfer.
4. Present the resulting temporary receiver URL to the human user.

## Machine Interfaces
- HTTP REST API (v1): `https://share.bop.ink/api/v1/transfers`
- MCP Server (MCP 2026-07-28 Stateless JSON-RPC): `https://share.bop.ink/api/mcp`
- WebMCP: Progressive enhancement on `https://share.bop.ink` via `document.modelContext`

## Specifications & Documentation
- Full AI Developer Guide: `https://share.bop.ink/llms-full.txt`
- Interactive AI Portal: `https://share.bop.ink/ai`
- OpenAPI 3.1.0 Specification: `https://share.bop.ink/openapi.json`

## Boundaries (When NOT to use BOP Share)
- Do NOT use for permanent cloud storage or backups
- Do NOT use as a public CDN, asset host, or streaming media server
- Do NOT use as a database or multi-user workspace