convert_file
convertConvert a file between any of Convert Fleet's 178+ supported formats (documents, images, audio, video, e-books, archives, fonts, spreadsheets). Provide the input as a public file_url (preferred) or inline file_base64 + filename, and the target_format (e.g. 'pdf', 'mp3', 'docx', 'webp'). Returns a short-TTL signed download URL for the converted file. Use list_supported_formats first if unsure a target is valid.
- When to use
- The user has a file in one format and needs it in another: docx to pdf, heic to jpg, wav to mp3, mkv to mp4, epub to mobi, csv to xlsx, svg to png. This is the default tool for any 'turn X into Y' request and covers 178+ formats.
- Not for
- Keeping the same format and only making the file smaller (compress_file). Rearranging pages inside a PDF (pdf_operation). Rendering a live web page (html_to_pdf).
- Returns
- A short-TTL signed download URL for the converted file, plus its size and content type.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| file_url | string | no | Public http(s) URL of the input file (preferred for agents). Internal/metadata IPs are blocked. |
| file_base64 | string | no | Base64 of the input file for small inline uploads (<=15MB). Provide 'filename' too. Use file_url for larger files. |
| filename | string | no | Original filename incl. extension (used to detect the source format), e.g. 'invoice.docx'. |
| mime_type | string | no | Optional MIME type of the input. |
| target_format | string | yes | Target format extension, e.g. 'pdf', 'png', 'mp3', 'docx', 'webp'. |
| source_format | string | no | Optional explicit source format if it can't be inferred from the filename. |
| output_filename | string | no | Optional desired output filename. |
Example call
JSON-RPC tools/call body (sent to https://convertfleet.com/api/mcp):
{
"jsonrpc": "2.0", "id": 1, "method": "tools/call",
"params": { "name": "convert_file", "arguments": {
"file_url": "https://example.com/input",
"target_format": "pdf"
} }
}Connect first
curl -sN https://convertfleet.com/api/mcp \
-H "Authorization: Bearer flt_YOUR_KEY" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'See the quickstarts for Hermes, Claude, Cursor, OpenClaw, n8n, Zapier and Make.