# Convertapi — how to use (mcp.ai)

Connect your Convertapi account and use 17 tools for documents straight from your AI agent. Connect with your own API key. ConvertAPI is a file conversion service that allows developers to convert various file formats, such as documents, images, and spreadsheets, into different formats programmatically.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_convertapi?ms=1787291400000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `convertapi_async_convert`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/convertapi`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/convertapi/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/convertapi/async/convert` — Tool to perform an asynchronous file conversion. Use when converting large or long-running files to avoid client timeouts.
  - body: { File: string, JobId?: string, WebHook?: string, source_format: string, destination_format: string }
- `POST https://api.mcp.ai/api/convertapi/async/delete/job` — Tool to delete a previously created asynchronous conversion job. Use when the job is no longer required to free server resources.
  - body: { JobId: string }
- `POST https://api.mcp.ai/api/convertapi/check/conversion/support` — Tool to check whether a specific file format conversion is supported by ConvertAPI. Use this before attempting conversions to verify compatibility and avoid errors.
  - body: { source_format: string, destination_format: string }
- `POST https://api.mcp.ai/api/convertapi/convert/delete/uploaded/file` — Tool to delete a previously uploaded file. Use when the file is no longer needed and should be removed from temporary storage.
  - body: { FileId: string }
- `POST https://api.mcp.ai/api/convertapi/convert/get/supported/input/formats/for/output` — Retrieves a complete list of input file formats that ConvertAPI can convert to a specified output format. Use this to check which source formats are compatible with your desired target format before i
  - body: { output_format: string }
- `POST https://api.mcp.ai/api/convertapi/convert/pdf/to/docx` — Tool to convert PDF files to DOCX format. Use when you need editable Word documents from PDFs. Provide PDF content or URL and receive DOCX file metadata and download links.
  - body: { File: string, OcrMode?: string, Timeout?: integer, Wysiwyg?: boolean, FileName?: string, Password?: string, OcrEngine?: string, PageRange?: string, StoreFile?: boolean, Annotations?: string, OcrLanguage?: string }
- `POST https://api.mcp.ai/api/convertapi/convert/pdf/to/jpg/and/store` — Tool to convert a PDF to JPG and store the result on the server. Use when individual JPG pages are needed for further workflow steps.
  - body: { File: string, FileName?: string, StoreFile?: boolean }
- `POST https://api.mcp.ai/api/convertapi/convert/upload/file/from/url` — Tool to upload a file directly from a remote URL. Use when you need to import files hosted on a remote server without downloading locally.
  - body: { Url: string, FileId?: string, FileName?: string, HeaderName?: string, HeaderValue?: string }
- `POST https://api.mcp.ai/api/convertapi/download/file` — Tool to download a converted or uploaded file from ConvertAPI server using its FileId. Use when you need to retrieve a previously converted or uploaded file. Set download='inline' to display in browse
  - body: { file_id: string, download?: string, filename: string }
- `POST https://api.mcp.ai/api/convertapi/download/uploaded/file` — Tool to download a previously uploaded file by its FileId. Use when you need to retrieve the original file data stored temporarily on the server (expires after 3 hours). Example prompt: "Download uplo
  - body: { FileId: string }
- `POST https://api.mcp.ai/api/convertapi/get/converter/spec` — Tool to retrieve the OpenAPI specification for a specific file conversion endpoint. Use when you need detailed parameter schemas and documentation for converting from one format to another.
  - body: { source_format: string, destination_format: string }
- `POST https://api.mcp.ai/api/convertapi/get/file/info` — Tool to get metadata information about a stored file without downloading it. Use when you need to check file properties like name, size, or type before downloading.
  - body: { FileId: string }
- `POST https://api.mcp.ai/api/convertapi/get/openapi/schema` — Tool to retrieve the complete OpenAPI 3.0 specification for all ConvertAPI endpoints. Use when you need comprehensive API documentation for code generation, automated testing, or understanding availab
- `POST https://api.mcp.ai/api/convertapi/get/supported/output/formats/for/input` — Tool to list all output formats a given input format can be converted into. Use when you need to dynamically retrieve conversion options for a specific input format.
  - body: { source_format: string }
- `POST https://api.mcp.ai/api/convertapi/get/user` — Tool to get authenticated user account information including balance, conversions consumed, and remaining seconds. Use when you need to check account status or conversion limits.
- `POST https://api.mcp.ai/api/convertapi/get/user/statistics` — Tool to retrieve usage statistics for the authenticated user account. Use when you need to analyze conversions performed during a specific date range.
  - body: { endDate: string, startDate: string }
- `POST https://api.mcp.ai/api/convertapi/list/converters` — Tool to retrieve a comprehensive list of all available file converters in ConvertAPI. Use when you need to discover all supported conversion types, check which formats can be converted, or view availa

## Example prompts
- "What can I do in Convertapi?"
- "Show me a summary of my Convertapi account"

## More
- Page: https://mcp.ai/convertapi
- Agent spec (llms.txt): https://mcp.ai/convertapi/llms.txt
- Postman collection: https://mcp.ai/convertapi/postman.json