Use Conversion Tools from Any AI Agent

Choosing a surface

Conversion Tools exposes two complementary surfaces:

• MCP server - a hosted Model Context Protocol endpoint at https://mcp.conversiontools.io/mcp. Any MCP-compatible agent connects and calls conversion tools directly. Zero install, always latest.
• ctio CLI - a single binary your agent calls in the shell. Composes with Unix pipes, streams arbitrarily large files, works in any terminal. Best when the agent has shell access.

When an agent can run shell commands, the CLI is usually the better fit (faster, composable, no upload size ceiling). For web-only assistants, the MCP server is the zero-install path.

Claude Code

Install

Install the plugin (skill + MCP server connection):

claude plugin marketplace add conversiontools/agent-skills
claude plugin install conversiontools@conversiontools-skills

Or add just the MCP server:

claude mcp add --transport http conversiontools https://mcp.conversiontools.io/mcp

Update

claude plugin marketplace update conversiontools-skills
claude plugin update conversiontools@conversiontools-skills

Then run /reload-plugins (or restart Claude Code).

Test

Run /mcp and confirm conversiontools shows as connected, then ask:

Convert data.json to an Excel file.

Cursor

Install

One-click - open this link and Cursor adds the server for you:

Add Conversion Tools to Cursor

Prefer the terminal? The Cursor CLI manages MCP servers:

agent mcp list

Update

Nothing to do - the MCP server is hosted and always current. Cursor refreshes the tool list automatically; if needed, toggle the server off and on in Settings - MCP.

Test

On first use Cursor opens a browser for OAuth login, then ask the agent:

Convert report.pdf to Excel.

Gemini CLI

Install

gemini extensions install https://github.com/conversiontools/agent-skills

The standalone conversiontools/gemini-extension repo also works and stays current.

Update

gemini extensions update conversiontools

Test

Run gemini, authenticate via OAuth on first use, then ask:

Transform this XML file to CSV.

OpenAI Codex

Install

Add the MCP server, then complete the OAuth login:

codex mcp add conversiontools --url https://mcp.conversiontools.io/mcp
codex mcp login conversiontools

Or install the plugin (skill + server):

codex plugin marketplace add conversiontools/agent-skills

Then open the plugins browser with /plugins and install conversiontools. The CLI and IDE extension share this config.

Update

The hosted MCP server is always current (nothing to update). If you installed the plugin, refresh it from the marketplace.

Test

In the Codex TUI, run /mcp to confirm the server, then ask:

Extract the line items from invoice.pdf as JSON.

Grok Build

Install

Add the MCP server to xAI's terminal coding agent:

grok mcp add conversiontools --url https://mcp.conversiontools.io/mcp

A native plugin listing in the Grok marketplace is on the way - once live, browse and install it with /marketplace inside Grok Build.

Update

Nothing to do - the hosted MCP server is always current.

Test

Convert all the PNG files in this folder to WebP.

Antigravity

Install

Google Antigravity reads MCP servers from one shared config file used by both the IDE and the agy CLI. Open it from the IDE's Settings - Customizations - Open MCP Config, or edit ~/.gemini/config/mcp_config.json directly. Antigravity uses serverUrl (not url) for remote servers:

{
  "mcpServers": {
    "conversiontools": {
      "serverUrl": "https://mcp.conversiontools.io/mcp"
    }
  }
}

Save it. The IDE shows it after a refresh of the Installed MCP Servers panel; the CLI regenerates its MCP cache on the next launch (verify with the /mcp panel inside agy). OAuth runs in your browser on first use.

Update

Nothing to do - the hosted MCP server is always current.

Test

Turn this Markdown file into a narrated MP3.

Any MCP client

Install

Any tool that supports the Model Context Protocol can connect to the hosted server:

https://mcp.conversiontools.io/mcp

On first use you authenticate via OAuth in your browser. See the MCP server documentation for the full tool list and usage examples.

Update

Nothing to do - the hosted server is always current.

Agent platforms

If your agents run on an integration or agent platform, Conversion Tools may already be in its catalog. Connect it there with your API token from your Profile, and your agents can convert files without any extra setup.

Listed in: DigitalOcean Action Gateway · Composio · One · APIANT

Building a connector for another platform? See Building a connector in the API documentation.

ctio CLI

Install

# Windows (scoop)
scoop bucket add conversiontools https://github.com/conversiontools/scoop-bucket
scoop install ctio

# macOS / Linux (Homebrew)
brew install conversiontools/tap/ctio

# Authenticate
ctio auth login

Direct downloads for every platform are in the ctio CLI documentation.

Update

scoop update ctio      # Windows
brew upgrade ctio      # macOS / Linux

Test

ctio convert -t pdf_to_excel report.pdf out.xlsx

Supported Formats

Convert between 140+ file formats across 14 categories - the same set is available on every surface above.

View the full converter list for details on each converter and its options.

Pricing

Every surface uses the same conversion limits as your account:

• Free tier: 100 conversions per month (max 10 per day)
• Paid plans: higher limits and priority processing

View pricing plans or API pricing for details.