developer-tools Static interface comparison

MinerU Open MCP

1.0.21 1.0.22

FAILPending human review

1 new write capability requires explicit review.

View the upgrade review as Markdown

A shareable summary of this comparison for an issue, pull request or ticket. Select the text and copy it.

Tools2 → 2
Added0
Removed0
Schema changes0
Input schema changes0
Output schema changes0
Unclassified schema changes0
Description changes2
New write authority1
New destructive authority0
New unknown authority0
AnalysisFAIL

INTERFACE DIFF

What changed, tool by tool

Classification from the recorded findings · definitions from the published snapshots

2 tools with recorded changes

  1. get_ocr_languagesModifiedDescriptionINFO

    What changed

    • get_ocr_languages: description changed.

    Why it could matter

    • Models choose and call tools partly from their descriptions.

    What to verify

    • Spot-check that agents still select this tool as intended.
    Declared effect
    read → read
    Description
    PreviousReturn the supported MinerU OCR / script language codes (e.g. ch, en, japan, latin). Read-only; no uploads. Use before setting `language` on `parse_documents` for scanned or multilingual documents. Do not use for converting files—call `parse_documents` instead.
    CurrentReturn supported MinerU OCR and script language codes (e.g. ch, en, japan, latin). Read-only; no uploads. Use before setting the language argument on parse_documents for scanned or multilingual documents. Do not use for file conversion; call parse_documents instead.

    Input schema

    Input schema unchanged.

    1 unchanged entry
    • (schema root)

    Output schema

    Output schema unchanged.

    1 unchanged entry
    • (schema root)
    Exact JSON from the published snapshots

    Loads the exact recorded definitions of this tool from both releases. The full snapshots are linked under Evidence and provenance.

    Link to this tool
  2. parse_documentsModifiedAuthorityDescriptionFAILINFO

    What changed

    • parse_documents: declared effect changed from read to write.
    • parse_documents: description changed.

    Why it could matter

    • An existing tool name now declares stronger authority, so a configuration that allowed it before may allow more now.
    • Models choose and call tools partly from their descriptions.

    What to verify

    • Re-confirm whether agents should keep access to this tool.
    • Spot-check that agents still select this tool as intended.
    Declared effect
    read → write
    Description
    PreviousConvert PDFs, Word (DOCX), PowerPoint (PPTX), Excel (XLSX in Flash mode), images, and public document URLs—or HTML page URLs—into Markdown using the MinerU cloud API. **World effects:** Reads local paths you pass; fetches http(s) URLs. Uploads file or URL content to mineru.net for processing (do not use for data you must not send off-device). Does not modify or delete originals. May write Markdown (and sometimes images) under `output_dir` or the server default when results are saved or inline content is too large. **Auth & limits:** Without `MINERU_API_TOKEN`, uses free Flash mode: Markdown-only output, service limits apply. With `MINERU_API_TOKEN`, higher per-file page limits and optional extra output formats per MinerU plans; token is read from env (or HTTP Bearer when using streamable HTTP). **Use this when:** The user needs full-document extraction, tables/formulas as HTML/Latexa, batch conversion, or per-file PDF page ranges. **Do not use** for listing supported OCR script codes—call `get_ocr_languages` instead. **Not a substitute** for offline-only or strictly local parsers. **Parameters (intent):** `file_sources` is a list of path/URL strings or `{"source": "…", "pages": "1-5"}` objects (PDF page ranges; Flash allows simple `N` or `N-M`). `enable_ocr` defaults to true. `language` is an OCR/script code (default `ch`); see `get_ocr_languages` for valid values. Set `model` to `"html"` only when every source is a web page URL; otherwise omit. `output_dir` overrides where large or batch results are written.
    CurrentConvert PDF, Office (DOCX, PPTX), spreadsheets (XLSX in Flash mode), images, and http(s) URLs to Markdown using the MinerU cloud API (content is uploaded to mineru.net; do not use for data that must stay on-device). Does not modify source files; may write Markdown under output_dir when saving results. Auth: without MINERU_API_TOKEN, Flash mode applies (Markdown-only, about 20 pages and 10 MB per file; service rate limits). With MINERU_API_TOKEN, higher limits and optional formats per plan. Use for extraction and conversion. Use get_ocr_languages only to list OCR language codes, not to parse files. Not for fully offline parsing. Parameters: file_sources is paths/URLs or objects with source and pages for PDF ranges; language is an OCR code (default ch); enable_ocr defaults to auto (null); set model to html only if every source is a web page URL.

    Input schema

    Input schema unchanged.

    7 unchanged entries
    • (schema root)
    • enable_ocr
    • file_sources
    • file_sources › [items]
    • language
    • model
    • output_dir

    Output schema

    Output schema unchanged.

    1 unchanged entry
    • (schema root)
    Exact JSON from the published snapshots

    Loads the exact recorded definitions of this tool from both releases. The full snapshots are linked under Evidence and provenance.

    Link to this tool

Evidence and provenance

Static findings
FAIL from Modelara’s automated analysis of the two declared interfaces. A policy outcome, not a security rating or a runtime test.
Human review
Pending human review. No reviewer decision is recorded for this comparison.
Published evidence
Part of Valyd’s published data generation listed in valyd-data-source.json. Published records are not rewritten.
Show provenance and exact files
Comparison
opendatalab-mineru-open-mcp/1.0.21~1.0.22The published comparison identifier.
Analyzer
modelara v0.1.8Policy version not recorded.Analyzed Nov 17, 2026, 12:19 AM UTC.
Distribution
pypi
Previous release
mineru-open-mcp@1.0.212 tools · published by the registry Apr 13, 2026, 10:48 AM UTC · upstream 1.0.21Artifact integritysha256-zcZ+9Y7yJboxE4wH3BlByKZ/v1y49g5Qo/j900faHtw=Artifactmineru_open_mcp-1.0.21-py3-none-any.whlInterface fingerprintsha256:0137dd7ea0ea28d985d8d155e80f6b7013b4ae89824f6bc68a36a9e8f6fa26e3Exact interface snapshot (JSON)
Current release
mineru-open-mcp@1.0.222 tools · published by the registry Sep 22, 2026, 12:36 PM UTC · upstream 1.0.22Artifact integritysha256-HLy6Qy9DvTiKQNzRtFPoWhn1ErX3WNYh5SyPAllKgEQ=Artifactmineru_open_mcp-1.0.22-py3-none-any.whlInterface fingerprintsha256:e72d0b3cb91cb44d3d607b66120016e1bfb17e56cbd14cd6b8ba265301bc670dExact interface snapshot (JSON)

The integrity value or digest identifies the exact artifact that was inspected; it does not show that the package is safe. The interface fingerprint identifies the declared tools and schemas Modelara recorded for that release.

MODELARA ANALYSIS OUTPUT

Interface findings

Analyzed with Modelara v0.1.8 · Nov 17, 2026

Policy failures

1 finding
  • parse_documentsFAILChanged

    Declared effect read → write

    Authority
    READWRITE

Informational

2 findings
  • get_ocr_languagesINFOChanged

    Description changed

    Authority
    READREAD
    Authority unchanged
  • parse_documentsINFOChanged

    Description changed

    Authority
    READWRITE
What do these results mean?
PASS
No policy-significant interface change detected.
REVIEW
Interface changes require inspection.
FAIL
A policy-significant change was detected.
INVALID
The comparison could not be evaluated reliably.
← Back to MinerU Open MCP release history