MCP Endpoint

Agents can call the same MagicPixels generation queue through `/v1/mcp`. The endpoint supports initialize, tools/list, and tools/call over JSON-RPC.

magicpixels_text_to_image

Create a Qwen image job from a text prompt.

magicpixels_image_to_image

Edit an uploaded asset or base64 image with a prompt.

magicpixels_generate_audio

Generate voice audio from text and return a pollable job.

magicpixels_image_to_video

Create a talking-avatar video from an image asset and generated voice text, or use an existing audio asset.

magicpixels_get_job

Fetch job status and protected result URLs.

magicpixels_get_account

Fetch premium status, billing tier, remaining credits, monthly credit grant, and any free signup credits still available.

curl -X POST https://api.magicpixels.ai/v1/mcp \
  -H "Authorization: Bearer mp_live_xxx.yyy" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/list"
  }'

curl -X POST https://api.magicpixels.ai/v1/mcp \
  -H "Authorization: Bearer mp_live_xxx.yyy" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 2,
    "method": "tools/call",
    "params": {
      "name": "magicpixels_text_to_image",
      "arguments": {
        "prompt": "Clean editorial product render on a steel desk"
      }
    }
  }'

curl -X POST https://api.magicpixels.ai/v1/mcp \
  -H "Authorization: Bearer mp_live_xxx.yyy" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 3,
    "method": "tools/call",
    "params": {
      "name": "magicpixels_get_account",
      "arguments": {}
    }
  }'