pixelvault-mcp

PixelVault MCP Server

Compliance-cleared AI asset search and licensing for post production, editorial, and e-commerce.

PixelVault is a two-sided AI asset marketplace. Every asset is sourced from licensed AI platforms (Adobe Firefly, Moonvalley), pre-cleared for commercial use, and delivered with an auto-generated usage agreement at checkout. This MCP server gives AI agents native access to the full search and licensing workflow.

What It Does

The PixelVault MCP server exposes three tools:

Tool	Description
search_assets	Submit a natural language brief → receive a ranked shortlist of pre-cleared assets with compliance status and rationale
get_asset_details	Get full metadata and compliance documentation for a specific asset
generate_usage_agreement	Provide approved asset IDs + project details → receive a completed usage agreement draft

The human's only job is to approve the shortlist. Everything before and after is AI-operated.

Install

Claude Desktop (recommended)

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "pixelvault": {
      "command": "npx",
      "args": ["-y", "pixelvault-mcp"]
    }
  }
}

Config file location:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Other MCP clients

npx pixelvault-mcp

The server communicates over stdio (standard MCP transport).

Tools

search_assets

Search for pre-cleared assets matching a creative brief.

Parameters:

• brief (required) — Natural language description of the visual asset needed. Include setting, tone, narrative function, distribution platform, territory.
• license_type — "Film & TV" | "Editorial" | "Commercial". Auto-detected from brief if omitted.
• format — "video" | "image". Omit for all formats.
• vertical — "post production" | "editorial" | "ecommerce"
• territory — Distribution territory. Included in usage agreement.

Example prompt to Claude:

"Find me pre-cleared B-roll of a late-night urban exterior for a Netflix drama. Needs negative space on the right for lower-third graphics. Film & TV Commercial license, worldwide."

get_asset_details

Get full metadata and compliance documentation for a specific asset.

Parameters:

• asset_id (required) — Asset ID from search_assets results

generate_usage_agreement

Generate a usage agreement draft after the human approves a shortlist.

Parameters:

• asset_ids (required) — Array of approved asset IDs
• project_title (required) — Production or project title
• production_company (required) — Production company or organization
• distribution_platform (required) — e.g. "Netflix, Broadcast", "Editorial Web", "Instagram, Meta Ads"
• territory (required) — e.g. "Worldwide", "US Only", "EU"
• license_type (required) — "Film & TV Commercial" | "Editorial" | "Commercial Digital"
• air_date — Anticipated air or publication date

Compliance Model

Every asset in PixelVault meets all four criteria:

• Trained on licensed content, public domain, or proprietary data — not scraped unlicensed web content
• Offers a commercial use license for generated outputs
• Provides documentation of training data and licensing structure
• No unresolved copyright infringement ruling related to training data

Approved source platforms: Adobe Firefly, Moonvalley

Workflow

Agent receives brief
       ↓
search_assets(brief) → ranked shortlist
       ↓
[Human reviews and approves shortlist]
       ↓
generate_usage_agreement(asset_ids, project_params) → agreement draft
       ↓
[Human completes payment at pixelvault-ui.vercel.app]
       ↓
Executed agreement + signed delivery URL delivered to both parties

Environment

Variable	Default	Description
PIXELVAULT_API_URL	https://asset-registry-api-production.up.railway.app	Override API base URL

Links

• Live site: pixelvault-ui.vercel.app
• API docs: pixelvault-ui.vercel.app/docs/agents
• OpenAPI spec: pixelvault-ui.vercel.app/api/openapi.json
• Contact: [e-mail]