API reference

MCP tools

The tools the MCP server at /mcp offers, and their inputs. An agent only sees the tools its key or OAuth connection is allowed to use.

Connecting is covered in AI agents. The server speaks MCP over streamable HTTP at https://drop.media/mcp. Every tool returns the file (or files) with its link and a markdown snippet.

upload_file

Add a file from a URL, from base64 contents, or from the conversation. Needs files:write.

urlstring A public http(s) URL to fetch.
content_base64string The contents, base64 encoded. Needs filename.
filenamestring The name including extension.
fileobject A file from the conversation (ChatGPT passes these): download_url and file_id, with optional mime_type and file_name.
visibilitystring public (default) or private.
expires_instring Delete the file after this long, e.g. 30m, 7d, 2w.
namestring A readable id for the link instead of a random one.
prompt, modelstring For an AI-made image, the prompt and model, kept with the file.

A one-time URL for a file on disk. The agent then runs the curl command it returns, so the file never passes through the model: the best way for agents with a shell, and for big files. Needs files:write.

filenamerequiredstring The name of the file that will be sent.
visibilitystring public (default) or private.
expires_instring Delete the file after this long, e.g. 30m, 7d, 2w.
namestring A readable id for the link instead of a random one.
prompt, modelstring For an AI-made image, the prompt and model.

list_files

Search the library, newest first. Needs files:read.

searchstring Words to find in names and AI prompts. Every word must match.
typestring all, images, video, audio, pdfs, docs or generated.
pageinteger Starting at 1.
per_pageinteger 1 to 100. Default 20.

get_file

One file and its link. Needs files:read.

idrequiredstring The file id, from upload_file or list_files.

share_file

A link to hand out. For a private file it's a signed link that expires. Needs files:read.

idrequiredstring The file id.
ttlstring How long a private link works, e.g. 15m, 1h, 3d. Default 1h, at most 7d.

delete_file

Deletes a file. Needs files:delete.

idrequiredstring The file id.

send_feedback

Tells the drop.media team about something that didn't work or was confusing. Any connection can use it.

messagerequiredstring What happened, what was expected, and anything that would help (up to 4000 characters).
kindstring bug, confusing, feature_request, praise or other (default).
toolstring The tool it's about, e.g. upload_file.
clientstring The app or agent it came from, e.g. Claude Code.

Hints for clients

Every tool declares readOnlyHint, destructiveHint and openWorldHint, and the OAuth scope it needs (securitySchemes), so clients can ask before running a destructive tool.