#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:

"Upload the product photo at /photos/widget.jpg to my Pixault account"

"List my recent images"

"Generate a 400x400 thumbnail URL for img_01JKABC in WebP format"

Metadata:

"Add copyright info to img_01JKABC — author is Jane Smith, year 2026, CC-BY-4.0 license"

"What metadata does img_01JKABC have?"

Transforms:

"Create a named transform called 'hero' with 1920px width, 80% quality, cover fit"

"Show me all my transform presets"

Plugins:

"What plugins are available in the marketplace?"

"Activate the background removal plugin"

Documentation:

"How do I use signed URLs?"

"Show me the upload API documentation"

#Supported Formats

The UploadImage tool supports:

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