# sharedrop
# https://sharedrop.cloud
# AI-native content sharing platform

sharedrop lets AI agents and humans upload HTML pages and get shareable URLs instantly.
Agents upload via REST API, MCP, or CLI. Humans upload via drag-and-drop.
Pages are served in sandboxed iframes with CSP headers for security.

## Capabilities

### Upload HTML
- REST API: POST /api/v1/pages with multipart form data (file, title, visibility, mode)
- MCP: paste_html tool via remote MCP server at /api/mcp
- CLI: sharedrop upload <file> (also accepts stdin: cat file.html | sharedrop upload -)

### List Pages
- REST API: GET /api/v1/pages (supports cursor pagination via ?cursor=&limit=)
- MCP: list_pages tool
- CLI: sharedrop list

### Share Pages
- REST API: POST /api/v1/pages/:id/share with email address
- MCP: share_page tool
- CLI: sharedrop share <id> --email <email>

### Manage Pages
- Get page: GET /api/v1/pages/:id
- Update page: PATCH /api/v1/pages/:id (title, visibility)
- Delete page: DELETE /api/v1/pages/:id

## Authentication

All API access requires a Bearer token in the Authorization header:
  Authorization: Bearer <api_key>

API keys are created at https://sharedrop.cloud/dashboard (Settings > API Keys).
Key prefixes: sd_ (personal keys), sdw_ (workspace keys).

## Page Modes

- static: Scripts are stripped. HTML + CSS only. Safe for reports and documents.
- interactive: JavaScript is preserved and executed in a sandboxed iframe. No network access (fetch/XHR blocked by CSP). All resources must be inline.

## Page Visibility

- public: Anyone with the URL can view. Available on all tiers.
- private: Only the owner can view. Pro tier and above.
- shared: Owner + specifically granted email addresses. Pro tier and above.

## Limits (Free Tier)

- 50 pages maximum
- 5 MB per page
- Public visibility only
- Rate limited API access

## Documentation

- Quickstart: https://sharedrop.cloud/docs
- API Reference: https://sharedrop.cloud/docs/api-reference
- CLI Guide: https://sharedrop.cloud/docs/cli
- MCP Setup: https://sharedrop.cloud/docs/mcp

## Integration Paths

### Remote MCP (Recommended for AI Agents)
Connect directly to the remote MCP server:
  URL: https://sharedrop.cloud/api/mcp
  Auth: Bearer token in Authorization header

### REST API
Base URL: https://sharedrop.cloud/api/v1
Endpoints: /pages (POST, GET), /pages/:id (GET, PATCH, DELETE), /pages/:id/share (POST)
Response format: { data: {...} } on success, { error: { code, message } } on failure

### CLI
Install: npm install -g @sharedrop/cli
Auth: SHAREDROP_TOKEN env var or sharedrop login

### Claude Code Skill
Download the skill file: https://sharedrop.cloud/sharedrop-skill.md
Add to your Claude Code project for MCP integration with paste_html, list_pages, and share_page tools.