---
title: Universal File Converter
emoji: 🗃️
colorFrom: yellow
colorTo: green
sdk: gradio
sdk_version: 5.33.0
app_file: src/app.py
tags:
  - mcp-server-track
  - file-converter
  - api
pinned: false
license: apache-2.0
short_description: Convert any file to any file format.
---

# MCP Server: Universal File Converter

This project includes an MCP (Model Context Protocol Servers) server for universal file conversion.

- **Gradio App URL:** https://huggingface.co/spaces/Agents-MCP-Hackathon/universal-file-converter
- **MCP Server URL:** https://agents-mcp-hackathon-universal-file-converter.hf.space/gradio_api/mcp/sse

**Available MCP Tools:**

*   `universal_file_converter_convert_local_file`: Convert a local document to a different format. This requires the server to be running locally. Parameters: `local_file_path` (string), `output_format` (string, default: "pdf").
*   `universal_file_converter_convert_from_url`: Convert a document from a URL to a different format. Parameters: `document_url` (string), `output_format` (string, default: "pdf").

**Note on API Usage:** If you encounter API errors, it might be due to the free version's limit of 250 requests. To overcome this, consider duplicating the Space and adding your own [https://www.convertapi.com/](https://www.convertapi.com/) API key as environmental variable.

**Watch the demo video:** [Universal File Converter MCP Server Demo (Agents MCP Hackathon)](https://www.youtube.com/watch?v=leq0dmR2ucg)
[![Watch the demo on YouTube](image.png)](https://youtu.be/leq0dmR2ucg)

## Integration with MCP clients

## Integration

To integrate this MCP into clients that support SSE (e.g., Cursor, Windsurf, Cline), add the following configuration to your MCP config:

```json
{
  "mcpServers": {
    "gradio": {
      "url": "https://agents-mcp-hackathon-universal-file-converter.hf.space/gradio_api/mcp/sse"
    }
  }
}
```

For clients that only support stdio, such as Claude desktop, first install Node.js from the official website (https://nodejs.org/). Then, you can use the following command:

```json
{
  "mcpServers": {
    "gradio": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://agents-mcp-hackathon-universal-file-converter.hf.space/gradio_api/mcp/sse",
        "--transport",
        "sse-only"
      ]
    }
  }
}
```

## Prompt Example

```
Can you please convert the https://raw.githubusercontent.com/kingabzpro/bbc-news-class-mlops/refs/heads/master/README.md file into PDF
```

## Supported File Formats

```
pdf, docx, doc, txt, rtf, odt, html, epub, png, jpg, jpeg, gif, bmp, tiff, webp, svg, xlsx, xls, csv, ods, pptx, ppt, odp, mp4, avi, mov, wmv, flv, webm, mp3, wav, flac, aac, ogg
```