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": {
      "type": "http",
      "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. When prompted, authenticate via the browser and paste the callback URL into your terminal.

3. Auto-approve Tool Calls (Optional)

By default, Claude Code asks permission each time a DropAI tool is used. To skip the prompt, add these to the allowedTools array in your .claude.json:

"allowedTools": [
  "mcp__dropai__dropai_upload",
  "mcp__dropai__dropai_get",
  "mcp__dropai__dropai_list"
]

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. Uses your account default if omitted. Set to 0 for permanent (Pro only). Capped to your plan's max TTL.
max_views - Max views before auto-delete (0 = unlimited)
visibility - public (default), unlisted, or private (Pro only)

`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 drops from your account with pagination. Returns total count for easy paging.

Parameters:

limit - Number of results (default 10, max 50)
offset - Number of items to skip for pagination (default 0)
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"