Conversion Tools 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 = 'conversiontoolsmcp'
   const identifier = 'user_123'
   
   // Generate an authorization link for the user
   const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
   console.log('Authorize Conversion Tools 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: 'conversiontoolsmcp_auth_status',
     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 = "conversiontoolsmcp"
   identifier = "user_123"
   
   # Generate an authorization link for the user
   link_response = actions.get_authorization_link(
       connection_name=connection_name,
       identifier=identifier,
   )
   print("Authorize Conversion Tools MCP:", link_response.link)
   input("Press Enter after authorizing...")
   
   # Make your first call
   result = actions.execute_tool(
       tool_input={},
       tool_name="conversiontoolsmcp_auth_status",
       connection_name=connection_name,
       identifier=identifier,
   )
   print(result)

What you can do

Connect this agent connector to let your agent:

• Url request upload — Get a signed URL for uploading large files (over 5 MB)
• List converters — List available file converters
• Get converter info — Get detailed information about a specific converter, including available options and their allowed values
• Converter find — Find the best converter for converting between two specific formats
• File convert — Convert a file between 140+ supported formats including documents, images, audio, video, and data files
• Status auth — Check authentication status and account info

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.

conversiontoolsmcp_auth_login#Login to ConversionTools using OAuth. Opens a browser window for authentication.1 param▾

Login to ConversionTools using OAuth. Opens a browser window for authentication.

NameTypeRequiredDescription

forcebooleanoptionalForce re-authentication even if already logged in

conversiontoolsmcp_auth_logout#Logout from ConversionTools. Clears stored credentials.0 params▾

Logout from ConversionTools. Clears stored credentials.

conversiontoolsmcp_auth_status#Check authentication status and account info.0 params▾

Check authentication status and account info.

conversiontoolsmcp_convert_file#Convert a file between 140+ supported formats including documents, images, audio, video, and data files. Returns a download URL for the converted file.6 params▾

Convert a file between 140+ supported formats including documents, images, audio, video, and data files. Returns a download URL for the converted file.

NameTypeRequiredDescription

input_pathstringrequiredLocal path to the input file, used for filename and format detection.

output_pathstringrequiredLocal path where the converted file should be saved.

converterstringoptionalSpecific converter type to use (e.g., convert.pdf_to_excel). If omitted, the converter is auto-detected from file extensions.

file_contentstringoptionalBase64-encoded file content for files 5 MB or smaller.

file_idstringoptionalFile ID returned by request_upload_url for files larger than 5 MB.

optionsobjectoptionalConverter-specific options as key-value pairs. Call get_converter_info to see which options a converter accepts.

conversiontoolsmcp_find_converter#Find the best converter for converting between two specific formats.2 params▾

Find the best converter for converting between two specific formats.

NameTypeRequiredDescription

input_formatstringrequiredInput file format extension (e.g., pdf, xlsx, png).

output_formatstringrequiredDesired output format extension (e.g., csv, json, jpg).

conversiontoolsmcp_get_converter_info#Get detailed information about a specific converter, including available options and their allowed values.1 param▾

Get detailed information about a specific converter, including available options and their allowed values.

NameTypeRequiredDescription

converterstringrequiredConverter type identifier (e.g., convert.pdf_to_excel).

conversiontoolsmcp_list_converters#List available file converters. Use this to discover what conversions are supported.3 params▾

List available file converters. Use this to discover what conversions are supported.

NameTypeRequiredDescription

categorystringoptionalFilter converters by category.

input_formatstringoptionalFilter by input format extension (e.g., pdf, xlsx, png).

output_formatstringoptionalFilter by output format extension (e.g., csv, json, jpg).

conversiontoolsmcp_request_upload_url#Get a signed URL for uploading large files (over 5 MB). After uploading to the URL, pass the returned file_id to convert_file.1 param▾

Get a signed URL for uploading large files (over 5 MB). After uploading to the URL, pass the returned file_id to convert_file.

NameTypeRequiredDescription

filenamestringrequiredName of the file to upload, including its extension.