sharedrop Docs

Claude Code Skill

Install the sharedrop skill for Claude Code to enable direct MCP integration.

What is a Claude Code Skill?

Claude Code skills are markdown files that teach Claude Code how to use specific tools and services. When you install the sharedrop skill, Claude Code automatically knows how to upload HTML to sharedrop, list your pages, and share them -- without any additional prompting.

Skills live in your project's .claude/skills/ directory and are loaded automatically when Claude Code starts.

Installation

Download the Skill File

Download the sharedrop skill file and save it to your project:

mkdir -p .claude/skills
curl -o .claude/skills/sharedrop-skill.md https://sharedrop.cloud/sharedrop-skill.md

Or manually create .claude/skills/sharedrop-skill.md with the content below.

Skill File Content

Create .claude/skills/sharedrop-skill.md with the following content:

---
name: sharedrop
description: Upload HTML to sharedrop and get shareable links
tools:
  - mcp: sharedrop
---

# sharedrop Skill

Upload HTML reports, dashboards, and visualizations to sharedrop for instant sharing.

## When to Use

Use sharedrop when you need to:
- Share HTML output (reports, dashboards, visualizations) with a URL
- Upload generated HTML so others can view it
- Create shareable links for HTML content

## MCP Configuration

This skill requires the sharedrop MCP server. Add to your MCP config:

```json
{
  "mcpServers": {
    "sharedrop": {
      "url": "https://sharedrop.cloud/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}
```

## Available Tools

### paste_html
Upload HTML content and get a shareable URL.
- `html` (required): The HTML content to upload
- `title` (optional): Page title
- `mode` (optional): "static" (default) or "interactive"
- `visibility` (optional): "public", "private", or "shared"

### list_pages
List uploaded pages with optional pagination.
- `limit` (optional): Number of results (default: 50)
- `cursor` (optional): Pagination cursor

### share_page
Share a page with someone by email.
- `page_id` (required): The page ID to share
- `email` (required): Recipient email address

## Usage Pattern

1. Generate HTML content for the user's request
2. Call `paste_html` with the HTML and a descriptive title
3. Share the returned URL with the user
4. If the user wants to share with others, use `share_page`

MCP Configuration

The skill works with the sharedrop MCP server. You need to configure MCP in your Claude Code settings.

Add to your Claude Code MCP configuration:

{
  "mcpServers": {
    "sharedrop": {
      "url": "https://sharedrop.cloud/api/mcp",
      "headers": {
        "Authorization": "Bearer sd_your_api_key_here"
      }
    }
  }
}

Local MCP

{
  "mcpServers": {
    "sharedrop": {
      "command": "npx",
      "args": ["-y", "@sharedrop/mcp"],
      "env": {
        "SHAREDROP_API_KEY": "sd_your_api_key_here"
      }
    }
  }
}

Usage

Once installed, Claude Code will automatically use the sharedrop skill when appropriate. For example:

  • "Generate a sales report and share it" -- Claude Code creates HTML and uploads to sharedrop
  • "Upload this dashboard to sharedrop" -- Direct upload of generated content
  • "Share my last report with team@example.com" -- Uses the share tool

You can also explicitly request it:

  • "Use sharedrop to upload this HTML"
  • "Create a sharedrop link for this report"

Verification

To verify the skill is installed correctly:

  1. Start Claude Code in your project directory
  2. Ask: "What sharedrop tools do you have available?"
  3. Claude Code should list paste_html, list_pages, and share_page

If the tools are not available, check that:

  • The skill file exists at .claude/skills/sharedrop-skill.md
  • Your MCP configuration includes the sharedrop server
  • Your API key is valid