AILANG Parse MCP server
Deterministic DOCX/PPTX/XLSX/PDF parser: track changes, comments, headers, footers, merged cells.
0 stars1.3k downloads/wk
Reviews
Write oneNobody has reviewed AILANG Parse yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
AILANG Parse tools (10, 2 write)
write = sends, deletes, buys or postseditDocumentFreeParse a document, apply JSON edit deltas, and return the modified blocks as JSON (same format as POST /api/v1/parse with outputFormat=blocks). filepath: uploaded file path (multipart upload). deltas: JSON array of edit operations — see edit_apply.ail for format. Empty array or "" → round-trip (parse + return unchanged blocks). apiKey: dp_ API key. Response: modified blocks JSON. Use the AILANG SDK or CLI to generate a file from the returned blocks (e.g. ailang run ... --convert output.docx). Only deterministic office formats are supported (docx, pptx, xlsx, odt, odp, ods). AI-required formats (pdf, image, audio, video) are rejected.
getUploadUrlwrite actionFreeRequest a pre-authenticated GCS upload URL for direct file upload. Business tier only. The returned URL allows the client to PUT file content directly to GCS, bypassing the 32MB Cloud Run request limit. After upload, pass the gcs_ref to POST /api/v1/parse.
mcpAccountFreeView account info, pricing, entitlements, or list keys. Actions: "status" (default) → tier, quota, usage from /me/entitlements "pricing" → public pricing tiers (no auth required) "keys" → list user's API keys with per-key usage "usage" → alias for "keys" (per-key usage is shown there)
mcpAuthFreeStart device authorization to get an API key. Returns device_code, user_code, and verification URL. The agent should display the verification URL to the user, who signs in and approves the code. Then call mcpAuthPoll with the device_code. MCP wrappers don't have HTTP request headers, so provenance is empty here.
mcpAuthPollFreePoll for device authorization completion. Returns "pending" (keep polling every 5s), "approved" (with api_key and tier), or "expired" (start over with mcpAuth).
mcpConvertFreeConvert a document to another format. Targets: html, md, qmd, docx, pptx, xlsx, odt, odp, ods. `input` is a file path, a sample_id, an https:// URL, or a gs:// ref (Business tier). The converted file comes back as base64 in the JSON response rather than written to disk, so decode `content` to get the bytes. `outputPath` is accepted but ignored; it stays in the signature because removing it would change the auto-generated MCP tool schema for existing clients.
mcpEstimateFreeEstimate cost and latency for parsing a document. Accepts a file path or sample_id. No auth required.
mcpFormatsFreeSupported formats, samples, and service capabilities. No auth required. Delegates to package implementation. Single source of truth lives in pkg/sunholo/ailang_parse/services/mcp/tools — since ailang_parse 0.39.x the response carries a runtime capability block (state, not intent), which is why this is no longer pure: it reads env and probes the runtime (Process).
mcpParseFreeParse a document. Accepts a file path or sample_id (e.g. "sample_docx_formatting"). The hosted server requires a valid dp_ API key — get one via mcpAuth. Output formats: blocks (default), markdown, html, a2ui. requestId is reserved for future replay support.
submit_feedbackwrite actionFreeAnonymous bug report / feature request / docs gap, queued for human review. Default routing: `public-feedback` inbox (general AILANG). Pass `package="vendor/name"` (e.g. "sunholo/auth") to route to that package's `pkg:vendor/name` inbox where its autonomous agent watches. Categories: bug, feature, docs, limitation. Body limit 10KB, snippet limit 4KB. Optional contact field for follow-up; opaque to the server. Set `auto_dispatch=true` to authorize the package agent to act on your submission immediately (default false — files for human triage; pkg-feedback agent template lands in a separate sprint).
Public scan report
scanner v0.1.9 · 2026-09-20 · same rubric, same numbers if you re-run it
- Code scan8 source files scanned; 8 source files scanned25/25
- Live reliabilityremote reachable in 857ms20/20
- Tool poisoning10 tool descriptions checked15/15
- Auth qualityopen endpoint exposes 2 write-action tools with no auth3/15
- Maintenancelast push 2 days ago15/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year9/10
Findings (1)
- highWrite-action tools reachable without authentication
auth.open-write
What the publisher says
From the AILANG Parse repository's README, as published. We do not edit it. Read it on GitHub
AILANG Parse
Universal document parsing and generation in AILANG. Extracts structured content from DOCX, PPTX, XLSX, PDF, and image files into JSON and markdown — and writes documents back out in 9 formats. To author a document, write Markdown and convert it; see Writing documents in Markdown.
Office formats (DOCX, PPTX, XLSX) use deterministic XML parsing — no AI, no cloud, instant results. PDFs default to the deterministic pdftotext backend (poppler) — also no AI, no cloud — with docling and liteparse as local alternatives and pluggable AI (Gemini, Claude, local Ollama) for scanned/image-only pages via --pdf-backend ai. Images delegate to whatever AI model you plug in. AILANG Parse is AI-agnostic: swap --pdf-backend/--ai to change the backend, zero code changes.
Install
Two routes; both put a docparse command on your PATH, and both write output next to the file you parse (--output-dir DIR or DOCPARSEOUTPUTDIR to change that).
Already have AILANG? (0.42.0+ of this package, AILANG v0.40.0 dev or later)
ailang install sunholo/ailang_parse
docparse report.docxThe package's [bin] table gives you a shim in ~/.ailang/bin that runs straight out of the registry cache: parse one file, or --convert it. It is deliberately the thin path — describe/summarize, batch mode, PDF backends and --install-backends are not on it (see below). ailang bin list / ailang bin uninstall docparse manage it.
Otherwise, or for the full CLI:
curl -fsSL https://www.sunholo.com/ailang-parse/install.sh | shFetches the published package (~400 KB), installs the AILANG runtime if you do not have it, and links the full docparse wrapper (plus docparse-audit and docparse-render) into ~/.local/bin. --version, --prefix and --uninstall are supported; re-running is a no-op. If you install both, ailang install tells you which one docparse resolves to.
That covers every deterministic format. PDF needs two more things, and they are easy to miss:
brew install poppler # pdftotext, the default PDF backend
# (apt install poppler-utils on Debian/Ubuntu)
docparse --install-backends # docling + liteparse, for scans and layout--install-backends matters even if you never pass --pdf-backend: when pdftotext finds no text layer the parser escalates to docling on its own, so without it a scanned PDF fails on the default backend. AI backends authenticate with Google ADC (gcloud auth application-default login), not an API key.
Contributors: install from a clone instead
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Install directly
claude mcp add --transport http parse https://docparse.ailang.sunholo.com/mcp/
AILANG Parse: common questions
- Is AILANG Parse MCP server safe?
- Yes, by our scan: it is graded A (87/100). Read the AILANG Parse safety report
- How do I install AILANG Parse?
- It runs remotely at docparse.ailang.sunholo.com. Add it to Claude Code, Claude Desktop or Cursor with the snippets above, or call it through the mcp.market gateway without installing anything.
- Does AILANG Parse need an API key?
- Yes. The registry entry asks for
DOCPARSE_API_KEY. - Is AILANG Parse maintained?
- The last commit was 2 days ago (2026-09-18). The latest release is v0.13.1.
- Is AILANG Parse up?
- 100% of our last 5 checks got an answer. We check remote servers about four times a day.