AILANG Parse

Tools

• createUpload

  Get one-time upload links for files in your sandbox or workspace, when you can run shell commands with network access (Claude Code, Codex, a code sandbox). One token PER FILE: a token uploads exactly one file. For several files set count (1..20) to get that many descriptors in one call. Each descriptor has a curl line: run it where the file is (replace <path>); it prints a receipt with a fileRef. Then call mcpParse, mcpConvert or editDocument with that fileRef. Tokens work once, for 10 minutes. If curl fails with a network error, or the user wants to pick a file, call uploadDocument instead, or ask for an https:// link. Never parse the file yourself.

  Measured 8 hr ago

• editDocument

  Edit a document: parse it, apply a JSON array of edit deltas, and return the modified blocks (same shape as mcpParse with outputFormat "blocks"). deltas "" or "[]" returns the document unchanged. Office formats only: docx, pptx, xlsx, odt, odp, ods. Give the document ONE way: fileRef: a file the user uploaded (mcp-file://docparse/file_...). file: in ChatGPT, the file the user attached (ChatGPT fills it in). content + filename: the file base64-encoded, contentEncoding="base64", e.g. filename "contract.docx". filepath: an https:// URL of a publicly reachable document, or a sample id from mcpFormats such as "sample_docx_formatting". To get a file back, pass the edited blocks' Markdown to mcpConvert. Which way to send a file: a file in your sandbox or workspace: call createUpload (one token PER FILE; set count for several) and run its curl line, then pass the fileRef here. curl fails with a network error, or the user wants to pick a file: call uploadDocument (the user chooses it in the AILANG Parse card). The card parses the file; it does not convert or edit it. a public https:// link; short text as content. In ChatGPT, file. Never parse the file yourself (your own script, or your own reading of it) and present that as this tool's result: if the file cannot be sent, tell the user.

  Measured 8 hr ago

• mcpAccount

  Your AILANG Parse account: plan, monthly usage and limits, your keys, and whether request history is kept. Actions: "status" (default) → plan, usage this month and remaining allowance "keys" → your keys with per-key usage ("usage" is an alias) "history" → whether request history (parsed output kept for replay) is on for your account "history_on" / "history_off" → change it for the account and all its keys

  Measured 8 hr ago

• mcpConvert

  Create a document in another format: docx, pptx, xlsx, odt, odp, ods, html, md or qmd. To write a new document, write Markdown and send it as content with filename "notes.md" (headings become slides in pptx). To convert an existing document, give it ONE way: fileRef: a file the user uploaded (mcp-file://docparse/file_...). file: in ChatGPT, the file the user attached (ChatGPT fills it in). content + filename: the document itself; binary files base64-encoded with contentEncoding="base64", text as plain text. input: an https:// URL of a publicly reachable document, or a sample id from mcpFormats. Which way to send a file: a file in your sandbox or workspace: call createUpload (one token PER FILE; set count for several) and run its curl line, then pass the fileRef here. curl fails with a network error, or the user wants to pick a file: call uploadDocument (the user chooses it in the AILANG Parse card). The card parses the file; it does not convert or edit it. a public https:// link; short text as content. In ChatGPT, file. Never parse the file yourself (your own script, or your own reading of it) and present that as this tool's result: if the file cannot be sent, tell the user. The result carries download_url, a link to the generated file valid for one hour: give it to the user. It also carries the file as base64 in content (encoding "base64"; text formats come back as utf8). Leave outputPath empty: the server cannot write to your filesystem.

  Measured 8 hr ago

• mcpEstimate

  Estimate cost and latency for parsing a document. Accepts a file path or sample_id. No auth required. Returned through mcpOutput, like every other MCP tool: a JSON value (not a double-encoded string) without request_id/meta, which OpenAI review forbids in tool results. The REST estimate route keeps them.

  Measured 8 hr ago

• mcpFormats

  What AILANG Parse can read and write, how to send it a document, and the sample documents you can try without one. No sign-in needed.

  Measured 8 hr ago

• mcpParse

  Parse a document into structured blocks, Markdown, HTML or A2UI, or a short summary of it. Give the document ONE way: fileRef: an uploaded file (mcp-file://docparse/file_...). The same user can use it again for 30 minutes after the first use (more parts, another format), then it is deleted. file: in ChatGPT, the file the user attached (ChatGPT fills it in). filepath: an https:// URL of a publicly reachable document, or a sample id from mcpFormats such as "sample_docx_formatting". content + filename: short text only (Markdown, HTML, CSV); the filename's extension picks the parser. outputFormat: blocks (default), markdown, html, a2ui, or summary (counts, the first 50 headings, warnings: a few KB). Look with summary first when a document may be large. Large documents come in parts: when the result has page.nextCursor, call mcpParse again with the same fileRef/filepath and cursor=<nextCursor> for the next part; read every part before answering about the whole document. maxChars sets the part size in characters (default 80000, 2000..120000). pdfBackend: leave empty for PDFs with a text layer. Set "ai" when the result is PDF_TEXT_LAYER_SPARSE (a scanned PDF): each page is read by an AI model, about 5 seconds a page, and the call counts as an AI request. Pass the same pdfBackend with every cursor call. Which way to send a file: a file in your sandbox or workspace: call createUpload (one token PER FILE; set count for several) and run its curl line, then call this tool with the fileRef the upload prints. curl fails with a network error, or the user wants to pick a file: call uploadDocument; the user chooses it in the AILANG Parse card, which uploads it and gives you its fileRef. a public https:// link: filepath. Short text: content. Never parse the file yourself (your own script, or your own reading of it) and present that as this tool's result: if the file cannot be sent, tell the user.

  Measured 8 hr ago

• submit_feedback

  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).

  Measured 8 hr ago

• uploadDocument

  Let the user pick a file to parse: shows the AILANG Parse card with a Choose file button. The card uploads the file and tries to summarise it for you; either way you get its fileRef. Then call mcpParse with that fileRef for the content (the same user can reuse it for 30 minutes; a large document comes in parts). Use this when the user wants to pick a file, or when createUpload's curl fails with a network error. For a file already in your sandbox or workspace, use createUpload + curl instead. Never parse the file yourself.

  Measured 8 hr ago

• uploadViaHost

  Receive a file from the AILANG Parse upload widget, relayed by the host as base64. Only the widget calls this; ticket is the upload token it holds.

  Measured 8 hr ago

Probe history

• 8 hr agook182 ms10 tools
• 23 hr agook221 ms10 tools

Status and uptime

Add badge to your README

The image links back to this page. It shows checks passed, or uptime, and the colour follows the latest status. Responses are cached for 5 to 15 minutes.

[![MCP Heartbeat](https://mcpheartbeat.com/badge/io.github.sunholo-data/parse.svg)](https://mcpheartbeat.com/s/io.github.sunholo-data/parse)

<a href="https://mcpheartbeat.com/s/io.github.sunholo-data/parse"><img alt="MCP Heartbeat" src="https://mcpheartbeat.com/badge/io.github.sunholo-data/parse.svg"></a>

[![MCP Heartbeat uptime](https://mcpheartbeat.com/badge/io.github.sunholo-data/parse.svg?kind=uptime)](https://mcpheartbeat.com/s/io.github.sunholo-data/parse)

Served from https://mcpheartbeat.com.

Same function and industry, ranked by checks passed then median latency.

• Responded15 / 22 checks passed

  GEML — a plain-text document format built to be edited in place, one section at a time

  geml-specVerified

  One section in, one section out — on Markdown/GEML files, bad writes refused.

  Developer ToolsFile & docs

  • Productivity & docs

  • Handshake
  • Tools listed
  • Updated recently

  Median latency 70 ms · Last checked 15 hr ago

• Responded15 / 22 checks passed

  Badabun

  badabun.comVerified

  Notas de Badabun (medio digital mexicano): últimas, búsqueda, lectura en Markdown y secciones.

  Developer ToolsFile & docs

  • Handshake
  • Tools listed
  • Updated recently

  Median latency 73 ms · Last checked 15 hr ago

• Responded15 / 22 checks passed

  TanStarter Docs

  MkFastHQVerified

  Search published TanStarter documentation. Read-only and public.

  Developer ToolsFile & docs

  • Search & web data
  • Productivity & docs

  • Handshake
  • Tools listed
  • Updated recently

  Median latency 78 ms · Last checked 15 hr ago

• Responded15 / 22 checks passed

  NanoParse

  nanoparse-devVerified

  Clean Markdown from any URL with Litmus trust signals. $0.005 per page via x402, no account.

  Developer ToolsFile & docs

  • Finance & payments

  • Handshake
  • Tools listed
  • Updated recently

  Median latency 81 ms · Last checked 15 hr ago

• Responded15 / 22 checks passed

  jotview

  jotbinsVerified

  Turn markdown and Mermaid diagrams into rendered jotbins.com links, and read them back.

  Developer ToolsFile & docs

  • Handshake
  • Tools listed
  • Updated recently

  Median latency 92 ms · Last checked 15 hr ago

• Responded15 / 22 checks passed

  Polyxd

  polyxd.comVerified

  Write Polyxd UI documents, check them, and show them as real screens in any design-system pack.

  Developer ToolsFile & docs

  • Design & media

  • Handshake
  • Tools listed
  • Updated recently

  Median latency 101 ms · Last checked 15 hr ago