MCP connection

audit_document · Audit a PDF

Runs an accessibility AUDIT of a PDF against WCAG 2.1/2.2, PDF/UA (ISO 14289) and the European Accessibility Act (Directive (EU) 2019/882). Does not modify the document and does not consume conversion quota. Send a new file (file_base64 or file_url) or an existing document_id. Returns a document id immediately: the work runs in the BACKGROUND, so poll it with get_document_status or block with wait_for_document.

REST equivalent: POST /api/v1/documents (type=audit) · POST /api/v1/documents/{id}/audit

{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
        "name": "audit_document",
        "arguments": {
            "filename": "annual-report-2026.pdf",
            "file_base64": "JVBERi0xLjQK…"
        }
    }
}

convert_document · Convert a PDF to accessible PDF/A

CONVERTS a PDF into a tagged, accessible PDF/A (PDF/A-2b + PDF/UA-1: semantic structure, reading order, language, metadata and AI-generated alternative text for images). Consumes the plan quota. Send a new file (file_base64 or file_url) or an existing document_id; with document_id it is idempotent — if the document already has an accessible PDF/A, or a conversion is already running, no duplicate work is queued. Runs in the BACKGROUND: use wait_for_document and then download_document.

REST equivalent: POST /api/v1/documents (type=conversion) · PUT /api/v1/documents/{id}/conversion

{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
        "name": "convert_document",
        "arguments": {
            "filename": "annual-report-2026.pdf",
            "file_url": "https://pdfaccesible.com/samples/annual-report-2026.pdf"
        }
    }
}

get_document_status · Get processing status

Current state of a document: status (queued, processing, done, error), progress percentage, current step and, once finished, the accessibility score, the per-standard breakdown and the download links.

REST equivalent: GET /api/v1/documents/{id}

{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
        "name": "get_document_status",
        "arguments": {
            "document_id": "20260730-120501-a1b2c3"
        }
    }
}

wait_for_document · Wait until processing finishes

Waits (polling on the server) until the document finishes processing or the timeout elapses, then returns the final status. Saves calling get_document_status in a loop. An audit usually takes 10-60 s; an AI-assisted conversion, 1-5 min. On timeout it returns the current status with a warning instead of an error, so you can simply call it again.

REST equivalent: — (server-side polling; no REST equivalent)

{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
        "name": "wait_for_document",
        "arguments": {
            "document_id": "20260730-120501-a1b2c3",
            "timeout_seconds": 120
        }
    }
}

get_document_report · Get the accessibility report

Full report: overall score (the mean of WCAG, PDF/UA and EAA), score per standard and findings with severity and normative reference. If the document was converted, it also includes the result measured on the generated PDF/A and the score improvement.

REST equivalent: GET /api/v1/documents/{id}/report

{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
        "name": "get_document_report",
        "arguments": {
            "document_id": "20260730-120501-a1b2c3",
            "max_findings": 10
        }
    }
}

download_document · Download the PDF

Returns one of the two PDFs of the document: "pdfa" (the generated accessible version) or "original". By default it returns an authenticated download link; with delivery="base64" the file is embedded in the response (only advisable for small files).

REST equivalent: GET /api/v1/documents/{id}/file/{original|pdfa}

{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
        "name": "download_document",
        "arguments": {
            "document_id": "20260730-120501-a1b2c3",
            "file": "pdfa",
            "delivery": "link"
        }
    }
}

list_documents · List documents

Lists the documents of the account, newest first, with optional filters by type (audit / conversion) and status, and pagination.

REST equivalent: GET /api/v1/documents

{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
        "name": "list_documents",
        "arguments": {
            "status": "done",
            "per_page": 10
        }
    }
}

delete_document · Delete a document

Permanently deletes a document from the account: the original PDF, the generated PDF/A and the report. Cannot be undone. Documents are deleted automatically after 30 days anyway.

REST equivalent: DELETE /api/v1/documents/{id}

{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
        "name": "delete_document",
        "arguments": {
            "document_id": "20260730-120501-a1b2c3"
        }
    }
}

get_account · Get plan, limits and usage

Subscribed plan, limits (maximum size per document, conversions per month, request rate) and usage for the current month, including how many free conversions are left. Worth checking before processing a batch of documents.

REST equivalent: GET /api/v1/account

No arguments.

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