RelayPDF

Gere, converta, edite e extraia PDFs de clientes MCP. O RelayPDF é um servidor MCP de PDF e documentos. Ele gera PDFs a partir de HTML, URLs, Markdown e modelos, converte arquivos do Office, imagens e e-mails, e edita PDFs (mesclar, dividir, preencher, proteger, otimizar). Extrai texto OCR e JSON. Hospedado em https://api.relaypdf.com/mcp ou localmente via npx @relaypdf/cli mcp.

Ver em relaypdf.com

Servidor MCP hospedado

npx add-mcp 'https://api.relaypdf.com/mcp'

Instala no Claude Code, Codex, Cursor e outros

Documentação

Use POST https://api.relaypdf.com/mcp quando o host precisar de uma URL pública (Claude, Relevance, Cursor remoto). Use npx @relaypdf/cli mcp em um laptop após a configuração do relaypdf. Agentes nunca devem pedir a um humano para colar uma chave de API no chat.

Dois transportes, mesmas ferramentas. MCP hospedado é Streamable HTTP com OAuth Clerk (login no navegador) ou uma chave de API Bearer. MCP Stdio é para Cursor/Claude Desktop local após a configuração do relaypdf. As ferramentas de geração no servidor hospedado retornam uma URL de 24 horas — não caminhos de sistema de arquivos e nem bytes brutos.

Hospedado (Streamable HTTP)

POST https://api.relaypdf.com/mcp. Requisições não autenticadas retornam 401 com WWW-Authenticate resource_metadata. Cursor e Claude então completam o login Clerk. Entradas de arquivo são URLs https ou arquivo base64. Prefira a url de uma ferramenta anterior como próxima entrada. async: true retorna um id de trabalho; consulte com jobs_get ou jobs_wait.

Claude Code

claude mcp add --transport http relaypdf https://api.relaypdf.com/mcp

Cursor / JSON (remoto)

Somente URL. O host armazena o token OAuth após Allow. Não coloque uma chave no prompt. Cabeçalhos Bearer ainda funcionam para hosts que já possuem uma chave.

mcp.json

{
  "mcpServers": {
    "relaypdf": {
      "url": "https://api.relaypdf.com/mcp"
    }
  }
}

Chave de API Bearer (opcional)

Scripts e hosts que não podem executar OAuth podem enviar Authorization: Bearer pdf_live_…. Armazene a chave no cabeçalho do host ou no mapeamento de env — não no chat.

mcp.json

{
  "mcpServers": {
    "relaypdf": {
      "url": "https://api.relaypdf.com/mcp",
      "headers": {
        "Authorization": "Bearer pdf_live_…"
      }
    }
  }
}

Stdio (CLI local)

Usa as mesmas credenciais locais dos comandos CLI (~/.config/relaypdf/credentials.json ou RELAYPDF_API_KEY). Ferramentas binárias exigem out (um caminho de sistema de arquivos).

Início

npx @relaypdf/cli mcp

Exemplo Cursor (stdio)

Aponte uma entrada de servidor MCP para npx após a configuração do relaypdf.

mcp.json

{
  "mcpServers": {
    "relaypdf": {
      "command": "npx",
      "args": ["-y", "@relaypdf/cli", "mcp"]
    }
  }
}