convert_file
Convert a file to other format via Convert.Guru API. Pass the file path and output extension.
LABSCO SUMMARY
The conversion runs at Convert.Guru, so the answer to 'which formats' lives there too.
detect_file_type is precise about what leaves the machine: the first 200 bytes, sent for identification. convert_file states only that the conversion goes via the Convert.Guru API and that it takes a path and an output extension, so which conversions are supported is settled on the API side rather than in this tool list. For a model handling files it did not create, running detect_file_type before convert_file turns a guess about an extension into a check.
What it is
A bridge to the Convert.Guru API for files on the local filesystem: type detection first, format conversion second.
What you get
- detect_file_type identifies a file at a path by sending the first 200 bytes of it to the Convert.Guru API — identification does not require handing over the whole file.
- convert_file converts a file at a path to another format, driven by the output extension you pass in ext_out.
Requirements
A Convert.Guru API key in CONVERT_GURU_API_KEY, and the file readable at a path the server can reach.
Setup effort
Add the configuration to your client
USE CASES
01
Turning a file of unknown type into the format the next step expects
Identify what the file actually is before trusting its extension, then convert it to the target extension through the API.
2 tools
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
detect_file_type
Detect file type by sending the first 200 bytes of the file to Convert.Guru API.
BEFORE YOU INSTALL
What to know first
Tools you get
2 tools when we connected. The supported formats are values of convert_file's ext_out parameter, not separate tools.
CONTEXT COST
Light Standing cost
Rated by the size of the 2 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
Connect your client
MCP Clients
Any MCP client — uvx
ANY MCP CLIENT — UVX · JSON
{
"mcpServers": {
"file-convert": {
"command": "uvx",
"args": [
"--from",
"git+https://github.com/convertguru/file-convert-mcp.git",
"file-convert-mcp"
],
"env": {
"CONVERT_GURU_API_KEY": "<YOUR_CONVERT_GURU_API_KEY>"
}
}
}
}Any MCP client — local uv
Clone the repository
Only for running from a local copy; the uvx tab fetches it from GitHub for you.
ANY MCP CLIENT — LOCAL UV · TERMINAL
git clone https://github.com/convertguru/file-convert-mcp.git
which uvAdd this to your app's MCP settings
/home/<YOUR_USERNAME>/.local/bin/uv is the path which uv printed, and /home/<YOUR_USERNAME>/file-convert-mcp is the full path of your clone.
ANY MCP CLIENT — LOCAL UV · JSON
{
"mcpServers": {
"file-convert": {
"command": "/home/<YOUR_USERNAME>/.local/bin/uv",
"args": [
"--directory",
"/home/<YOUR_USERNAME>/file-convert-mcp/src/file_convert_mcp",
"run",
"server.py"
],
"env": {
"CONVERT_GURU_API_KEY": "<YOUR_CONVERT_GURU_API_KEY>"
}
}
}
}Any MCP client — local uvx
Clone the repository
Only for running from a local copy; the uvx tab fetches it from GitHub for you.
ANY MCP CLIENT — LOCAL UVX · TERMINAL
git clone https://github.com/convertguru/file-convert-mcp.gitAdd this to your app's MCP settings
/home/<YOUR_USERNAME>/file-convert-mcp is the full path of your clone. file-convert-mcp at the end is the command the package installs.
ANY MCP CLIENT — LOCAL UVX · JSON
{
"mcpServers": {
"file-convert": {
"command": "uvx",
"args": [
"--from",
"/home/<YOUR_USERNAME>/file-convert-mcp",
"file-convert-mcp"
],
"env": {
"CONVERT_GURU_API_KEY": "<YOUR_CONVERT_GURU_API_KEY>"
}
}
}
}
