pixeldrive

Agent storage · images included

Files in.
URLs out.
Built for agents.

Pixeldrive is file storage with a JSON contract and a CDN. Agents upload through MCP or a write key. You serve originals — and optimized images — without a CMS or a bucket of your own.

Read the docs
agent session — pixeldrive

you ›upload the lookbook and put it on the site

agent ›MCP upload → 48 files · upsert selects/hero.jpg

agent ›GET /v1/files?path=selects/hero.jpg · GET /v1/projects/6dec2e93

agent ›writing app/lookbook/page.tsx

agent ›done — CDN originals, links survive replaces

MCP
SDK and HTTP too
1 GET
whole project
?w=
Pro transforms
$0
to start

Three moves

Storage an agent can write. A CDN you can ship.

Not a CMS schema. Not a weekend of S3, CORS, and image-CDN wiring. Upload, organize, serve — including optimized images on Pro.

  1. 01 · Upload

    MCP, SDK, or the dashboard

    Write key scoped to a project. Same three-step protocol either way — presign, PUT to storage, verify. Multipart under the hood.

    npx -y @pixeldrive-dev/mcp
PIXELDRIVE_API_KEY=pd_live_…

  2. 02 · Organize

    Projects, folders, tags

    Rename, move, replace — every public link keeps working. One ready file per path; upsert keeps the publicId. Humans use the dashboard; agents keep the same IDs.

    summer-lookbook/
├─ selects/      24
├─ bts/         118
└─ #la-jolla     36

  3. 03 · Serve

    JSON, CDN, image transforms

    One GET lists the project. Originals cache for a year. Pro adds ?w= / srcset without a second vendor.

    GET /v1/projects/6dec…   200
cdn.pixeldrive.dev/f/8a31?w=960

Also in the box· upload API · SDK · MCP· path upsert · GET by path· photos · video · PDF · Word · markdown· private projects· Pro image transforms (?w=)· Pro version history· project tags

The contract

An API your agents don’t have to guess at.

Upload, list, replace, delete, overwrite by path. Hosted originals and (on Pro) optimized derivatives. A coding agent that can read /docs can finish the job.

Write
POST /v1/uploadWrite key. upsert: true replaces the ready file at that path. SDK and MCP wrap put vs multipart.
Path
GET /v1/files?path=One file by path. MCP upload upserts by default; SDK pass upsert: true.
Contract
GET /v1/projects/{id}One request returns files, folders, tags, and CDN URLs.
Images
url · stableUrl · srcsetOriginals on the CDN. Pro adds ?w= transforms and src / srcset in the listing.
Shape
width · height · blurhashLayout before the pixels arrive. No probing, no CLS.
Auth
public · Bearer keysShared listings need no key. Private projects use scoped API keys.
Paging
nextCursorUp to 500 files per page, deterministic order. CORS open.
GET https://api.pixeldrive.dev/v1/projects/6dec2e93…
{
  "name": "summer-lookbook",
  "files": [{
    "name": "eng-448.jpg",
    "kind": "image",
    "url": "https://cdn.pixeldrive.dev/…/v1",
    "stableUrl": "https://cdn.pixeldrive.dev/f/…",
    "srcset": "…/f/…?w=640 640w, …/f/…?w=960 960w",
    "width": 5695,
    "height": 3797,
    "blurhash": "LGF5]+Yk^6#M@-5c,1J5",
    "tags": ["la-jolla"]
  }],
  "nextCursor": null
}

Compare

The stack you don’t buy.

Agent storage should not require a CMS seat, a DAM, and a separate image CDN. You needed a place to put the files — and to serve the pictures.

Agent write (MCP / SDK)

Pixeldrive
Yes
UploadThing
SDK, not MCP
DIY object storage
You build it
An image CDN
Sometimes

Overwrite by path

Pixeldrive
Yes
UploadThing
You track ids
DIY object storage
You build it
An image CDN
No

JSON listing

Pixeldrive
Yes
UploadThing
You store it
DIY object storage
You build it
An image CDN
No

Image hosting + CDN

Pixeldrive
Yes
UploadThing
Yes
DIY object storage
You wire it
An image CDN
The product

Image transforms

Pixeldrive
Pro, included
UploadThing
No
DIY object storage
Lambda + cache
An image CDN
The product

Replace keeps the URL

Pixeldrive
Yes
UploadThing
New URL
DIY object storage
Cache-bust
An image CDN
Sometimes

Private projects

Pixeldrive
Yes
UploadThing
Private files
DIY object storage
IAM + signed URLs
An image CDN
Sometimes

Typical monthly

Pixeldrive
$0 or $15
UploadThing
Usage
DIY object storage
Infra + your hours
An image CDN
Often $89+

Agent needs to host a file

Them · S3 credentials in the prompt · hope CORS works

Us · Write key · MCP upload · JSON back

The infra the agent never stands up

Images on a new site

Them · UploadThing + Cloudinary · two vendors

Us · Originals on the CDN · Pro ?w=

One product for files and derivatives

The monthly stack

Them · Object storage + image CDN · ~$100+

Us · Pixeldrive Pro · $15

The second invoice you skip

Competitor prices are typical published starting points, not quotes. Your stack may be cheaper. It is rarely $15 and a write key.

Coming soon

Not vapor. Just not shipped yet.

Path upsert shipped — one file per folder path, GET by path, MCP overwrites by default. Next: executable types on private projects, served as downloads.

Soon

HTML, SVG, and JS on private projects

Same upload path, served as downloads so they never execute. Public projects stay on inert types — photos, video, PDF, Word, markdown.

Start

Free is real storage.
Pro is $15.

2 GB, 3 projects, 1,000 files, API keys, and private projects on free. A terabyte, image transforms, and version history when you outgrow it.

See pricing