Developer Tools
Model Context Protocol (MCP)
Give AI assistants and coding agents direct, structured access to Splixir Image transforms, job inspection, offline validation, and cost estimation.
Remote HTTP vs. Local Stdio#
Splixir provides two ways to run MCP depending on whether your workflow uses remote URLs or local files on disk:
https://mcp.splixir.com
Streamable HTTP transport authenticated with Authorization: Bearer splx_.... Best for cloud agents, Cursor, Claude Code, and Antigravity working with remote URLs.
npx -y splixir mcp
JSON-RPC 2.0 over stdio (protocol versions 2025-03-26 and 2024-11-05). Supports automatic presigned staging of local image files from disk.
Client configurations#
Copy the configuration for your AI client and replace splx_live_your_api_key_here with an API key from console.splixir.com:
{
"mcpServers": {
"splixir": {
"command": "npx",
"args": ["-y", "splixir", "mcp"],
"env": {
"SPLIXIR_API_KEY": "splx_live_your_api_key_here"
}
}
}
}MCP tools#
| Tool | Auth | Mode | Description |
|---|---|---|---|
splixir_transform_image | API Key | wait: true default | Transforms a remote URL (or local file path in stdio MCP) with structured operations and returns verified output URL/path, VerificationReport, and cost. |
splixir_get_job | API Key | Read | Fetches current state, output URLs, and VerificationReport for a job ID. |
splixir_list_jobs | API Key | Read | Lists recent jobs with optional state and limit filters. |
splixir_get_balance | API Key | Read | Returns available USD balance across promo, monthly allowance, and prepaid buckets. |
splixir_validate_job | Offline | No key needed | Validates a job JSON payload against @splixir/types schemas and limits before submission. |
splixir_estimate_cost | Offline | No key needed | Computes exact microdollar and USD cost for a given output format and pixel count. |
MCP resources#
| URI | MIME Type | Auth | Description |
|---|---|---|---|
splixir://balance | application/json | API Key | Live snapshot of the authenticated account's wallet balance and spend order. |
splixir://pricing | application/json | Public | Splixir Image rate card constants, monthly bonus plans, and $0 failed-job guarantee. |
Test Local Stdio MCP manually
echo '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | SPLIXIR_API_KEY=splx_test npx -y splixir mcp