{"openapi":"3.1.0","info":{"title":"mddocx","summary":"Convert a Word .docx into a zip with clean markdown, images, and inline comments.","description":"Single-purpose service. Upload a `.docx`; receive a `.zip` containing\n`report.md` (body in GitHub-flavored markdown, including tables and lists),\n`media/` (every embedded image), and `comments/cN.md` (one per Word comment).\nComments are also embedded inline in `report.md` as collapsible `<details>` blocks.\n\nSurfaces:\n- `POST /convert` — multipart upload, returns zip (REST).\n- `*    /mcp/`    — MCP streamable HTTP transport with one tool `convert_docx`,\n                    suitable for Cursor / Claude Desktop / any MCP client.\n- `GET  /`        — drag-and-drop browser UI.","version":"0.1.0"},"paths":{"/health":{"get":{"tags":["meta"],"summary":"Liveness probe","operationId":"health_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":{"type":"string"},"type":"object","title":"Response Health Health Get"}}}}}}},"/convert":{"post":{"tags":["convert"],"summary":"Convert a .docx file to a zip with markdown, media, and comments","operationId":"convert_endpoint_convert_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_convert_endpoint_convert_post"}}},"required":true},"responses":{"200":{"description":"ZIP archive named `<basename>.zip` containing `report.md`, `media/`, and (if any) `comments/cN.md`. Conversion stats are returned in the `X-Mddocx-Stats` response header as a compact JSON string (totals for comments and media).","content":{"application/zip":{}}},"400":{"description":"Invalid input (wrong extension, empty file, too large)"},"500":{"description":"Conversion failed (pandoc or parsing error)"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"Body_convert_endpoint_convert_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File","description":"A `.docx` file. Maximum size 50 MB."}},"type":"object","required":["file"],"title":"Body_convert_endpoint_convert_post"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}}}