# PixelVault

> Agent-first image hosting API. Upload images via API, get instant CDN URLs.
> Free tier: 200 MB storage, 500 uploads/month, 1 GB bandwidth. No credit card required.

## API Base URL

https://api.pixelvault.dev

## Authentication

All endpoints except registration require a Bearer token:
  Authorization: Bearer pv_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

API keys use the prefix `pv_live_` for production and `pv_test_` for test environments.

## Endpoints

### Register (no auth required)
POST /v1/auth/register
Body: {"email": "you@example.com", "password": "your-secure-password"}
Returns: account, default project, and API key (shown only once)

### Upload image
POST /v1/images
Content-Type: multipart/form-data
Form field: file (binary, required), folder (string, optional)
Supported formats: JPEG, PNG, GIF, WebP, AVIF, SVG
Returns: image ID, CDN URL, mime type, size, dimensions

### List images
GET /v1/images?page=1&per_page=20
Returns: paginated list of images with metadata

### Get image
GET /v1/images/:id
Returns: image metadata and CDN URL

### Delete image
DELETE /v1/images/:id
Returns: success confirmation

## MCP Server

PixelVault has a remote MCP (Model Context Protocol) server for AI agents:

  https://mcp.pixelvault.dev/mcp  (transport: streamable-http)

Tools: upload_image (base64 or source_url), list_images, get_image, delete_image.
Authenticate by sending your API key as a Bearer token in the Authorization header.

## Agent Skill

PixelVault ships a skill for Claude Code, Codex, Cursor, and any agent that reads SKILL.md files.
Install it with:

  npx skills add pixelvault-dev/skill

Source: https://github.com/pixelvault-dev/skill

## Resources

- OpenAPI 3.1 spec: https://api.pixelvault.dev/openapi.json
- MCP server: https://mcp.pixelvault.dev/mcp
- Agent skill: https://github.com/pixelvault-dev/skill
- Documentation: https://pixelvault.dev/docs
- Pricing: https://pixelvault.dev/pricing