{"name":"io.github.theluckystrike/docx-document-generator-proposal-contract-markdown","slug":"theluckystrike-docx-document-generator-proposal-contract-markdown","title":null,"description":"Create real Word .docx files from your AI chat: proposals, quotes, contracts, statements of work.","url":"https://mcp.market/server/theluckystrike-docx-document-generator-proposal-contract-markdown","grade":"C","score":64,"certified":false,"status":"active","category":"other","tags":[],"transport":"mixed","callable_via_gateway":true,"default_price_micros":0,"repository":"https://github.com/theluckystrike/mcp-servers","website":"https://mcp.zovo.one/s/docx","version":"0.22.0","remotes":[{"type":"streamable-http","url":"https://mcp.zovo.one/mcp/docx","headers":[{"description":"Bearer <Pro license key or anonymous token from GET https://mcp.zovo.one/mcp/token>","isRequired":true,"isSecret":true,"name":"Authorization"}]}],"packages":[{"registryType":"mcpb","identifier":"https://github.com/theluckystrike/mcp-servers/releases/download/v0.22.0/docx.mcpb","version":"0.22.0","fileSha256":"e262dd6161bae677b33015fd94f0f9fae5f314c94f5963059ff87ed26a15df4f","transport":{"type":"stdio"},"environmentVariables":[{"description":"Optional Pro license key (MCPL1....). Verified offline.","isSecret":true,"name":"MCP_LICENSE_KEY"}]}],"tools":[{"name":"business_set","description":"Store the sender details printed on every proposal, contract and letter, plus the currency, VAT, terms and prefix defaults. It writes the SAME shared profile as the invoice server's business_set.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"name":{"type":"string","description":"Your business or freelancer name, printed on the letterhead of every proposal, contract and letter"},"address":{"type":"string","description":"Postal address, newlines allowed"},"email":{"type":"string","description":"Your own email address, printed on every letterhead. Leave it out unless the user gave it: a document that shows an address nobody supplied is worse than one that shows [add: email]"},"phone":{"type":"string","description":"Your own phone number. Same rule as email: only if the user gave it"},"timezone":{"type":"string","description":"IANA zone you work in, e.g. Europe/Warsaw. Shared with time-tracker and timezone as your home zone"},"vat_id":{"type":"string","description":"VAT / tax registration id"},"iban":{"type":"string","description":"IBAN or account number for payment"},"bank":{"type":"string","description":"Bank name / BIC"},"logo_path":{"type":"string","description":"Path to a PNG or JPG logo for the letterhead (Pro)"},"brand_color":{"type":"string","description":"Letterhead colour as a hex code, e.g. 1F3864 (Pro)"},"default_currency":{"type":"string","pattern":"^[A-Za-z]{3}$","description":"ISO code, e.g. EUR, USD. Default EUR"},"default_tax_rate":{"type":"number","description":"Default VAT percent, quoted on proposals"},"payment_terms_days":{"type":"number","description":"Default days until payment is due. Default 14"},"invoice_prefix":{"type":"string","description":"Reference prefix used by mcp-invoice; this profile has the same field shape as mcp-invoice, so one profile serves both"},"tax_rate":{"type":"number","description":"Alias for default_tax_rate"},"vat_rate":{"type":"number","description":"Alias for default_tax_rate"},"vat":{"type":"number","description":"Alias for default_tax_rate"}},"required":["name"],"additionalProperties":true,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"contract_create","description":"Call this tool to produce a freelance service agreement .docx. Returns the reference, the fee and the file path. It is a template skeleton for a lawyer to review, not legal advice. Free tier: 3 agreements per month.","write_action":true,"price_micros":0,"input_schema":{"type":"object","properties":{"client":{"type":"string","description":"The client's legal name"},"services":{"type":"string","description":"What you will do, one or two sentences. The document adds parties, term, fee and schedule, plus standard clauses on intellectual property, confidentiality, independent contractor status, liability, termination and governing law"},"start_date":{"type":"string","description":"YYYY-MM-DD"},"end_date":{"type":"string","description":"YYYY-MM-DD, omit for an open-ended engagement"},"fee":{"type":"object","properties":{"amount":{"type":"number"},"currency":{"type":"string","pattern":"^[A-Za-z]{3}$"},"schedule":{"type":"string","description":"e.g. 'monthly in arrears' or '50% up front'"}},"required":["amount","schedule"],"additionalProperties":false},"governing_law":{"type":"string","description":"e.g. 'the laws of Poland'"},"clauses":{"type":"array","items":{"type":"string"},"description":"Extra clauses to append, one paragraph each"},"out_path":{"type":"string","description":"Where to write the .docx. Defaults to the data directory"},"overwrite":{"type":"boolean","description":"Replace out_path if a file is already there. Default false: an existing file is never overwritten"}},"required":["client","services","start_date","fee"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"doc_create","description":"Call this tool to write a real .docx file from structured sections. Returns the file path, the number of blocks written and the layout used. Free and unlimited.","write_action":true,"price_micros":0,"input_schema":{"type":"object","properties":{"title":{"type":"string","description":"Document title, used as the top heading and the file name"},"sections":{"type":"array","items":{"type":"object","properties":{"heading":{"type":"string","description":"Section heading"},"level":{"type":"integer","minimum":1,"maximum":6,"description":"Heading level, default 2"},"paragraphs":{"type":"array","items":{"type":"string"},"description":"Body paragraphs. **bold**, *italic* and `code` are honoured"},"bullets":{"type":"array","items":{"type":"string"},"description":"Bullet list items"},"numbered":{"type":"array","items":{"type":"string"},"description":"Numbered list items"},"table":{"type":"object","properties":{"headers":{"type":"array","items":{"type":"string"}},"rows":{"type":"array","items":{"type":"array","items":{"type":"string"}}}},"required":["headers","rows"],"additionalProperties":false,"description":"A table: one header row plus rows of cells"}},"additionalProperties":false},"description":"Sections in order. Each one may carry a heading, paragraphs, a bullet or numbered list and a table"},"out_path":{"type":"string","description":"Where to write the .docx. Defaults to the data directory"},"style":{"type":"string","enum":["plain","letter","proposal"],"description":"Layout, default plain. plain is the title and the body; letter adds a sender block top right, a date and the addressee; proposal adds a letterhead band and a cover title"},"recipient":{"type":"string","description":"Addressee block for the letter layout"},"date":{"type":"string","description":"Date line for the letter layout, default today"},"overwrite":{"type":"boolean","description":"Replace out_path if a file is already there. Default false: an existing file is never overwritten"}},"required":["title","sections"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"doc_delete_upload","description":"Delete one document uploaded for your token: name is the name it was uploaded under, without .docx. doc_files lists them. A name nothing is stored under is refused and nothing is deleted.","write_action":true,"price_micros":0,"input_schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":70}},"required":["name"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"doc_files","description":"List the documents uploaded for your token, with their sizes.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{},"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"doc_fill_template","description":"Call this tool to replace {{placeholders}} in a .docx and write a new file, reporting what was filled, unfilled or ignored. Call it with no values to list them. Free: templates up to 10 placeholders.","write_action":true,"price_micros":0,"input_schema":{"type":"object","properties":{"template_path":{"type":"string","description":"Name of a template uploaded with doc_upload"},"docx_base64":{"type":"string","description":"The .docx template itself, base64-encoded, instead of uploading it first"},"values":{"type":"object","additionalProperties":{"type":["string","number","boolean"]},"description":"Placeholder name to value, e.g. {client: \"Acme\", fee: \"EUR 4,500.00\"}"},"out_path":{"type":"string","description":"Where to write the filled .docx. Defaults to <template>-filled.docx"},"overwrite":{"type":"boolean","description":"Replace out_path if a file is already there. Default false: an existing file is never overwritten"}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"doc_from_markdown","description":"Call this tool to turn markdown into a .docx, returning the file and a count of blocks by type. Headings, lists, GFM tables and code fences are honoured. Empty markdown is refused, and so is overwriting without the flag.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"markdown":{"type":"string","description":"The markdown source. ATX headings, paragraphs, bullet and numbered lists, GFM pipe tables and fenced code blocks as monospace are honoured, as are **bold**, *italic* and `code` inline"},"out_path":{"type":"string","description":"Where to write the .docx. Defaults to the data directory"},"title":{"type":"string","description":"Document title; defaults to the first heading in the markdown"},"style":{"type":"string","enum":["plain","letter","proposal"]},"overwrite":{"type":"boolean","description":"Replace out_path if a file is already there. Default false: an existing file is never overwritten"}},"required":["markdown"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"doc_read","description":"Call this tool to extract the text of an existing .docx. Returns an outline of the headings and the full text in document order, or the block structure. Free and unlimited.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"path":{"type":"string","description":"Name of a document uploaded with doc_upload"},"docx_base64":{"type":"string","description":"The .docx itself, base64-encoded, instead of uploading it first"},"format":{"type":"string","enum":["text","json"],"description":"text (default) returns the readable text, json returns the block structure in document order"}},"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"doc_to_html","description":"Call this tool to convert a .docx to semantic HTML you can open in a browser and print to PDF. Returns the path of the .html file. This is the supported PDF route; no PDF is rendered here. Free and unlimited.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"path":{"type":"string","description":"Name of a document uploaded with doc_upload, or a document this server just wrote"},"out_path":{"type":"string","description":"Name for the downloaded .html file"},"overwrite":{"type":"boolean","description":"Replace out_path if a file is already there. Default false: an existing file is never overwritten"}},"required":["path"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"doc_upload","description":"Send an existing Word document to this hosted endpoint. There is no filesystem here, so instead of a path you upload the file once with doc_upload and then pass its name as `path` to doc_read, doc_to_html and doc_fill_template. Give exactly one of docx_base64 or url. url: fetch a public file instead of pasting base64 (recommended above about 10 KB): a 13 KB base64 paste can take minutes to write out, while a url costs one line and the fetch happens here (10 second timeout, at most 3 redirects, public http(s) hosts only, 2 MB cap). Uploads are kept for your token between calls; doc_read and doc_fill_template also take docx_base64 directly; that file is stored under the name you give (default 'inline' / 'template') and can be removed with doc_delete_upload. Documents this server writes come back as a download link valid for one hour.","write_action":true,"price_micros":0,"input_schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":70,"description":"Name to refer to this document by: 1-64 characters of letters, digits, underscore or dash, e.g. \"contract\""},"docx_base64":{"type":"string","description":"The .docx file, base64-encoded"},"url":{"type":"string","description":"url: fetch a public file instead of pasting base64 (recommended above about 10 KB). Public http(s) only; private, link-local and this endpoint's own zone are refused"}},"required":["name"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"license_activate","description":"Turn Pro on for this connection with key, an MCPL1.<payload>.<signature> issued at checkout for this server or the bundle. Data under your token stays; a wrong or expired key changes nothing. license_status confirms it.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{"key":{"type":"string","description":"License key from checkout, MCPL1.<payload>.<signature>"}},"required":["key"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"license_status","description":"Report this endpoint's licence state for your token as JSON: the product, the tier free or pro, why it is not Pro, and the checkout URL. Call it to explain a free-tier refusal. No arguments, nothing changes.","write_action":false,"price_micros":0,"input_schema":{"type":"object","properties":{},"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"proposal_create","description":"Call this tool to produce a client-ready .docx proposal from summary, scope, deliverables, timeline, price and terms. Returns the reference, the total and the file path. Free tier: 3 proposals or contracts per month.","write_action":true,"price_micros":0,"input_schema":{"type":"object","properties":{"client":{"type":"string","description":"Client name, printed as 'Prepared for'. The letterhead comes from your business_set profile"},"project_title":{"type":"string","description":"Project title"},"summary":{"type":"string","description":"One or two paragraphs on the problem and the approach. Omitted from the document if not given"},"scope":{"type":"array","items":{"type":"string"},"description":"What is in scope, one bullet each. Omitted from the document if not given or empty"},"deliverables":{"type":"array","items":{"type":"string"},"description":"What the client receives, one bullet each. Omitted from the document if not given or empty"},"timeline":{"type":"array","items":{"type":"object","properties":{"phase":{"type":"string"},"duration":{"type":"string","description":"e.g. '2 weeks'"}},"required":["phase","duration"],"additionalProperties":false},"description":"Phases and their durations, rendered as a table. Omitted from the document if not given or empty"},"price":{"type":"object","properties":{"amount":{"type":"number","description":"Total price in major units, e.g. 4500"},"currency":{"type":"string","pattern":"^[A-Za-z]{3}$"},"terms":{"type":"string","description":"e.g. '50% on signature, 50% on delivery'"}},"required":["amount"],"additionalProperties":false},"valid_until":{"type":"string","description":"YYYY-MM-DD, the date the quote expires"},"out_path":{"type":"string","description":"Where to write the .docx. Defaults to the data directory"},"overwrite":{"type":"boolean","description":"Replace out_path if a file is already there. Default false: an existing file is never overwritten"}},"required":["client","project_title","price"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}},{"name":"proposal_update","description":"Rewrite an existing proposal in place from its reference. Only the fields you pass change; the rest comes from the data stored at creation. Returns the fields that changed and the file path.","write_action":true,"price_micros":0,"input_schema":{"type":"object","properties":{"reference":{"type":"string","description":"The proposal reference, e.g. PROP-2026-0001. The same file and the same reference number are kept, so no second document is burned against the free-tier monthly count"},"client":{"type":"string"},"project_title":{"type":"string"},"summary":{"type":"string"},"scope":{"type":"array","items":{"type":"string"}},"deliverables":{"type":"array","items":{"type":"string"}},"timeline":{"type":"array","items":{"type":"object","properties":{"phase":{"type":"string"},"duration":{"type":"string"}},"required":["phase","duration"],"additionalProperties":false}},"price":{"type":"object","properties":{"amount":{"type":"number"},"currency":{"type":"string","pattern":"^[A-Za-z]{3}$"},"terms":{"type":"string"}},"required":["amount"],"additionalProperties":false},"valid_until":{"type":"string"}},"required":["reference"],"additionalProperties":false,"$schema":"http://json-schema.org/draft-07/schema#"}}],"scan":{"score":64,"grade":"C","scanned_at":"2026-09-17T16:32:00.902Z","report":{"scannerVersion":"0.1.2","scannedAt":"2026-09-17T16:32:00.833Z","components":{"code":{"score":-1,"max":25,"notes":["package could not be scanned"]},"reliability":{"score":20,"max":20,"notes":["remote reachable in 297ms"]},"poisoning":{"score":15,"max":15,"notes":["14 tool descriptions checked"]},"auth":{"score":8,"max":15,"notes":["API key sent as a header"]},"maintenance":{"score":3,"max":15,"notes":["repository not readable: github 401"]},"identity":{"score":2,"max":10,"notes":["no repository or website to verify"]}},"findings":[],"inputs":{"probes":[{"url":"https://mcp.zovo.one/mcp/docx","reachable":true,"authRequired":false,"latencyMs":297,"serverInfo":{"name":"mcp-docx","version":"0.22.0"}}],"packages":[],"repo":{"found":false,"owner":"theluckystrike","repo":"mcp-servers","error":"github 401"}}}},"grade_history":[]}