MCP Server Integration

Pixault includes a Model Context Protocol (MCP) server that makes all image management capabilities accessible to AI assistants like Claude, Cursor, Windsurf, and any other MCP-compatible client.

Source on GitHub

What is MCP?

The Model Context Protocol is an open standard for connecting AI assistants to external tools and data sources. Pixault's MCP server exposes image upload, transformation, metadata management, and plugin control as tools that AI assistants can call directly.

Setup

Install

The MCP server is distributed as a .NET tool:

dotnet tool install --global Pixault.Mcp

Configure Your AI Assistant

Add Pixault to your MCP client configuration. For Claude Desktop, add to claude_desktop_config.json:

{
  "mcpServers": {
    "pixault": {
      "command": "pixault-mcp",
      "env": {
        "PIXAULT_BASE_URL": "https://img.pixault.io",
        "PIXAULT_PROJECT": "myapp",
        "PIXAULT_API_KEY": "pk_your_api_key",
        "PIXAULT_HMAC_SECRET": "your_hmac_secret"
      }
    }
  }
}

For Cursor or other editors, follow their MCP server configuration documentation using the same command and environment variables.

Environment Variables

Variable	Required	Description
`PIXAULT_BASE_URL`	No	API endpoint (default: `https://img.pixault.io`)
`PIXAULT_PROJECT`	Yes	Your project identifier
`PIXAULT_API_KEY`	Yes	API key for authentication
`PIXAULT_HMAC_SECRET`	No	HMAC secret for signed URL generation

Available Tools

The MCP server provides 14 tools across 5 categories:

Image Management

Tool	Description
`UploadImage`	Upload an image or video from a local file path
`ListImages`	List images with cursor-based pagination
`DeleteImage`	Delete an image and all cached variants
`BuildImageUrl`	Generate a CDN URL with transformation parameters

Metadata

Tool	Description
`GetImageMetadata`	Get dimensions, size, Schema.org fields, and tags
`UpdateImageMetadata`	Update name, description, keywords, author, copyright, license
`GetJsonLdUrl`	Get the JSON-LD structured data endpoint URL

Named Transforms

Tool	Description
`ListTransforms`	List all named transform presets
`GetTransform`	Get details of a specific preset
`SaveTransform`	Create or update a named transform
`DeleteTransform`	Delete a named transform

Plugin Marketplace

Tool	Description
`ListPlugins`	List all available marketplace plugins
`ListProjectPlugins`	List plugins with activation status for your project
`ActivatePlugin`	Activate a plugin for your project
`DeactivatePlugin`	Deactivate a plugin

Documentation

Tool	Description
`SearchDocs`	Search Pixault documentation by topic or keyword
`ListDocTopics`	List all available documentation topics

Usage Examples

Once configured, you can use natural language with your AI assistant:

Image management:

Metadata:

Transforms:

Plugins:

Documentation:

Supported Formats

The UploadImage tool supports:

Images: JPEG, PNG, WebP, GIF, AVIF, SVG
Video: MP4, WebM, MOV (auto-thumbnail generation)

11 March 2026