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

What you can do

Connect this agent connector to let your agent:

• Search converters — Search for available ConvertAPI converters that match the specified search terms
• Url request upload — Generate a curl command to upload a local file to ConvertAPI and obtain a FileId
• Get converters by tags, conversion parameters — Retrieve a list of available ConvertAPI converters that match all specified tags
• Convert records — Convert a file from one format to another using ConvertAPI

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.

convertapimcp_convert # Convert a file from one format to another using ConvertAPI. Call 'get_conversion_parameters' first to discover supported parameters, then submit a conversion request with the source format, target format, and any additional parameters. 1 param ▾

Convert a file from one format to another using ConvertAPI. Call 'get_conversion_parameters' first to discover supported parameters, then submit a conversion request with the source format, target format, and any additional parameters.

Name Type Required Description

clientRequest object required No description.

convertapimcp_get_conversion_parameters # Retrieve all available parameters, types, and constraints for a specific format conversion. Call this before 'convert' to understand which parameters are supported for your source and target formats. 2 params ▾

Retrieve all available parameters, types, and constraints for a specific format conversion. Call this before 'convert' to understand which parameters are supported for your source and target formats.

Name Type Required Description

fromFormat string required Source file format to convert from.

toFormat string required Target file format to convert to.

convertapimcp_get_converters_by_tags # Retrieve a list of available ConvertAPI converters that match all specified tags. Returns only converters associated with every tag provided. 1 param ▾

Retrieve a list of available ConvertAPI converters that match all specified tags. Returns only converters associated with every tag provided.

Name Type Required Description

tags array required List of tags to filter converters by. Only converters matching all specified tags are returned.

convertapimcp_request_upload_url # Generate a curl command to upload a local file to ConvertAPI and obtain a FileId. Use this when the file is not publicly accessible via URL; for public URLs pass the URL directly to the 'convert' tool instead. 1 param ▾

Generate a curl command to upload a local file to ConvertAPI and obtain a FileId. Use this when the file is not publicly accessible via URL; for public URLs pass the URL directly to the 'convert' tool instead.

Name Type Required Description

filePath string required Absolute or relative path to the file to upload.

convertapimcp_search_converters # Search for available ConvertAPI converters that match the specified search terms. Each term is matched against converter metadata, and results include converters relevant to all provided terms. 1 param ▾

Search for available ConvertAPI converters that match the specified search terms. Each term is matched against converter metadata, and results include converters relevant to all provided terms.

Name Type Required Description

terms array required List of search terms to filter converters by. Each term is matched against converter metadata.