MCP Setup

Connect AI agents to sharedrop using the Model Context Protocol.

What is MCP?

The Model Context Protocol (MCP) is an open standard for connecting AI agents to external tools and data sources. sharedrop implements an MCP server that lets agents upload HTML, list pages, and share them -- all through the standard MCP tool interface.

Remote MCP (Recommended)

The simplest way to connect is using sharedrop's hosted remote MCP endpoint. No installation needed.

Configuration

Add this to your MCP client configuration (e.g., Claude Desktop, Cursor, or any MCP-compatible client):

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

Replace sd_your_api_key_here with your actual API key. See Authentication for how to create one.

Benefits

• No installation or setup
• Always up to date
• Works with any MCP client that supports remote servers
• Same rate limits as the REST API

Local MCP

If you prefer to run the MCP server locally (e.g., for development or if your client doesn't support remote MCP), use the @sharedrop/mcp npm package.

Configuration

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

This runs the MCP server as a local process that communicates with the sharedrop API.

Available Tools

The MCP server exposes three tools:

paste_html

Upload HTML content to sharedrop and get a shareable URL.

Parameters:

Name	Type	Required	Description
html	string	Yes	HTML content to upload
title	string	No	Page title
mode	string	No	static or interactive
visibility	string	No	public, private, or shared

Returns: Page URL and metadata.

list_pages

List your uploaded pages.

Parameters:

Name	Type	Required	Description
limit	number	No	Results per page (default: 50)
cursor	string	No	Pagination cursor

Returns: Array of page metadata with pagination.

share_page

Share a page with someone by email.

Parameters:

Name	Type	Required	Description
page_id	string	Yes	Page ID to share
email	string	Yes	Email address to share with

Returns: Access grant details.

Example Workflow

Here is what a typical AI agent interaction looks like with sharedrop MCP:

1. Agent generates HTML -- Creates a report, dashboard, or visualization
2. Agent calls paste_html -- Uploads the HTML with a title
3. Agent receives URL -- Gets back a shareable sharedrop.cloud link
4. Agent shares the link -- Sends the URL to the user in chat, or calls share_page to grant email access

User: "Generate a sales dashboard for Q1 2026"

Agent: I'll create that dashboard and share it with you.

[Agent generates HTML dashboard]
[Agent calls paste_html with the HTML]
[Agent receives https://sharedrop.cloud/agent/abc123]

Agent: Here's your Q1 2026 sales dashboard:
https://sharedrop.cloud/agent/abc123

Troubleshooting

"UNAUTHORIZED" Error

Your API key is missing or invalid. Verify:

• The key starts with sd_ or sdw_
• The key hasn't been revoked
• The Authorization header format is Bearer <key> (for remote MCP)
• The SHAREDROP_API_KEY env var is set (for local MCP)

"RATE_LIMIT_EXCEEDED" Error

You've hit the rate limit for your plan tier. Wait for the rate limit window to reset (60 seconds) or upgrade your plan for higher limits.

Connection Timeout

For remote MCP, ensure your network can reach https://sharedrop.cloud. For local MCP, ensure npx can install and run @sharedrop/mcp.