Servidor MCP de PDFCheck

Conectar por HTTP

Add this URL to a client that supports remote HTTP MCP servers. For account access, configure a bearer Authorization header.

https://pdfcheck.online/api/mcp

Sin token (10 verificaciones gratuitas/día)

To analyze a PDF, your assistant needs a file-reading tool that can send its base64 contents. Connecting MCP alone does not provide access to your files.

{
    "mcpServers": {
        "pdfcheck": {
            "url": "https://pdfcheck.online/api/mcp"
        }
    }
}

Sustituye YOUR_API_TOKEN en la configuración del cliente. Elimina el encabezado Authorization para usar el acceso anónimo.

{
    "mcpServers": {
        "pdfcheck": {
            "url": "https://pdfcheck.online/api/mcp",
            "headers": {
                "Authorization": "Bearer YOUR_API_TOKEN"
            }
        }
    }
}

{
    "servers": {
        "pdfcheck": {
            "type": "http",
            "url": "https://pdfcheck.online/api/mcp",
            "headers": {
                "Authorization": "Bearer YOUR_API_TOKEN"
            }
        }
    }
}

{
    "mcpServers": {
        "pdfcheck": {
            "serverUrl": "https://pdfcheck.online/api/mcp",
            "headers": {
                "Authorization": "Bearer YOUR_API_TOKEN"
            }
        }
    }
}

Comprobar la conexión

Pide primero a tu asistente que llame a check_usage. Después analiza un PDF con un cliente que pueda leer el archivo y codificarlo en base64. Una ruta local por sí sola no funciona con HTTP remoto.

{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
        "name": "check_usage",
        "arguments": {}
    }
}

Herramientas MCP disponibles

Estas herramientas MCP ofrecen análisis de metadatos e historial de la cuenta. La compresión, validación estructural, firma y otras herramientas del navegador no están disponibles mediante estos métodos.

Send the PDF contents

The analyze_pdf tool accepts file_base64 and filename. Your client must read the PDF and encode it as base64; a local file path alone will not work.

{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
        "name": "analyze_pdf",
        "arguments": {
            "file_base64": "BASE64_PDF_CONTENT",
            "filename": "document.pdf"
        }
    }
}

Leer la respuesta

Los resultados de las herramientas contienen texto JSON en result.content[0].text. Analiza ese texto para leer success, data y remaining_checks; los errores también pueden devolver isError.

if (response.error) throw new Error(response.error.message);
const payload = JSON.parse(response.result.content[0].text);
if (response.result.isError || payload.success === false) {
  throw new Error(payload.message || payload.error);
}
console.log(payload.data, payload.remaining_checks);

Usar el puente local

Guarda el siguiente archivo como pdfcheck-mcp-server.mjs en cualquier lugar de tu máquina. Este script ligero conecta tu herramienta de IA con la API de PDFCheck.

El script del servidor MCP requiere Node.js 18 o posterior. Descárgalo de nodejs.org si no lo tienes instalado.

Guarda el script en un directorio propio, instala allí sus dependencias y usa la ruta completa del script en la configuración del cliente.

mkdir pdfcheck-mcp
cd pdfcheck-mcp
npm init -y
npm install @modelcontextprotocol/sdk@1 zod

#!/usr/bin/env node
import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
import { z } from "zod";
import { readFileSync } from "node:fs";
import { basename } from "node:path";

const API_BASE = "https://pdfcheck.online/api/v1";
const TOKEN = process.env.PDFCHECK_API_TOKEN || null;
const headers = TOKEN
  ? { Authorization: `Bearer ${TOKEN}`, Accept: "application/json" }
  : { Accept: "application/json" };

const server = new McpServer({ name: "pdfcheck", version: "1.0.0" });
const result = (data) => ({
  content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
});

server.tool(
  "analyze_pdf",
  "Inspect PDF metadata, dates, software fields, and page count.",
  { filePath: z.string().describe("Absolute path to the PDF file") },
  async ({ filePath }) => {
    const file = new Blob([readFileSync(filePath)], { type: "application/pdf" });
    const body = new FormData();
    body.append("file", file, basename(filePath));
    const response = await fetch(`${API_BASE}/pdf/analyze`, {
      method: "POST", headers, body,
    });
    return result(await response.json());
  }
);

server.tool(
  "get_analysis",
  "Retrieve an accessible analysis by its share token.",
  { token: z.string().describe("Analysis share token") },
  async ({ token }) => {
    const response = await fetch(`${API_BASE}/pdf/${encodeURIComponent(token)}`, { headers });
    return result(await response.json());
  }
);

server.tool("list_analyses", "List your account analyses.", {}, async () => {
  const response = await fetch(`${API_BASE}/pdf`, { headers });
  return result(await response.json());
});

server.tool("check_usage", "Check your account allowance.", {}, async () => {
  const response = await fetch(`${API_BASE}/user`, { headers });
  return result(await response.json());
});

await server.connect(new StdioServerTransport());

Claude / Cursor

Sustituye la ruta del script por su ruta absoluta. Configura PDFCHECK_API_TOKEN con el token de tu cuenta u omite env para el análisis anónimo.

{
    "mcpServers": {
        "pdfcheck": {
            "command": "node",
            "args": [
                "/absolute/path/pdfcheck-mcp-server.mjs"
            ],
            "env": {
                "PDFCHECK_API_TOKEN": "YOUR_API_TOKEN"
            }
        }
    }
}

Usa estas instrucciones con un cliente que pueda leer los archivos indicados. El analyze_pdf remoto necesita file_base64 y filename; una ruta local por sí sola no basta. El puente local acepta filePath.

{
    "name": "analyze_pdf",
    "arguments": {
        "filePath": "/absolute/path/document.pdf"
    }
}

Ejemplos de uso

Usa estas instrucciones con un cliente que pueda leer los archivos indicados. El analyze_pdf remoto necesita file_base64 y filename; una ruta local por sí sola no basta. El puente local acepta filePath.

Analizar un PDF

Analiza el archivo /Users/me/Documents/contract.pdf y dime cuándo fue creado y qué software se utilizó.

Revisar indicadores de software

Revisa los campos creator y producer de /Users/me/Downloads/report.pdf. Explica los indicadores de software sin tratarlos como prueba de autoría de IA.

Análisis por lotes

Analiza uno por uno los PDF que seleccione de mi carpeta Descargas. Compara las fechas de creación y modificación indicadas y explica los metadatos ausentes o incoherentes.

Verificar cuota

¿Cuántas verificaciones de PDF me quedan hoy en PDFCheck?

Uso y límites

Anonymous metadata analysis: 10 checks per day per IP. Free account: 100 checks per day. Individual tools can have different limits.

Para analizar metadatos: sin cuenta y con Free, el límite de subida es de 50 MB. Con Pro y AI, es de 100 MB.

El análisis de metadatos de la API usa un modo ligero y limitado. Se omite el análisis detallado de fuentes, imágenes y colores; metadata.basic.partial_analysis es true.

Los metadatos y los indicadores de software no demuestran la autoría, la autenticidad ni el cumplimiento de estándares.

Generar un token API Opcional

Mantén los tokens en secreto. Usa una variable de entorno y revoca los tokens sin usar desde tu cuenta.

El acceso anónimo permite 10 análisis de metadatos por día y dirección IP. Una cuenta gratuita con token API tiene 100 comprobaciones al día. Usa el token al analizar si quieres recuperar el resultado desde tu cuenta más tarde.

¿Qué es el Model Context Protocol?

El Model Context Protocol (MCP) es un estándar abierto que permite a los asistentes de IA conectarse a herramientas externas y fuentes de datos. Piensa en ello como un enchufe universal que permite a tu asistente de IA comunicarse con servicios como PDFCheck — directamente desde tu ventana de chat.

El servidor HTTP remoto recibe el contenido PDF codificado en base64 desde tu cliente. El puente local opcional lee un PDF de tu equipo y lo envía a la API REST. Ambos devuelven el análisis de metadatos como JSON en content[0].text.

Funciona en todas partes

Usa un cliente que admita MCP HTTP remoto con encabezados Bearer o que pueda ejecutar el puente stdio local. Esta configuración no admite conexiones que solo utilicen OAuth.

El PDF se envía a PDFCheck mediante HTTPS. Tu cliente MCP o proveedor de IA también puede procesar el archivo o los argumentos de la herramienta, según su funcionamiento. Consulta sus políticas de datos y la Política de privacidad de PDFCheck antes de enviar documentos sensibles.

Preguntas frecuentes