pixeldrain
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
English | 日本語
pd (Pixeldrain CLI & MCP Server)
pd is a command-line interface, Model Context Protocol (MCP) server, and Go SDK for Pixeldrain.
It provides an easy way to upload, download, and share files or albums directly from your terminal, shell scripts, and AI workflows without needing to open a browser.
![]()
The header image was generated with Muse (Muse Image).
Features
Quick File & Media Sharing: Upload files from the command line and get a shareable Pixeldrain link instantly. Convenient for sharing AI-generated images, screenshots, or outputs in chats and forums.
AI & MCP Integration: Built-in MCP server (
pd mcp) that lets AI tools (such as Claude Desktop and Cursor) upload and download files on your behalf.Album Support: Combine multiple files into a single Pixeldrain album URL with
--album.End-to-End Encryption: Encrypt files client-side using age or SSH public keys before uploading.
Unix Pipeline Friendly: Pipe data directly from
stdinor stream entire directories withtar.Optional Account Binding: Works anonymously out of the box, or with your Pixeldrain API key to keep files organized in your account.
Related MCP server: mcp_file_manager
Quick Start
Upload Files & Media
Upload any file to Pixeldrain and receive a download link:
pd upload artwork.png
# => https://pixeldrain.com/u/xxxxxxYou can optionally specify a custom display name using the path:name syntax:
pd upload output_0042.png:cyberpunk-city.pngCreate Albums
Pass multiple files to group them into a single album. This is especially handy for collections of generated images or screenshots:
pd upload --album "Neon Dreams" concept1.png concept2.png concept3.png
# => https://pixeldrain.com/l/xxxxxxDownload Files & Albums
Download files back to your local environment:
# Download a single file (saved to current directory by default)
pd download https://pixeldrain.com/u/xxxxxx
# Download all files from an album without interactive prompts
pd download --all https://pixeldrain.com/l/xxxxxx
# Specify destination directory or filename
pd download -o ./downloads https://pixeldrain.com/u/xxxxxx
pd download --filename custom.png https://pixeldrain.com/u/xxxxxxMCP Server (AI Integration)
pd includes a built-in Model Context Protocol (MCP) server, allowing AI agents to upload text, images, and files directly to Pixeldrain.
Start the server via:
pd mcpConfiguration (Claude Desktop / Cursor)
Add pixeldrain to your MCP configuration (e.g. claude_desktop_config.json):
{
"mcpServers": {
"pixeldrain": {
"command": "pd",
"args": ["mcp"],
"env": {
"PIXELDRAIN_API_KEY": "your_api_key_here"
}
}
}
}SettingPIXELDRAIN_API_KEY is optional. If configured, files uploaded by the AI agent will belong to your Pixeldrain account.
Available MCP Tools:
upload_files: Upload one or more files (images, audio, archives) and return a file or album URL. Each file uses{name, data}, wheredatacan be a local file path, Base64, or a Base64 data URI.list_recipients: List configured public key IDs for encrypted uploads. Start the server with--age-recipients-dirand/or--ssh-recipients-dir, each containing one public key per.pubfile. Pass selected IDs asrecipientstoupload_textorupload_files.Start
pd mcp --identity-file /path/to/keyto decrypt.agedownloads with a local age identity or unencrypted SSH private key. MCP does not prompt for SSH key passphrases.upload_text: Upload plain text or markdown as a file and return a download URL.download_file: Download a file from Pixeldrain to the local machine.
Advanced Usage
Upload from STDIN (Logs, Diffs, Pipelines)
Pass - as the path to upload data from standard input (prepend -- to ensure - is not treated as a flag):
# Upload command output or logs
cat build.log | pd upload -- -:build.log
# Upload a git diff
git diff | pd upload -- -:patch.diffUpload a Directory
Stream and upload a directory archive directly without creating temporary files on disk:
tar zcf - ~/Projects/my-app | pd upload -- -:my-app.tar.gzEnd-to-End Encryption (E2EE)
Encrypt files locally before uploading with age or SSH public keys:
# Encrypt with an age public key or SSH key
pd upload --recipient "age1..." secret.pdf
pd upload --recipient "ssh-ed25519 AAAA..." secret.pdf
# Encrypt for multiple recipients using a file
pd upload --recipient-file recipients.txt secret.pdf(Uploaded files will automatically have the .age extension).
To decrypt upon download, provide your private key with --identity:
pd download --identity ~/.ssh/id_ed25519 https://pixeldrain.com/u/xxxxxxAccount Authentication
To associate uploads with your Pixeldrain account, provide your API key via the --api-key flag or the PIXELDRAIN_API_KEY environment variable:
export PIXELDRAIN_API_KEY="your-api-key"
pd upload file.zip
# Or via command flag:
pd --api-key "your-api-key" upload file.zipAPI keys can be generated at pixeldrain.com/user/api_keys.
Installation
Homebrew (macOS & Linux)
brew tap jkawamoto/pixeldrain
brew install pixeldrainGo Install
go install github.com/jkawamoto/go-pixeldrain/cmd/pd@latestPre-built Binaries
Pre-compiled binaries for macOS, Linux, and Windows are available on GitHub Releases.
Go Library Usage
go-pixeldrain also provides a Go client library for the Pixeldrain REST API.
See the package documentation on pkg.go.dev for API reference and usage examples.
License
This software is released under the MIT License.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Send files and manage client uploads from a compatible AI agent.
File uploads for AI agents. Upload, list, and manage files. No signup required.
Temporary file relay for AI agents: upload a generated file, get an expiring download link.
Persistent file storage for AI agents via MCP and curl. Upload, download, and version files.
Related MCP Servers
AlicenseNot gradedqualityCmaintenanceEnables AI agents to securely transfer files between machines via encrypted, expiring share links, with tools for upload, download, status checks, and link management.MIT- AlicenseAqualityDmaintenanceEnables AI agents and users to upload and download files via MCP, generating shareable links and identifier codes. Files are automatically deleted after 24 hours.9MIT

YourImageShareofficial
AlicenseAqualityBmaintenanceUpload, list, and delete files on YourImageShare (free image & video hosting, 200MB limit, no account required) from Claude, ChatGPT, or any MCP-compatible agent.375 npm1MIT- FlicenseAqualityBmaintenanceExposes the Nexus Mods API to AI agents so they can search and inspect mods, browse authors' catalogues, and upload or publish mod files from a local archive in a few aggregated tool calls. It handles authentication, caching, reporting quotas, and the multi-step v3 upload flow, while gating write and publish operations behind opt-in permissions.22-