Pixelbin MCP connector

1. Install the SDK

   Node.js

   npm install @scalekit-sdk/node

   Python

   pip install scalekit

   Full SDK reference: Node.js | Python

2. 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

   Node.js

   quickstart.ts

   import { ScalekitClient } from '@scalekit-sdk/node'
   import 'dotenv/config'
   
   const scalekit = new ScalekitClient(
     process.env.SCALEKIT_ENV_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)
   process.stdout.write('Press Enter after authorizing...')
   await new Promise(r => process.stdin.once('data', r))
   
   // Make your first call
   const result = await actions.executeTool({
     connector,
     identifier,
     toolName: 'pixelbinmcp_list_predictions',
     toolInput: {},
   })
   console.log(result)

   Python

   quickstart.py

   import os
   from scalekit.client import ScalekitClient
   from dotenv import load_dotenv
   load_dotenv()
   
   scalekit_client = ScalekitClient(
       env_url=os.getenv("SCALEKIT_ENV_URL"),
       client_id=os.getenv("SCALEKIT_CLIENT_ID"),
       client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
   )
   actions = scalekit_client.actions
   
   connection_name = "pixelbinmcp"
   identifier = "user_123"
   
   # Generate an authorization link for the user
   link_response = actions.get_authorization_link(
       connection_name=connection_name,
       identifier=identifier,
   )
   print("Authorize Pixelbin MCP:", link_response.link)
   input("Press Enter after authorizing...")
   
   # Make your first call
   result = actions.execute_tool(
       tool_input={},
       tool_name="pixelbinmcp_list_predictions",
       connection_name=connection_name,
       identifier=identifier,
   )
   print(result)

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

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.