Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Conversion Tools MCP connector

OAuth 2.1/DCR Files & DocumentsProductivityAI

Connect to Conversion Tools MCP. Convert files between 140+ formats including documents, images, audio, video, and data files from your AI workflows.

Conversion Tools MCP connector

  1. Install the SDK

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

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

What you can do

Section titled “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

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.

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.

Name Type Required Description
force boolean optional Force 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.

Name Type Required Description
input_path string required Local path to the input file, used for filename and format detection.
output_path string required Local path where the converted file should be saved.
converter string optional Specific converter type to use (e.g., convert.pdf_to_excel). If omitted, the converter is auto-detected from file extensions.
file_content string optional Base64-encoded file content for files 5 MB or smaller.
file_id string optional File ID returned by request_upload_url for files larger than 5 MB.
options object optional Converter-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.

Name Type Required Description
input_format string required Input file format extension (e.g., pdf, xlsx, png).
output_format string required Desired 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.

Name Type Required Description
converter string required Converter 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.

Name Type Required Description
category string optional Filter converters by category.
input_format string optional Filter by input format extension (e.g., pdf, xlsx, png).
output_format string optional Filter 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.

Name Type Required Description
filename string required Name of the file to upload, including its extension.