Conversion Tools MCP

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:

• Run studio — Poll the status of an AI Studio converter run started with studio_run
• List studio, parse, converters — List the custom converters previously built in AI Studio for the signed-in account, so an existing converter can be reused instead of rebuilding one
• Get studio, download url, converter info — Get a custom AI Studio converter’s details and current status, including its input/output shape and the file currently attached
• Result studio download — Download the result of a successful AI Studio converter run, using the result_file_id from studio_run_status
• Create studio, parse — Start building a new custom converter with AI Studio, for conversions that need engines not available locally, large or sensitive files, multi-step transformations, or a durable reusable converter
• Chat studio — Send a plain-language build instruction to the AI Studio planner for a converter created with studio_create_converter

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_get_download_url#Regenerate a fresh, short-lived download URL for a file already converted by convert_file, using its task_id. Call this if the original download URL expired before you fetched it.1 param▾

Regenerate a fresh, short-lived download URL for a file already converted by convert_file, using its task_id. Call this if the original download URL expired before you fetched it.

NameTypeRequiredDescription

task_idstringrequiredThe task_id returned by convert_file.

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_parse_create_schema#Create a saved, reusable Parse extraction schema with a named field definition, for extractions that will be run more than once.3 params▾

Create a saved, reusable Parse extraction schema with a named field definition, for extractions that will be run more than once.

NameTypeRequiredDescription

fieldsarrayrequiredThe field definitions. Each: {name (snake_case), type, description?, required?, examples?, aliases?, items?, fields?, validation?}.

namestringrequiredHuman-readable schema name, e.g. "Supplier invoice".

descriptionstringoptionalWhat this schema is for (optional).

conversiontoolsmcp_parse_export#Turn a completed Parse extraction into a CSV or XLSX spreadsheet, flattening nested lists into rows.3 params▾

Turn a completed Parse extraction into a CSV or XLSX spreadsheet, flattening nested lists into rows.

NameTypeRequiredDescription

extraction_idstringrequiredThe completed extraction to export.

formatstringrequiredSpreadsheet format.

output_pathstringoptionalLocal path to save the file (stdio mode).

conversiontoolsmcp_parse_extract#Extract structured data from a document (PDF, scan, photo, invoice, receipt, form, statement) using Parse, the AI extraction engine. Submits the document and returns an extraction id immediately; poll parse_extraction_status for the extracted data.9 params▾

Extract structured data from a document (PDF, scan, photo, invoice, receipt, form, statement) using Parse, the AI extraction engine. Submits the document and returns an extraction id immediately; poll parse_extraction_status for the extracted data.

NameTypeRequiredDescription

fieldsarrayoptionalInline field list for a one-off extraction (ignored when schema_id is set). Each field: {name (snake_case), type: string|number|date|boolean|array|object, description?, required?, examples?, aliases?, items? (for array), fields? (for object / array-of-object), validation?}.

file_contentstringoptionalBase64-encoded document bytes (remote/http mode).

file_idstringoptionalFile id from a previous Parse upload. Note: wait does not apply to this path - submit, then poll.

file_pathstringoptionalPath to the document (local/stdio mode), or a filename label in remote mode.

no_cachebooleanoptionalForce a fresh extraction instead of reusing a stored result for an identical document + fields.

output_formatstringoptionalStart a spreadsheet export automatically once the extraction completes. Collect it with parse_export.

schema_idstringoptionalId of a saved schema to extract with (from parse_list_schemas / parse_create_schema).

waitnumberoptionalSeconds to hold the request open waiting for the result (max 120). Upload path only. Omit to get the id back immediately and poll.

webhook_urlstringoptionalPublic http(s) URL notified when the extraction reaches a terminal state. Carries the id and status only, never the extracted data.

conversiontoolsmcp_parse_extraction_status#Poll a document extraction submitted with parse_extract. Returns processing while the extraction runs, or completed/failed with the extracted data or error once finished.1 param▾

Poll a document extraction submitted with parse_extract. Returns processing while the extraction runs, or completed/failed with the extracted data or error once finished.

NameTypeRequiredDescription

extraction_idstringrequiredThe extraction id returned by parse_extract.

conversiontoolsmcp_parse_list_schemas#List the saved Parse extraction schemas on this account, including each schema's fields and usage count.0 params▾

List the saved Parse extraction schemas on this account, including each schema's fields and usage count.

conversiontoolsmcp_parse_usage#Show this account's Parse usage for the current billing month: plan, pages used, page limit, pages remaining, and reset date.0 params▾

Show this account's Parse usage for the current billing month: plan, pages used, page limit, pages remaining, and reset date.

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.

conversiontoolsmcp_studio_attach_file#Attach a new input file to an existing built AI Studio converter so it can be re-run on fresh data without rebuilding.4 params▾

Attach a new input file to an existing built AI Studio converter so it can be re-run on fresh data without rebuilding.

NameTypeRequiredDescription

converter_idstringrequiredThe existing converter to reuse.

file_contentstringoptionalBase64-encoded file content (remote/http mode).

file_idstringoptionalFile ID from a previous upload (large files, via request_upload_url).

file_pathstringoptionalPath to the new input file (local/stdio mode).

conversiontoolsmcp_studio_chat#Send a plain-language build instruction to the AI Studio planner for a converter created with studio_create_converter. The planner may ask a clarifying question or propose a ready-to-run converter.2 params▾

Send a plain-language build instruction to the AI Studio planner for a converter created with studio_create_converter. The planner may ask a clarifying question or propose a ready-to-run converter.

NameTypeRequiredDescription

converter_idstringrequiredThe converter_id from studio_create_converter.

messagestringrequiredPlain-language build instruction or answer to the planner.

conversiontoolsmcp_studio_create_converter#Start building a new custom converter with AI Studio, for conversions that need engines not available locally, large or sensitive files, multi-step transformations, or a durable reusable converter. Optionally attaches the input file in the same call.4 params▾

Start building a new custom converter with AI Studio, for conversions that need engines not available locally, large or sensitive files, multi-step transformations, or a durable reusable converter. Optionally attaches the input file in the same call.

NameTypeRequiredDescription

file_contentstringoptionalBase64-encoded file content (remote/http mode).

file_idstringoptionalFile ID from a previous upload (use request_upload_url for large files).

file_pathstringoptionalPath to the input file (local/stdio mode), or a filename label in remote mode.

namestringoptionalOptional name for the converter.

conversiontoolsmcp_studio_download_result#Download the result of a successful AI Studio converter run, using the result_file_id from studio_run_status.2 params▾

Download the result of a successful AI Studio converter run, using the result_file_id from studio_run_status.

NameTypeRequiredDescription

result_file_idstringrequiredThe result_file_id from studio_run_status SUCCESS.

output_pathstringoptionalLocal path to save the file (stdio mode).

conversiontoolsmcp_studio_get_converter#Get a custom AI Studio converter's details and current status, including its input/output shape and the file currently attached.1 param▾

Get a custom AI Studio converter's details and current status, including its input/output shape and the file currently attached.

NameTypeRequiredDescription

converter_idstringrequiredThe converter_id (from studio_list_converters or studio_create_converter).

conversiontoolsmcp_studio_list_converters#List the custom converters previously built in AI Studio for the signed-in account, so an existing converter can be reused instead of rebuilding one. Returns up to 10 results, most recent first.1 param▾

List the custom converters previously built in AI Studio for the signed-in account, so an existing converter can be reused instead of rebuilding one. Returns up to 10 results, most recent first.

NameTypeRequiredDescription

searchstringoptionalOptional filter by name/description.

conversiontoolsmcp_studio_run#Run a built AI Studio converter on its attached file. Runs asynchronously; poll studio_run_status for the result.2 params▾

Run a built AI Studio converter on its attached file. Runs asynchronously; poll studio_run_status for the result.

NameTypeRequiredDescription

converter_idstringrequiredThe converter_id to run.

data_sourcestringoptional"uploaded" (the user's file, default) or "sample".

conversiontoolsmcp_studio_run_status#Poll the status of an AI Studio converter run started with studio_run. Returns RUNNING, SUCCESS (with a result file), or ERROR.1 param▾

Poll the status of an AI Studio converter run started with studio_run. Returns RUNNING, SUCCESS (with a result file), or ERROR.

NameTypeRequiredDescription

converter_idstringrequiredThe converter_id whose run to poll.