Pixault.Mcp
1.2.0
See the version list below for details.
dotnet tool install --global Pixault.Mcp --version 1.2.0
dotnet new tool-manifest
dotnet tool install --local Pixault.Mcp --version 1.2.0
#tool dotnet:?package=Pixault.Mcp&version=1.2.0
nuke :add-package Pixault.Mcp --version 1.2.0
Pixault MCP Server
Model Context Protocol server for the Pixault image processing CDN. Gives AI assistants the ability to manage images, apply transforms, browse documentation, and more.
Features
- Image management — list, search, upload, and delete images
- Metadata — read and edit Schema.org fields, geo-location, folders, custom tags; strip EXIF
- Folder operations — create, list, and delete folders; filter images by folder
- Transformations — apply and manage named transforms; build CDN URLs, responsive
<img>/<picture>embeds, and fetch Schema.org JSON-LD - Watermarks — upload, list, and delete watermark images
- EPS / vector — split multi-design EPS files, extract SVG, inspect derived assets
- Plugin marketplace — browse, activate, and deactivate plugins
- Documentation — search embedded API docs, or browse them as MCP resources
- Resources — bundled docs at
pixault://docs/{topic}and live image metadata atpixault://{project}/{imageId}/metadata
Installation
Install the server as a .NET tool:
dotnet tool install --global Pixault.Mcp
Claude Desktop / Claude Code
Add to your MCP configuration:
{
"mcpServers": {
"pixault": {
"command": "pixault-mcp",
"env": {
"PIXAULT_BASE_URL": "https://img.pixault.io",
"PIXAULT_PROJECT": "my-project",
"PIXAULT_API_KEY": "your-api-key"
}
}
}
}
From source
git clone https://github.com/Pixault/pixault-mcp.git
cd pixault-mcp
dotnet run --project src/Pixault.Mcp
Configuration
| Environment Variable | Required | Description |
|---|---|---|
PIXAULT_BASE_URL |
Yes | Pixault CDN base URL |
PIXAULT_PROJECT |
Yes | Default project identifier |
PIXAULT_API_KEY |
Yes | API key for authentication |
PIXAULT_HMAC_SECRET |
No | HMAC secret for signed URL generation |
The
Pixault__BaseUrl/Pixault__Project(double-underscore) form is also accepted for every setting.
Agent scoping
Restrict what the AI assistant can do through this server. Read operations and URL/embed generation are always allowed; the flags below gate mutating tools.
| Environment Variable | Default | Gates |
|---|---|---|
PIXAULT_ALLOW_WRITE |
true |
Uploads, metadata edits, transform/watermark/folder creation, EXIF strip, EPS jobs |
PIXAULT_ALLOW_DELETE |
false |
Deleting images, transforms, watermarks, folders |
PIXAULT_ALLOW_PLUGINS |
false |
Activating / deactivating marketplace plugins |
When a category is disabled, the corresponding tools return a clear "permission denied" message instead of performing the operation.
Resources
Alongside the model-invoked tools, the server exposes read-only MCP resources the host can browse and attach to context:
| URI | Description |
|---|---|
pixault://docs |
Index of the bundled documentation topics |
pixault://docs/{topic} |
A documentation page (e.g. pixault://docs/quick-start) |
pixault://{project}/{imageId}/metadata |
Live Schema.org metadata for an image, as JSON |
Dependencies
- Pixault.Client — .NET SDK
- ModelContextProtocol — C# MCP SDK
License
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net10.0 is compatible. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
This package has no dependencies.