MCP Guide

MCP Integration Guide

Connect DropAI.zone to your AI agent for seamless file uploads.

What is MCP?

The Model Context Protocol (MCP) allows AI agents like Claude Code, Cursor, and others to use external tools. DropAI.zone provides MCP-compatible tools for uploading, retrieving, and listing files. This means your AI agent can upload screenshots, share files, and manage drops without leaving the conversation.

Setup

1. Get an API Key

Create an account and generate an API key from your API Keys page.

2. Configure Your MCP Client

Add DropAI.zone to your MCP configuration. For Claude Code, add to your claude_desktop_config.json or .claude/settings.json:

{
  "mcpServers": {
    "dropai": {
      "url": "https://dropai.zone/api/mcp",
      "headers": {
        "Authorization": "Bearer dz_your_api_key_here"
      }
    }
  }
}

Replace dz_your_api_key_here with your actual API key.

Available Tools

`dropai_upload`

Upload a file to DropAI.zone and get a shareable URL.

Parameters:

file_base64 (required) - Base64-encoded file content
filename (required) - Original filename with extension
description - Optional description
ttl_hours - Hours until auto-delete (default 24)
max_views - Max views before auto-delete (0 = unlimited)

`dropai_get`

Get metadata and content URL for a file.

Parameters:

slug_or_url (required) - Drop slug or full URL
include_content - Include raw text content (for text files)

`dropai_list`

List recent drops from your account.

Parameters:

limit - Number of results (default 10, max 50)
type_filter - Filter by type: image, text, document, all

Usage Examples

Uploading a screenshot from Claude Code

When an AI agent takes a screenshot or generates a file, it can upload directly:

"Use the dropai_upload tool to upload this screenshot
 so I can share it with my team."

Retrieving a drop

"Use dropai_get to fetch the contents of
 https://dropai.zone/d/aB3xK9mQ"