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. |
create_upload_link
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.