AILANG Parse is an MCP server published by io.github.sunholo-data, hosted at docparse.ailang.sunholo.com. When last checked on 2026-11-21 it was working: it answers and lists its tools. It declares 10 tools, including createUpload, editDocument, mcpAccount, mcpConvert, mcpEstimate.
Parse, convert and create Office and PDF documents. OAuth at /mcp/connect/, API key at /mcp/.
105 connections through 5 shared values. Tap any node.
Inferred from the host name and headers: what a server runs on, not who runs it.
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.
| Parameter | Type | Description |
|---|---|---|
| count | integer | |
| filename | string | |
| mimeType | string |
None yet. Changes appear after a server's second daily check.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
{
"name": "createUpload",
"title": "Create upload link",
"description": "Get one-time upload links for files in your sandbox or workspace, when you\ncan run shell commands with network access (Claude Code, Codex, a code\nsandbox). One token PER FILE: a token uploads exactly one file. For several\nfiles set count (1..20) to get that many descriptors in one call. Each\ndescriptor has a curl line: run it where the file is (replace <path>); it\nprints a receipt with a fileRef. Then call mcpParse, mcpConvert or\neditDocument with that fileRef. Tokens work once, for 10 minutes.\nIf curl fails with a network error, or the user wants to pick a file,\ncall uploadDocument instead, or ask for an https:// link. Never parse the\nfile yourself.",
"inputSchema": {
"type": "object",
"required": [],
"properties": {
"count": {
"type": "integer"
},
"filename": {
"type": "string"
},
"mimeType": {
"type": "string"
}
}
},
"annotations": {
"title": "Create upload link",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| file | object | |
| deltas | string | |
| content | string | |
| fileRef | string | |
| filename | string | |
| filepath | string | |
| contentEncoding | string |
{
"name": "editDocument",
"title": "Edit document",
"description": "Edit a document: parse it, apply a JSON array of edit deltas, and return\nthe modified blocks (same shape as mcpParse with outputFormat \"blocks\").\ndeltas \"\" or \"[]\" returns the document unchanged. Office formats only:\ndocx, pptx, xlsx, odt, odp, ods. Give the document ONE way:\n fileRef: a file the user uploaded (mcp-file://docparse/file_...).\n file: in ChatGPT, the file the user attached (ChatGPT fills it in).\n content + filename: the file base64-encoded, contentEncoding=\"base64\",\n e.g. filename \"contract.docx\".\n filepath: an https:// URL of a publicly reachable document, or a sample id\n from mcpFormats such as \"sample_docx_formatting\".\nTo get a file back, pass the edited blocks' Markdown to mcpConvert.\nWhich way to send a file:\n a file in your sandbox or workspace: call createUpload (one token PER\n FILE; set count for several) and run its curl line, then pass the\n fileRef here.\n curl fails with a network error, or the user wants to pick a file: call\n uploadDocument (the user chooses it in the AILANG Parse card). The card\n parses the file; it does not convert or edit it.\n a public https:// link; short text as content. In ChatGPT, file.\n Never parse the file yourself (your own script, or your own reading of\n it) and present that as this tool's result: if the file cannot be sent,\n tell the user.",
"inputSchema": {
"type": "object",
"required": [],
"properties": {
"file": {
"type": "object",
"required": [
"download_url",
"file_id"
],
"properties": {
"file_id": {
"type": "string"
},
"file_name": {
"type": "string"
},
"mime_type": {
"type": "string"
},
"download_url": {
"type": "string"
}
},
"additionalProperties": false
},
"deltas": {
"type": "string"
},
"content": {
"type": "string"
},
"fileRef": {
"type": "string"
},
"filename": {
"type": "string"
},
"filepath": {
"type": "string"
},
"contentEncoding": {
"type": "string"
}
}
},
"annotations": {
"title": "Edit document",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}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
| Parameter | Type | Description |
|---|---|---|
| action | string |
{
"name": "mcpAccount",
"title": "Account, quota and usage",
"description": "Your AILANG Parse account: plan, monthly usage and limits, your keys, and\nwhether request history is kept.\nActions:\n \"status\" (default) → plan, usage this month and remaining allowance\n \"keys\" → your keys with per-key usage (\"usage\" is an alias)\n \"history\" → whether request history (parsed output kept for\n replay) is on for your account\n \"history_on\" / \"history_off\" → change it for the account and all its keys",
"inputSchema": {
"type": "object",
"required": [],
"properties": {
"action": {
"type": "string"
}
}
},
"annotations": {
"title": "Account, quota and usage",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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" (in pptx the content is laid out on slides and continues onto new slides when it does not fit). 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.
| Parameter | Type | Description |
|---|---|---|
| file | object | |
| input | string | |
| content | string | |
| fileRef | string | |
| filename | string | |
| outputPath | string | |
| outputFormat * | string | |
| contentEncoding | string |
{
"name": "mcpConvert",
"title": "Convert document",
"description": "Create a document in another format: docx, pptx, xlsx, odt, odp, ods, html,\nmd or qmd. To write a new document, write Markdown and send it as content\nwith filename \"notes.md\" (in pptx the content is laid out on slides and\ncontinues onto new slides when it does not fit). To convert an\nexisting document, give it ONE way:\n fileRef: a file the user uploaded (mcp-file://docparse/file_...).\n file: in ChatGPT, the file the user attached (ChatGPT fills it in).\n content + filename: the document itself; binary files base64-encoded with\n contentEncoding=\"base64\", text as plain text.\n input: an https:// URL of a publicly reachable document, or a sample id\n from mcpFormats.\nWhich way to send a file:\n a file in your sandbox or workspace: call createUpload (one token PER\n FILE; set count for several) and run its curl line, then pass the\n fileRef here.\n curl fails with a network error, or the user wants to pick a file: call\n uploadDocument (the user chooses it in the AILANG Parse card). The card\n parses the file; it does not convert or edit it.\n a public https:// link; short text as content. In ChatGPT, file.\n Never parse the file yourself (your own script, or your own reading of\n it) and present that as this tool's result: if the file cannot be sent,\n tell the user.\nThe result carries download_url, a link to the generated file valid for one\nhour: give it to the user. It also carries the file as base64 in content\n(encoding \"base64\"; text formats come back as utf8). Leave outputPath\nempty: the server cannot write to your filesystem.",
"inputSchema": {
"type": "object",
"required": [
"outputFormat"
],
"properties": {
"file": {
"type": "object",
"required": [
"download_url",
"file_id"
],
"properties": {
"file_id": {
"type": "string"
},
"file_name": {
"type": "string"
},
"mime_type": {
"type": "string"
},
"download_url": {
"type": "string"
}
},
"additionalProperties": false
},
"input": {
"type": "string"
},
"content": {
"type": "string"
},
"fileRef": {
"type": "string"
},
"filename": {
"type": "string"
},
"outputPath": {
"type": "string"
},
"outputFormat": {
"type": "string"
},
"contentEncoding": {
"type": "string"
}
}
},
"annotations": {
"title": "Convert document",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}Estimate how long parsing takes and whether it uses AI, before you parse. filepath: a sample id from mcpFormats, such as "sample_pdf" or "sample_docx_tables". The estimate depends only on the format. No sign-in needed.
| Parameter | Type | Description |
|---|---|---|
| filepath * | string | |
| outputFormat * | string |
{
"name": "mcpEstimate",
"title": "Estimate cost and latency",
"description": "Estimate how long parsing takes and whether it uses AI, before you parse.\nfilepath: a sample id from mcpFormats, such as \"sample_pdf\" or\n\"sample_docx_tables\". The estimate depends only on the format. No sign-in\nneeded.",
"inputSchema": {
"type": "object",
"required": [
"filepath",
"outputFormat"
],
"properties": {
"filepath": {
"type": "string"
},
"outputFormat": {
"type": "string"
}
}
},
"annotations": {
"title": "Estimate cost and latency",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}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.
No parameters.
{
"name": "mcpFormats",
"title": "List formats and capabilities",
"description": "What AILANG Parse can read and write, how to send it a document, and the\nsample documents you can try without one. No sign-in needed.",
"inputSchema": {
"type": "object",
"required": [],
"properties": {}
},
"annotations": {
"title": "List formats and capabilities",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| file | object | |
| cursor | string | |
| content | string | |
| fileRef | string | |
| filename | string | |
| filepath | string | |
| maxChars | integer | |
| requestId | string | |
| pdfBackend | string | |
| outputFormat | string | |
| contentEncoding | string |
{
"name": "mcpParse",
"title": "Parse document",
"description": "Parse a document into structured blocks, Markdown, HTML or A2UI, or a short\nsummary of it.\nGive the document ONE way:\n fileRef: an uploaded file (mcp-file://docparse/file_...). The same user can\n use it again for 30 minutes after the first use (more parts, another\n format), then it is deleted.\n file: in ChatGPT, the file the user attached (ChatGPT fills it in).\n filepath: an https:// URL of a publicly reachable document, or a sample id\n from mcpFormats such as \"sample_docx_formatting\".\n content + filename: short text only (Markdown, HTML, CSV); the\n filename's extension picks the parser.\noutputFormat: blocks (default), markdown, html, a2ui, or summary (counts,\n the first 50 headings, warnings: a few KB). Look with summary first when\n a document may be large.\nLarge documents come in parts: when the result has page.nextCursor, call\n mcpParse again with the same fileRef/filepath and cursor=<nextCursor> for\n the next part; read every part before answering about the whole document.\n maxChars sets the part size in characters (default 80000,\n 2000..120000).\npdfBackend: leave empty for PDFs with a text layer. Set \"ai\" when the result\n is PDF_TEXT_LAYER_SPARSE (a scanned PDF): each page is read by an AI model,\n about 5 seconds a page, and the call counts as an AI request. Pass the same\n pdfBackend with every cursor call.\nWhich way to send a file:\n a file in your sandbox or workspace: call createUpload (one token PER\n FILE; set count for several) and run its curl line, then call this\n tool with the fileRef the upload prints.\n curl fails with a network error, or the user wants to pick a file: call\n uploadDocument; the user chooses it in the AILANG Parse card, which\n uploads it and gives you its fileRef.\n a public https:// link: filepath. Short text: content.\n Never parse the file yourself (your own script, or your own reading of\n it) and present that as this tool's result: if the file cannot be sent,\n tell the user.",
"inputSchema": {
"type": "object",
"required": [],
"properties": {
"file": {
"type": "object",
"required": [
"download_url",
"file_id"
],
"properties": {
"file_id": {
"type": "string"
},
"file_name": {
"type": "string"
},
"mime_type": {
"type": "string"
},
"download_url": {
"type": "string"
}
},
"additionalProperties": false
},
"cursor": {
"type": "string"
},
"content": {
"type": "string"
},
"fileRef": {
"type": "string"
},
"filename": {
"type": "string"
},
"filepath": {
"type": "string"
},
"maxChars": {
"type": "integer"
},
"requestId": {
"type": "string"
},
"pdfBackend": {
"type": "string"
},
"outputFormat": {
"type": "string"
},
"contentEncoding": {
"type": "string"
}
}
},
"annotations": {
"title": "Parse document",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}Send a bug report, feature request, documentation gap or limitation about AILANG to the AILANG team. Use it only when the user asks to report something, and leave out personal or confidential information. Categories: bug, feature, docs, limitation. Body up to 10 KB, snippet up to 4 KB. `contact` is optional, for a reply. `package` (vendor/name) sends the report to that AILANG package's maintainers instead. Returns a ticket ID.
| Parameter | Type | Description |
|---|---|---|
| body * | string | Full description (≤10 KB) |
| title * | string | Short title for the report |
| contact | string | Optional address for a reply. Only if the user gives one |
| package | string | Optional vendor/name (e.g. "sunholo/auth") to send the report to that package's maintainers. Empty = the AILANG team. |
| snippet | string | Optional code/error snippet (≤4 KB) |
| category * | string | bug | feature | docs | limitation |
| auto_dispatch | boolean | Let the package maintainers' automation act on the report before a person reads it. Only if the user asks. Default false: a person triages it first. |
| ailang_version * | string | The reporter's CLI version (free-form, used for triage) |
{
"name": "submit_feedback",
"title": "Send feedback",
"description": "Send a bug report, feature request, documentation gap or limitation about AILANG to the AILANG team. Use it only when the user asks to report something, and leave out personal or confidential information. Categories: bug, feature, docs, limitation. Body up to 10 KB, snippet up to 4 KB. `contact` is optional, for a reply. `package` (vendor/name) sends the report to that AILANG package's maintainers instead. Returns a ticket ID.",
"inputSchema": {
"type": "object",
"required": [
"title",
"body",
"category",
"ailang_version"
],
"properties": {
"body": {
"type": "string",
"description": "Full description (≤10 KB)"
},
"title": {
"type": "string",
"description": "Short title for the report"
},
"contact": {
"type": "string",
"description": "Optional address for a reply. Only if the user gives one"
},
"package": {
"type": "string",
"description": "Optional vendor/name (e.g. \"sunholo/auth\") to send the report to that package's maintainers. Empty = the AILANG team."
},
"snippet": {
"type": "string",
"description": "Optional code/error snippet (≤4 KB)"
},
"category": {
"type": "string",
"description": "bug | feature | docs | limitation"
},
"auto_dispatch": {
"type": "boolean",
"description": "Let the package maintainers' automation act on the report before a person reads it. Only if the user asks. Default false: a person triages it first."
},
"ailang_version": {
"type": "string",
"description": "The reporter's CLI version (free-form, used for triage)"
}
}
},
"annotations": {
"title": "Send feedback",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| outputFormat | string |
{
"name": "uploadDocument",
"title": "Upload a document",
"description": "Let the user pick a file to parse: shows the AILANG Parse card with a\nChoose file button. The card uploads the file and tries to summarise it\nfor you; either way you get its fileRef. Then call mcpParse with that\nfileRef for the content (the same user can reuse it for 30 minutes; a large\ndocument comes in parts). Use this when the user wants to pick a file, or\nwhen createUpload's curl fails with a network error. For a file already in\nyour sandbox or workspace, use createUpload + curl instead.\nNever parse the file yourself.",
"inputSchema": {
"type": "object",
"required": [],
"properties": {
"outputFormat": {
"type": "string"
}
}
},
"annotations": {
"title": "Upload a document",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| base64 * | string | |
| ticket * | string | |
| filename * | string |
{
"name": "uploadViaHost",
"title": "Receive upload from widget",
"description": "Receive a file from the AILANG Parse upload widget, relayed by the host as\nbase64. Only the widget calls this; ticket is the upload token it holds.",
"inputSchema": {
"type": "object",
"required": [
"ticket",
"filename",
"base64"
],
"properties": {
"base64": {
"type": "string"
},
"ticket": {
"type": "string"
},
"filename": {
"type": "string"
}
}
},
"annotations": {
"title": "Receive upload from widget",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}Names, descriptions and schemas were written by the server and are shown as data.
Shared addresses on big platforms (Cloudflare, Vercel and the like) put unrelated servers together; those are marked shared_infrastructure. A match is a pivot, not a link between operators.