Guides
Start typing to search…

MCP Server

ConvertAPI MCP server exposes document converters and tools as discoverable tools for MCP-compatible AI clients (agents, IDE extensions, desktop apps).

You can use ConvertAPI MCP as:

• Hosted MCP (recommended to start with)

Hosted MCP endpoint:

https://mcp.convertapi.io/

Configure your MCP client to use this endpoint, then authenticate using OAuth.

• Self-hosted MCP (local or private environments)

Open-source repository:

https://github.com/ConvertAPI/convertapi-mcp

Self-hosting is useful if you need local file access, private networking, custom deployment, or tighter control over credentials and runtime.

What you can do with it

Instead of writing API calls manually, agents can invoke conversions as structured tool calls. Use ConvertAPI MCP to add reliable conversion steps inside AI workflows, for example:

ConvertAPI supports conversions across 300+ converters and tools.

Self-hosted quick start

Prerequisites

  • .NET 9.0 SDK (or later)
  • ConvertAPI account + API secret

Authentication

ConvertAPI MCP requires a ConvertAPI account and an API token.

  • Get your API Token: follow the instructions in our Authentication guide
  • Environment variable (self-hosted): CONVERTAPI_TOKEN
  • Optional: CONVERTAPI_BASE_URI (defaults to https://v2.convertapi.com)

Tip: Treat your API Token like a password. Do not commit it to source control.

Run locally

  1. Clone the repository:

    • https://github.com/ConvertAPI/convertapi-mcp

  2. Set environment variables:

    macOS / Linux

    export CONVERTAPI_SECRET="your_api_secret_here"
export CONVERTAPI_BASE_URI="https://v2.convertapi.com"

Windows - PowerShell

setx CONVERTAPI_SECRET "your_api_secret_here"
setx CONVERTAPI_BASE_URI "[https://v2.convertapi.com](https://v2.convertapi.com)"

Build:

dotnet build

Start the local MCP server:

dotnet run --project "CA.MCP.Local"

Configure your MCP client (self-hosted)

Your MCP client typically needs:

  • A command to start the MCP server process
  • Environment variables (CONVERTAPI_SECRET, optionally CONVERTAPI_BASE_URI)

Example - Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "convertapi": {
      "command": "dotnet",
      "args": [
        "run",
        "--project",
        "C:\\Path\\To\\CA.MCP.Local\\CA.MCP.Local.csproj",
        "--no-build"
      ],
      "env": {
        "CONVERTAPI_SECRET": "your_api_secret_here",
        "CONVERTAPI_BASE_URI": "https://v2.convertapi.com"
      }
    }
  }
}

Example - Cline (VSCode Extension)

Add to your MCP settings:

{
  "convertapi": {
    "command": "dotnet",
    "args": [
      "run",
      "--project",
      "/path/to/CA.MCP.Local",
      "--no-build"
    ],
    "env": {
      "CONVERTAPI_SECRET": "your_api_secret_here",
      "CONVERTAPI_BASE_URI": "https://v2.convertapi.com"
    }
  }
}

Useful resources

Updated 1 day ago