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:

Hosted Remote MCPZero install

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.

Local Stdio MCPLocal files

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:

claude_desktop_config.jsonjson
{
  "mcpServers": {
    "splixir": {
      "command": "npx",
      "args": ["-y", "splixir", "mcp"],
      "env": {
        "SPLIXIR_API_KEY": "splx_live_your_api_key_here"
      }
    }
  }
}

MCP tools#

ToolAuthModeDescription
splixir_transform_imageAPI Keywait: true defaultTransforms a remote URL (or local file path in stdio MCP) with structured operations and returns verified output URL/path, VerificationReport, and cost.
splixir_get_jobAPI KeyReadFetches current state, output URLs, and VerificationReport for a job ID.
splixir_list_jobsAPI KeyReadLists recent jobs with optional state and limit filters.
splixir_get_balanceAPI KeyReadReturns available USD balance across promo, monthly allowance, and prepaid buckets.
splixir_validate_jobOfflineNo key neededValidates a job JSON payload against @splixir/types schemas and limits before submission.
splixir_estimate_costOfflineNo key neededComputes exact microdollar and USD cost for a given output format and pixel count.

MCP resources#

URIMIME TypeAuthDescription
splixir://balanceapplication/jsonAPI KeyLive snapshot of the authenticated account's wallet balance and spend order.
splixir://pricingapplication/jsonPublicSplixir Image rate card constants, monthly bonus plans, and $0 failed-job guarantee.

Test Local Stdio MCP manually

bash
echo '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | SPLIXIR_API_KEY=splx_test npx -y splixir mcp