{"name":"io.github.sunholo-data/parse","slug":"sunholo-data-parse","title":"AILANG Parse","description":"Deterministic DOCX/PPTX/XLSX/PDF parser: track changes, comments, headers, footers, merged cells.","url":"https://mcp.market/server/sunholo-data-parse","rating":null,"grade":"A","score":87,"certified":false,"status":"active","category":"other","tags":[],"presence":{"score":38,"stars":0,"forks":1,"downloads_week":1251,"last_push_at":"2026-09-18T20:15:05.000Z","license":"Apache-2.0"},"uptime":{"percent":100,"checks":5,"ok":5,"last_checked_at":"2026-09-20T18:26:17.197Z","last_ok_at":"2026-09-20T18:26:17.197Z","latency_ms":103},"claimed":false,"transport":"mixed","callable_via_gateway":true,"default_price_micros":0,"repository":"https://github.com/sunholo-data/ailang-parse","website":"https://www.sunholo.com/ailang-parse/","version":"0.13.1","remotes":[{"type":"streamable-http","url":"https://docparse.ailang.sunholo.com/mcp/"}],"packages":[{"registryType":"npm","identifier":"@ailang/parse","version":"0.13.1","runtimeHint":"npx","transport":{"type":"stdio"},"packageArguments":[{"value":"mcp","type":"positional","valueHint":"subcommand"}],"environmentVariables":[{"description":"AILANG Parse API key (dp_...). Optional — the bridge auto-loads keys saved at ~/.config/ailang-parse/credentials.json. Get one from https://www.sunholo.com/ailang-parse/","isSecret":true,"name":"DOCPARSE_API_KEY"},{"description":"Override the hosted MCP endpoint. Defaults to https://docparse.ailang.sunholo.com/mcp/","name":"AILANG_PARSE_MCP_URL"}]},{"registryType":"pypi","identifier":"ailang-parse","version":"0.13.1","runtimeHint":"uvx","transport":{"type":"stdio"},"packageArguments":[{"value":"mcp","type":"positional","valueHint":"subcommand"}],"environmentVariables":[{"description":"AILANG Parse API key (dp_...). Optional — the bridge auto-loads keys saved at ~/.config/ailang-parse/credentials.json. Get one from https://www.sunholo.com/ailang-parse/","isSecret":true,"name":"DOCPARSE_API_KEY"},{"description":"Override the hosted MCP endpoint. Defaults to https://docparse.ailang.sunholo.com/mcp/","name":"AILANG_PARSE_MCP_URL"}]}],"tools":[{"name":"editDocument","description":"Parse a document, apply JSON edit deltas, and return the modified blocks\nas JSON (same format as POST /api/v1/parse with outputFormat=blocks).\n\nfilepath: uploaded file path (multipart upload).\ndeltas:   JSON array of edit operations — see edit_apply.ail for format.\n          Empty array or \"\" → round-trip (parse + return unchanged blocks).\napiKey:   dp_ API key.\n\nResponse: modified blocks JSON. Use the AILANG SDK or CLI to generate a\nfile from the returned blocks (e.g. ailang run ... --convert output.docx).\n\nOnly deterministic office formats are supported (docx, pptx, xlsx, odt, odp, ods).\nAI-required formats (pdf, image, audio, video) are rejected.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"apiKey":{"type":"string"},"deltas":{"type":"string"},"filepath":{"type":"string"}},"required":["filepath","deltas","apiKey"]}},{"name":"getUploadUrl","description":"Request a pre-authenticated GCS upload URL for direct file upload.\nBusiness tier only. The returned URL allows the client to PUT file content\ndirectly to GCS, bypassing the 32MB Cloud Run request limit.\nAfter upload, pass the gcs_ref to POST /api/v1/parse.","write_action":true,"price_micros":0,"input_schema":{"type":"object","properties":{"apiKey":{"type":"string"},"filename":{"type":"string"},"mimeType":{"type":"string"}},"required":["filename","mimeType","apiKey"]}},{"name":"mcpAccount","description":"View account info, pricing, entitlements, or list keys.\nActions:\n  \"status\"  (default) → tier, quota, usage from /me/entitlements\n  \"pricing\"           → public pricing tiers (no auth required)\n  \"keys\"              → list user's API keys with per-key usage\n  \"usage\"             → alias for \"keys\" (per-key usage is shown there)","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"action":{"type":"string"},"apiKey":{"type":"string"}},"required":["apiKey","action"]}},{"name":"mcpAuth","description":"Start device authorization to get an API key.\nReturns device_code, user_code, and verification URL.\nThe agent should display the verification URL to the user, who signs in\nand approves the code. Then call mcpAuthPoll with the device_code.\nMCP wrappers don't have HTTP request headers, so provenance is empty here.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"label":{"type":"string"}},"required":["label"]}},{"name":"mcpAuthPoll","description":"Poll for device authorization completion.\nReturns \"pending\" (keep polling every 5s), \"approved\" (with api_key and tier),\nor \"expired\" (start over with mcpAuth).","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"deviceCode":{"type":"string"}},"required":["deviceCode"]}},{"name":"mcpConvert","description":"Convert a document to another format. Targets: html, md, qmd, docx, pptx,\nxlsx, odt, odp, ods. `input` is a file path, a sample_id, an https:// URL,\nor a gs:// ref (Business tier).\n\nThe converted file comes back as base64 in the JSON response rather than\nwritten to disk, so decode `content` to get the bytes. `outputPath` is\naccepted but ignored; it stays in the signature because removing it would\nchange the auto-generated MCP tool schema for existing clients.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"apiKey":{"type":"string"},"input":{"type":"string"},"outputFormat":{"type":"string"},"outputPath":{"type":"string"}},"required":["input","outputFormat","outputPath","apiKey"]}},{"name":"mcpEstimate","description":"Estimate cost and latency for parsing a document.\nAccepts a file path or sample_id. No auth required.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"filepath":{"type":"string"},"outputFormat":{"type":"string"}},"required":["filepath","outputFormat"]}},{"name":"mcpFormats","description":"Supported formats, samples, and service capabilities. No auth required.\nDelegates to package implementation. Single source of truth lives in\npkg/sunholo/ailang_parse/services/mcp/tools — since ailang_parse 0.39.x the\nresponse carries a runtime capability block (state, not intent), which is\nwhy this is no longer pure: it reads env and probes the runtime (Process).","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"_":{"type":"string"}},"required":["_"]}},{"name":"mcpParse","description":"Parse a document. Accepts a file path or sample_id (e.g. \"sample_docx_formatting\").\nThe hosted server requires a valid dp_ API key — get one via mcpAuth.\nOutput formats: blocks (default), markdown, html, a2ui.\nrequestId is reserved for future replay support.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"apiKey":{"type":"string"},"filepath":{"type":"string"},"outputFormat":{"type":"string"},"requestId":{"type":"string"}},"required":["filepath","outputFormat","apiKey","requestId"]}},{"name":"submit_feedback","description":"Anonymous 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).","write_action":true,"price_micros":0,"input_schema":{"type":"object","properties":{"ailang_version":{"type":"string","description":"The reporter's CLI version (free-form, used for triage)"},"auto_dispatch":{"type":"boolean","description":"Authorize the receiving package's autonomous agent to act on this submission. Default false (files for human triage). Tagged on the Pub/Sub notification as category=auto:<original> for coordinator filtering."},"body":{"type":"string","description":"Full description (≤10 KB)"},"category":{"type":"string","description":"bug | feature | docs | limitation"},"contact":{"type":"string","description":"Optional follow-up address (free-form, opaque to the server)"},"package":{"type":"string","description":"Optional vendor/name (e.g. \"sunholo/auth\") to route to that package's pkg:vendor/name inbox. Empty = general AILANG feedback."},"snippet":{"type":"string","description":"Optional code/error snippet (≤4 KB)"},"title":{"type":"string","description":"Short title for the report"}},"required":["title","body","category","ailang_version"]}}],"scan":{"score":87,"grade":"A","scanned_at":"2026-09-20T20:11:22.037Z","report":{"scannerVersion":"0.1.9","scannedAt":"2026-09-20T20:11:22.012Z","components":{"code":{"score":25,"max":25,"notes":["8 source files scanned","8 source files scanned"]},"reliability":{"score":20,"max":20,"notes":["remote reachable in 857ms"]},"poisoning":{"score":15,"max":15,"notes":["10 tool descriptions checked"]},"auth":{"score":3,"max":15,"notes":["open endpoint exposes 2 write-action tools with no auth"]},"maintenance":{"score":15,"max":15,"notes":["last push 2 days ago"]},"identity":{"score":9,"max":10,"notes":["registry namespace matches repository owner","GitHub account older than a year"]}},"findings":[{"id":"auth.open-write","severity":"high","component":"auth","title":"Write-action tools reachable without authentication"}],"inputs":{"probes":[{"url":"https://docparse.ailang.sunholo.com/mcp/","reachable":true,"authRequired":false,"latencyMs":857,"serverInfo":{"name":"ailang-api","version":"0.8.1"}}],"packages":[{"registryType":"npm","identifier":"@ailang/parse","version":"0.13.1","found":true,"license":"Apache-2.0","hasInstallScripts":false,"dependencyCount":0,"publishedAt":"2026-09-01T15:59:18.609Z","repositoryUrl":"git+https://github.com/sunholo-data/ailang-parse.git","weeklyDownloads":85},{"registryType":"pypi","identifier":"ailang-parse","version":"0.13.1","found":true,"weeklyDownloads":1166,"license":"Apache-2.0","dependencyCount":5,"publishedAt":"2026-09-01T15:59:21.996794Z","repositoryUrl":"https://github.com/sunholo-data/ailang-parse"}],"repo":{"found":true,"owner":"sunholo-data","repo":"ailang-parse","archived":false,"pushedAt":"2026-09-18T20:15:05Z","stars":0,"forks":1,"openIssues":20,"ownerType":"Organization","ownerAvatarUrl":"https://avatars.githubusercontent.com/u/147247777?v=4","ownerCreatedAt":"2023-10-07T10:57:45Z","license":"Apache-2.0"},"icon":{"url":"https://www.sunholo.com/ailang-parse/img/docparse-logo.svg","source":"registry"},"presence":{"stars":0,"forks":1,"downloadsWeek":1251,"license":"Apache-2.0","lastPushAt":"2026-09-18T20:15:05.000Z","score":38}}}},"grade_history":[],"reviews":[]}