Error codes
The MCP server returns standard JSON-RPC 2.0 errors. The most common codes:
-32001Auth / quotaMeaning: Missing, invalid or rate-limited API key, or you are over your credit quota.
Fix: Check your flt_ key and remaining credits with account_status; upgrade your plan if over quota.
-32602Invalid paramsMeaning: A required parameter is missing or has the wrong type — e.g. no file_url/file_base64, or no target_format.
Fix: Provide a file input and all required fields shown on the tool page.
-32010Unsupported formatMeaning: The requested source/target format combination is not supported.
Fix: Call list_supported_formats to pick a valid target_format.
-32000Upstream errorMeaning: The conversion engine returned an error (corrupt file, tool failure).
Fix: Verify the input file is valid and retry; check the error detail in the response data.
-32601Method / tool not foundMeaning: The tool name does not exist in the registry.
Fix: Call tools/list to see the current tool names.