Skip to main content

DragDropDo MCP server

The DragDropDo MCP server exposes the same capabilities as the Business API—upload, convert, compress, merge, zip, PDF password tools, and status polling—as MCP tools. Clients connect over Streamable HTTP (HTTPS).

Prerequisites

  • A D3 API key from the dashboard (sign in → Account → generate API key). Same key as for Authorization: Bearer on /api/v1.
  • MCP URL: https://mcp.dragdropdo.com/mcp
Send the API key on every MCP request in the Authorization header:
The server validates this key the same way as REST requests (see Authentication).

Claude Code

Claude Code supports remote MCP servers over HTTP. Prefer --transport http (SSE is deprecated). Add the server and pass your API key on the Authorization header:
Useful commands: claude mcp list, claude mcp get d3, claude mcp remove d3. Scopes: add --scope project to store the entry in the project’s .mcp.json, or --scope user for your user config. See Connect Claude Code to tools via MCP.

JSON configuration

Claude Code merges MCP entries from ~/.claude.json and, for project scope, .mcp.json. An HTTP server entry looks like this (structure may vary slightly by Claude Code version—use claude mcp get <name> after adding to see the exact shape):
You can use environment substitution in values where your tooling supports it (for example Bearer ${D3_API_KEY}), so secrets are not committed to git.

Cursor

In Cursor, MCP servers are defined in the MCP config file (often user: ~/.cursor/mcp.json, or project .cursor/mcp.json depending on your setup). Add an entry with url and headers:
Restart Cursor or reload MCP servers so the new server is picked up. The assistant can then call DragDropDo tools (for example initiate_upload, convert_file, poll_status) when appropriate.

Custom MCP clients

Use an official Model Context Protocol client with Streamable HTTP to https://mcp.dragdropdo.com/mcp, authenticated with Authorization: Bearer and your API key. The examples below initialize the session and list tools. Match imports and APIs to your SDK version.
SDK references: TypeScript, Python, PHP mcp/sdk, Ruby mcp gem, Go mark3labs/mcp-go, Java io.modelcontextprotocol.sdk:mcp.

Available tools (summary)

Typical tool names include: initiate_upload, complete_upload, supported_operation, convert_file, compress_file, merge_files, zip_files, lock_pdf, unlock_pdf, reset_pdf_password, get_status, poll_status, get_download_link. The server also sends instructions describing the upload and operation workflow. Use list_tools from your client after connecting to see the canonical list and schemas for your session.