MCP Integration

Connect PDF.beauty to AI assistants like Claude Desktop, Cursor, and other MCP-compatible clients. Convert PDFs directly from your conversations.

What is MCP?

The Model Context Protocol (MCP) is an open standard that allows AI assistants to connect with external tools and services. With our MCP integration, you can ask Claude or other compatible AI assistants to convert PDFs to PPTX — no code required.

Natural Language

Just ask Claude to convert your PDF

No Code Required

Works directly in your AI assistant

Easy Setup

Configure once, use everywhere

Claude Desktop Setup

Add PDF.beauty to your Claude Desktop configuration file:

1Open Claude Desktop settings

2Navigate to Developer → Edit Config

3Add the following configuration:

claude_desktop_config.json

{
  "mcpServers": {
    "pdf-beauty": {
      "url": "https://api.pdf.beauty/mcp",
      "transport": "sse",
      "headers": {
        "Authorization": "Bearer pk_xxxxxxxxxxxxx"
      }
    }
  }
}

Note: Replace pk_xxxxxxxxxxxxx with your actual API key.Get your API key →

Available Tools

pdf_to_pptx

Convert a PDF file to an editable PPTX presentation

file_urlstringrequiredURL of the PDF file to convert

optionsobjectConversion options (quality, etc.)

get_task_status

Check the status of a conversion task

task_idstringrequiredThe task ID returned from pdf_to_pptx

download_result

Get the download URL for a completed conversion

task_idstringrequiredThe task ID of the completed conversion

Example Conversation

Claude Desktop

User: Convert this PDF to an editable presentation
      https://example.com/slides.pdf

Claude: I'll convert that PDF to PPTX for you using PDF.beauty.

      [Calling pdf_to_pptx with file_url="https://example.com/slides.pdf"]
      
      Task created: task_abc123
      
      [Calling get_task_status with task_id="task_abc123"]
      
      ✓ Conversion complete! Your PPTX is ready.
      
      Download: https://api.pdf.beauty/v1/download/task_abc123