SSyncDev

Pixeldrain MCP Server

Lets an AI assistant upload files, images and text to Pixeldrain and download them back, with optional client-side encryption.

Local server

What is the Pixeldrain MCP Server?

Getting a generated image out of an agent session usually means saving it, opening a browser and dragging it onto an upload page. This server removes those steps. It is part of pd, a single tool that works as a terminal client for the Pixeldrain file host, a Go library, and, through pd mcp, a Pixeldrain MCP server that Claude Desktop, Cursor and similar clients can call directly.

What an assistant can do with it

  • upload_files sends one or more files and returns a file link, or an album link when there are several. Each file is given as a name plus data, and the data can be a local path, raw Base64 or a Base64 data URI, which is handy when the agent created the image itself.
  • upload_text stores plain text or Markdown as a file and returns its download URL. Think log excerpts, notes or a diff you want to hand to someone.
  • download_file fetches a Pixeldrain file onto your machine.
  • list_recipients lists the public keys the server knows about, so the agent can pick who an encrypted upload is for.

Installing and connecting

Install pd from the Homebrew tap, with go install, or from the prebuilt binaries for macOS, Linux and Windows. Then add an entry that runs pd with the single argument mcp to your client config.

An account is not required. Uploads work anonymously out of the box. If you set PIXELDRAIN_API_KEY, anything the agent uploads lands in your own Pixeldrain account instead, which makes it far easier to find and tidy up later.

Encrypted uploads

This is the part worth slowing down for. Start the server with --age-recipients-dir and/or --ssh-recipients-dir, each pointing at a folder holding one public key per .pub file. The agent can then pass selected key IDs as recipients, and files are encrypted on your machine before they leave it, ending up with an .age extension. To let the agent decrypt .age downloads, start it with --identity-file pointing at an age identity or an SSH private key.

Caveats

  • Unencrypted uploads produce a shareable link. Treat anything sent that way as visible to whoever has the link.
  • The MCP server never prompts for an SSH key passphrase, so decryption only works with an unencrypted private key or an age identity.
  • Downloads are written to the local filesystem, so the agent can create files where it runs.
  • The Pixeldrain MCP server relies on the service being reachable; it is a client, not a file store of its own.

For more connectors that bridge assistants to everyday web services, see the rest of our other integrations category. If file sharing is the job, this one stands out for its encryption options; browse similar integrations to compare.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
upload_filesUploads one or more files (path, Base64 or data URI) and returns a file or album URL; can encrypt for chosen recipients.
upload_textUploads plain text or Markdown as a file and returns a download URL.
download_fileDownloads a Pixeldrain file to the local machine, decrypting .age files when an identity is configured.
list_recipientsLists the public key IDs configured for encrypted uploads.

How to install the Pixeldrain MCP Server

{
  "mcpServers": {
    "pixeldrain": {
      "command": "pd",
      "args": [
        "mcp"
      ],
      "env": {
        "PIXELDRAIN_API_KEY": "your_api_key_here"
      }
    }
  }
}

Install pd first (brew tap jkawamoto/pixeldrain && brew install pixeldrain, or go install github.com/jkawamoto/go-pixeldrain/cmd/pd@latest). PIXELDRAIN_API_KEY is optional; remove it to upload anonymously.

Configuration

VariableDescriptionRequired
PIXELDRAIN_API_KEYPixeldrain API key. When set, uploads belong to your Pixeldrain account; without it they are anonymous.Optional

Frequently asked questions

No. Uploads work anonymously. Setting PIXELDRAIN_API_KEY ties the agent's uploads to your account.