Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to the Pixelbin MCP server

Vendor MCP7 toolsOAuth 2.1/DCRMediaDeveloper Tools

The Pixelbin MCP connector routes your AI agent's tool calls to Pixelbin's own MCP server through Scalekit. Each user signs in to Pixelbin once, and Scalekit stores and refreshes their tokens, so your agent never handles credentials. It comes with 7 tools.

  1. Install the SDK

    Section titled “Install the SDK”
    Terminal window
    npm install @scalekit-sdk/node dotenv

    Full SDK reference: Node.js | Python

  2. Set your credentials

    Section titled “Set your credentials”

    Add your Scalekit credentials to your .env file. Find values in app.scalekit.com > Developers > API Credentials.

    .env
    SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
    SCALEKIT_CLIENT_ID=<your-client-id>
    SCALEKIT_CLIENT_SECRET=<your-client-secret>

  3. Authorize and make your first call

    Section titled “Authorize and make your first call”
    quickstart.mts
    import { ScalekitClient } from '@scalekit-sdk/node'
    import 'dotenv/config'
    import { createInterface } from 'node:readline/promises'
    

    const scalekit = new ScalekitClient(
      process.env.SCALEKIT_ENVIRONMENT_URL,
      process.env.SCALEKIT_CLIENT_ID,
      process.env.SCALEKIT_CLIENT_SECRET,
    )
    const actions = scalekit.actions
    

    const connector = 'pixelbinmcp'
    const identifier = 'user_123'
    

    // Generate an authorization link for the user
    const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
    console.log('Authorize Pixelbin MCP:', link)
    const rl = createInterface({ input: process.stdin, output: process.stdout })
    await rl.question('Press Enter after authorizing...')
    rl.close()
    

    // Make your first call
    const result = await actions.executeTool({
      connector,
      identifier,
      toolName: 'pixelbinmcp_list_predictions',
      toolInput: {},
    })
    console.log(result)
    Terminal window
    npx tsx quickstart.mts

What you can do

Section titled “What you can do”

Connect this agent connector to let your agent:

  • Url upload asset from, request upload — Ingest a publicly-reachable URL into the user’s PixelBin storage
  • Storage save prediction to — Persist a completed prediction’s output to the user’s PixelBin storage as a permanent asset
  • List predictions — List available PixelBin prediction plugins and operations
  • Get prediction — Poll a PixelBin prediction by id
  • Cost estimate prediction — Estimate the credits a PixelBin prediction will consume before running it
  • Create prediction — Start a PixelBin prediction (e.g

Tool list

Section titled “Tool list”

Use the exact tool names from the Tool list below when you call execute_tool. If you’re not sure which name to use, list the tools available for the current user first.

pixelbinmcp_create_prediction#Start a PixelBin prediction (e.g. background removal, upscaling, watermark removal, image-to-video, image generation). ALWAYS call estimate-prediction-cost first to get a confirmation_token, present the credit cost to the user, and pass the token here. Image/video/PDF inputs must be public HTTPS URLs — use request-upload-url for local files or upload-asset-from-url for public URLs. Async: returns a prediction id; poll with get-prediction.4 params

Start a PixelBin prediction (e.g. background removal, upscaling, watermark removal, image-to-video, image generation). ALWAYS call estimate-prediction-cost first to get a confirmation_token, present the credit cost to the user, and pass the token here. Image/video/PDF inputs must be public HTTPS URLs — use request-upload-url for local files or upload-asset-from-url for public URLs. Async: returns a prediction id; poll with get-prediction.

NameTypeRequiredDescription
inputobjectrequiredOperation-specific JSON input. Image/video/PDF values must be public HTTPS URLs.
operationstringrequiredOperation id under the plugin (e.g. 'bg').
pluginstringrequiredPlugin id from list-predictions (e.g. 'erase').
confirmation_tokenstringoptionalToken returned by estimate-prediction-cost. Required to confirm credit spend.
pixelbinmcp_estimate_prediction_cost#Estimate the credits a PixelBin prediction will consume before running it. Always call this before create-prediction. Returns creditsPerOperation, totalCredits, and a confirmation_token required by create-prediction.4 params

Estimate the credits a PixelBin prediction will consume before running it. Always call this before create-prediction. Returns creditsPerOperation, totalCredits, and a confirmation_token required by create-prediction.

NameTypeRequiredDescription
operationstringrequiredOperation id under the plugin.
pluginstringrequiredPlugin id from list-predictions.
countintegeroptionalNumber of times this operation will run. Defaults to 1.
inputsobjectoptionalOperation-specific inputs that affect cost. Optional for fixed-cost plugins.
pixelbinmcp_get_prediction#Poll a PixelBin prediction by id. Returns status (ACCEPTED/RUNNING/SUCCESS/FAILURE) and, on SUCCESS, the result URL(s). Results are hosted ~30 days; use save-prediction-to-storage to persist permanently.1 param

Poll a PixelBin prediction by id. Returns status (ACCEPTED/RUNNING/SUCCESS/FAILURE) and, on SUCCESS, the result URL(s). Results are hosted ~30 days; use save-prediction-to-storage to persist permanently.

NameTypeRequiredDescription
prediction_idstringrequiredThe prediction workflow id returned by create-prediction.
pixelbinmcp_list_predictions#List available PixelBin prediction plugins and operations. Returns a catalog with display names, credit costs, and categories. Use include_schema=true to get input schemas for create-prediction.2 params

List available PixelBin prediction plugins and operations. Returns a catalog with display names, credit costs, and categories. Use include_schema=true to get input schemas for create-prediction.

NameTypeRequiredDescription
categoriesstringoptionalOptional comma-separated categories to filter (e.g. 'image-to-video,text-to-image').
include_schemabooleanoptionalInclude each plugin's input JSON Schema in the response.
pixelbinmcp_request_upload_url#Mint a presigned PUT URL to upload a local file to PixelBin storage. Returns uploadUrl, headers, a curl command, and hostedUrl (the permanent CDN URL). Use for local files when you have shell/curl access. For public URLs, use upload-asset-from-url instead.4 params

Mint a presigned PUT URL to upload a local file to PixelBin storage. Returns uploadUrl, headers, a curl command, and hostedUrl (the permanent CDN URL). Use for local files when you have shell/curl access. For public URLs, use upload-asset-from-url instead.

NameTypeRequiredDescription
filenamestringrequiredFile name with extension (e.g. 'photo.jpg'). Supported: jpg/jpeg/png/webp/avif/gif/bmp/tiff/heic/heif, mp4/webm/mov/avi/mkv/mpeg/mpg, pdf.
accessstringoptionalAccess level. Defaults to public-read.
overwritebooleanoptionalReplace existing asset at same path. Defaults to false.
pathstringoptionalOptional folder path in PixelBin storage (e.g. 'mcp-uploads/'). Defaults to org root.
pixelbinmcp_save_prediction_to_storage#Persist a completed prediction's output to the user's PixelBin storage as a permanent asset. Use after a successful create-prediction when the user wants to keep the result beyond its ~30-day expiry.3 params

Persist a completed prediction's output to the user's PixelBin storage as a permanent asset. Use after a successful create-prediction when the user wants to keep the result beyond its ~30-day expiry.

NameTypeRequiredDescription
prediction_idstringrequiredThe prediction workflow id whose output to persist.
accessstringoptionalAccess level for the saved asset. Defaults to public-read.
pathstringoptionalOptional folder path in PixelBin storage. Defaults to org root.
pixelbinmcp_upload_asset_from_url#Ingest a publicly-reachable URL into the user's PixelBin storage. PixelBin fetches the asset server-side and returns a permanent CDN URL. Use when the user has a public URL; for local files use request-upload-url.6 params

Ingest a publicly-reachable URL into the user's PixelBin storage. PixelBin fetches the asset server-side and returns a permanent CDN URL. Use when the user has a public URL; for local files use request-upload-url.

NameTypeRequiredDescription
urlstringrequiredPublic HTTPS URL of the asset. Must be reachable without auth.
accessstringoptionalAccess level. Defaults to public-read.
formatstringoptionalOptional file format override.
namestringoptionalOptional asset filename without extension.
overwritebooleanoptionalReplace existing asset at same path. Defaults to false.
pathstringoptionalOptional folder path in PixelBin storage.