Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to the Conversion Tools MCP server

Vendor MCP
Open markdown

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

Tools
21
What they doRead · write · destructive
0 · 21 · 00 read21 write0 destructive
Users sign in with
OAuth app
Scalekit's or your own

Setup

  1. Install the SDK

    Terminal window
    npm install @scalekit-sdk/node dotenv

  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. Create the Conversion Tools MCP connection

    In AgentKit > Connections, create a Conversion Tools MCP connection. The name you give it is the connection_name your code passes. See Configure connections.

    Scalekit credentials are available for Conversion Tools MCP server, so you don't need to register an OAuth app.

  4. Authorize a user 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 = '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)
    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: 'conversiontoolsmcp_auth_status',
      toolInput: {},
    })
    console.log(result)
    Terminal window
    npx tsx quickstart.mts

    Each user signs in once. See Authorize a user for the full flow and statuses.

Tools

Pass the exact name to execute_tool
Try in PlaygroundRequest a tool
  • conversiontoolsmcp_auth_statusCheck authentication status and account info.Write

    Auth Status

    Check authentication status and account info.

    Inputs

    This tool takes no inputs.

  • conversiontoolsmcp_convert_fileConvert a file between 140+ supported formats including documents, images, audio, video, and data files.Write

    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.

    Inputs

    input_pathstringrequired
    Name of the input file, e.g. "orders.xml". Names the upload and gives the input format.
    output_pathstringrequired
    Name for the result, e.g. "orders.xlsx". Its extension gives the output format.
    converterstring
    Converter type, e.g. "convert.xml_to_excel". Optional when the formats are clear from the file names.
    file_contentstring
    Base64 of the input file, at most 5 MB.
    file_idstring
    File id from request_upload_url, after the upload.
    optionsobject
    Converter options, e.g. {"delimiter": "semicolon"}. get_converter_info lists them.
    urlstring
    Public http(s) link to the input file or web page.
  • conversiontoolsmcp_find_converterFind the best converter for converting between two specific formats.Write

    Find Converter

    Find the best converter for converting between two specific formats.

    Inputs

    input_formatstringrequired
    Input format, e.g. "xml", "pdf", "heic".
    output_formatstringrequired
    Output format, e.g. "xlsx", "csv", "jpg".
  • conversiontoolsmcp_get_converter_infoGet detailed information about a specific converter, including available options and their allowed values.Write

    Get Converter Info

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

    Inputs

    converterstringrequired
    Converter type, e.g. "convert.pdf_to_excel".
  • conversiontoolsmcp_get_download_urlRegenerate a fresh, short-lived download URL for a file already converted by convert_file, using its task_id.Write

    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.

    Inputs

    task_idstringrequired
    The task_id returned by convert_file.
  • conversiontoolsmcp_list_convertersList available file converters.Write

    List Converters

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

    Inputs

    categorystring
    Only this category.one of aiaudiodatadocumentsebookimagesocrpdfsubtitlesvideoweb
    input_formatstring
    Only converters that take this format, e.g. "pdf".
    output_formatstring
    Only converters that produce this format, e.g. "csv".
  • conversiontoolsmcp_parse_create_schemaCreate a saved, reusable Parse extraction schema with a named field definition, for extractions that will be run more than once.Write

    Parse Create Schema

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

    Inputs

    fieldsarrayrequired
    The field definitions. Each: {name (snake_case), type, description?, required?, examples?, aliases?, items?, fields?, validation?}.
    namestringrequired
    Human-readable schema name, e.g. "Supplier invoice".
    descriptionstring
    What this schema is for (optional).
  • conversiontoolsmcp_parse_exportTurn a completed Parse extraction into a CSV or XLSX spreadsheet, flattening nested lists into rows.Write

    Parse Export

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

    Inputs

    extraction_idstringrequired
    The completed extraction to export.
    formatstringrequired
    Spreadsheet format.one of csvxlsx
    output_pathstring
    Local path to save the file (stdio mode).
All 45 in Files & Documents