AILANG Parse

 ⟨16 unchanged words⟩ file button. The card uploads the file and parsestries itto intosummarise blocksit
automatically,for thenyou; handseither way you get its fileRef. Then call mcpParse with that
fileRef for the result.content Use(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 ⟨6 unchanged words⟩ 

 ⟨39 unchanged words⟩ 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 ⟨16 unchanged words⟩ 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  ⟨31 unchanged words⟩ 

 ⟨7 unchanged words⟩ ,"contentEncoding":{"type":"string"},"file":{"additionalProperties":false,"properties":{"download_url":{"type":"string"},"file_id":{"type":"string"},"file_name":{"type":"string"},"mime_type":{"type":"string"}},"required":["download_url","file_id"],"type":"object"},"fileRef":{"type":"string"},"filename":{"type":"string"},"input" ⟨12 unchanged words⟩ 

 ⟨8 unchanged words⟩  or A2UI.
Give the document ONE way:
  content + filenamefileRef: the document itself.an Textuploaded formatsfile (Markdown, HTML,
    CSVmcp-file://docparse/file_...) as plain text; binary files (DOCX,. PDF,Each PPTX,works XLSX,once.
  file: ODT,in EPUBChatGPT, ...)
    base64-encoded withthe contentEncoding="base64".file Thethe filename'suser extension
    picksattached the(ChatGPT parser,fills e.g.it "report.docx"in).
  filepath: an https:// URL of a ⟨5 unchanged words⟩ 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.
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 and parses it automatically.
  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.

 ⟨7 unchanged words⟩ ,"contentEncoding":{"type":"string"},"file":{"additionalProperties":false,"properties":{"download_url":{"type":"string"},"file_id":{"type":"string"},"file_name":{"type":"string"},"mime_type":{"type":"string"}},"required":["download_url","file_id"],"type":"object"},"fileRef":{"type":"string"},"filename":{"type":"string"},"filepath" ⟨11 unchanged words⟩ 

ViewYour AILANG Parse account: infoplan, pricingmonthly usage and limits, entitlementsyour keys, orand
whether listrequest keys.history is kept.
Actions:
  "status"  (default) → tier, quotaplan, usage from /me/entitlements
  "pricing"           → public pricingthis tiersmonth (noand authremaining required)allowance
  "keys"              → list user's APIyour keys with per-key usage
  "usage"             → alias for "keys" (per-key "usage" is shownan therealias)
  "history"           → whether request history (parsed output kept for
                        replay) is on for thisyour account
  "history_on" / "history_off" → change it for the account and all its keys
apiKey may be omitted when the request sends Authorization: Bearer <key>
or X-API-Key: <key>.
Deleting history is deliberately not an MCP action: it stays on
POST /api/v1/requests/delete and the dashboard.

ConvertCreate a document toin another format. Targetsformat: html, md, qmd, docx, pptx,
 xlsx, odt, odp, ods.ods, `input`html,
md isor aqmd. fileTo path,write a sample_idnew document, anwrite https://Markdown URL,
orand asend gs://it refas content
with filename "notes.md" (Businessheadings tierbecome slides in pptx). apiKeyTo mayconvert bean
existing omitteddocument, whengive theit request
sendsONE Authorizationway:
  content Bearer+ <key>filename: orthe X-API-Key:document <key>.

Theitself; convertedbinary filefiles comesbase64-encoded backwith
    contentEncoding="base64", text as base64plain intext.
  input: thean JSONhttps:// responseURL ratherof than
writtena topublicly diskreachable document, soor decodea `content`sample toid
    from getmcpFormats.
The result carries download_url, a link to the bytes.generated `outputPath`file is
acceptedvalid butfor ignored;one
hour: give it staysto inthe user. It also carries the signaturefile becauseas removingbase64 itin wouldcontent
change the(encoding auto-generated"base64"; MCPtext toolformats schemacome forback existingas clients.utf8).

{"properties":{"apiKey":{"type":"string"},"content":{"type":"string"},"contentEncoding":{"type":"string"},"filename":{"type":"string"},"input":{"type":"string"},"outputFormat" ⟨3 unchanged words⟩ {"type":"string"}},"required":["input","outputFormat"],"type":"object"}

Supported formats,What samples,AILANG andParse servicecan capabilities.read Noand authwrite, required.
Delegateshow to package implementation. Single source of truth lives in
pkg/sunholo/ailang_parse/services/mcp/tools — since ailang_parse 0.39.x the
responsesend carriesit a runtime capability block (state, not intent)document, whichand isthe
why this is no longersample pure:documents ityou readscan envtry andwithout probesone. theNo runtimesign-in (Process).needed.

Parse a document.document Acceptsinto astructured fileblocks, pathMarkdown, HTML or sample_idA2UI.
Give the document ONE way:
  content + filename: the document itself. Text formats (e.g.Markdown, "sample_docx_formatting"HTML,
    CSV).
The hostedas serverplain requirestext; abinary validfiles dp_(DOCX, APIPDF, keyPPTX, —XLSX, getODT, oneEPUB, via...)
    base64-encoded mcpAuth.
apiKeywith maycontentEncoding="base64". beThe omittedfilename's whenextension
    picks the requestparser, sendse.g. Authorization"report.docx".
  filepath: Beareran <key>
https:// URL of a publicly reachable document, or X-API-Key:a <key>.
Outputsample formatsid
    from mcpFormats such as "sample_docx_formatting".
outputFormat: blocks (default), markdown, html, a2ui.
requestId is reserved for future replay support.

{"properties":{"apiKey":{"type":"string"},"filepathcontent":{"type":"string"},"outputFormatcontentEncoding":{"type":"string"},"requestIdfilename":{"type":"string"}},"requiredfilepath":[{"filepathtype":"string"},"outputFormat":{"type":"string"},"requestId":{"type":"string"}},"required":[],"type":"object"}

{"destructiveHint":false,"idempotentHint":false,"openWorldHint":false,"readOnlyHint":true ⟨5 unchanged words⟩ 

{"destructiveHint":false,"idempotentHint":false,"openWorldHint":false,"readOnlyHint":true ⟨5 unchanged words⟩ 

{"destructiveHint":false,"idempotentHint":false,"openWorldHint":true,"readOnlyHint":true ⟨3 unchanged words⟩ 

 ⟨64 unchanged words⟩ it for the account and all its keys
apiKey may be omitted when the request sends Authorization: Bearer <key>
or X-API-Key: <key>.
Deleting history is deliberately not an MCP action: ⟨8 unchanged words⟩ 

 ⟨5 unchanged words⟩ {"type":"string"}},"required":["apiKey","action"],"type":"object"}

 ⟨27 unchanged words⟩ or a gs:// ref (Business tier). apiKey may be omitted when the request
sends Authorization: Bearer <key> or X-API-Key: <key>.

The converted file comes back as base64 in ⟨38 unchanged words⟩ 

 ⟨13 unchanged words⟩ "}},"required":["input","outputFormat","outputPath","apiKey"],"type":"object"}

{"properties":{"_":{"type":"string"}},"required":["_"],"type":"object"}

 ⟨18 unchanged words⟩ dp_ API key — get one via mcpAuth.
apiKey may be omitted when the request sends Authorization: Bearer <key>
or X-API-Key: <key>.
Output formats: blocks (default), markdown, html ⟨8 unchanged words⟩ 

 ⟨13 unchanged words⟩ "}},"required":["filepath","outputFormat","apiKey","requestId"],"type":"object"}