mcp-clauses

MCP server for a searchable contract clause library. Reusable contract clauses, searched and assembled into Word.

Works with Claude Desktop, Claude Code, Cursor and any Model Context Protocol client. Runs on your own machine, or hosted with no install.

Product page: https://mcp.zovo.one/s/clauses — what it does, the tools it exposes, and a live token endpoint.

Install

Hosted, nothing to install. Get a token from https://mcp.zovo.one/mcp/connect (the connect page) or https://mcp.zovo.one/mcp/token (the same token as JSON); a free anonymous one is issued on the spot and a Pro key works the same way. Then point an MCP client at https://mcp.zovo.one/mcp/clauses over streamable-http and send the token as Authorization: Bearer <token>.

If your client cannot set headers, put the token in the path instead: https://mcp.zovo.one/mcp/clauses/t/<token>. Both forms work. The bare URL with no token answers 401 on tools/call, so the token is not optional.

Claude Desktop, one click. Download clauses.mcpb from the latest release and double-click it.

From source. The mirror is self-contained: every @theluckystrike/* dependency is vendored, so a fresh clone builds with no extra setup.

git clone https://github.com/theluckystrike/mcp-clauses.git
cd mcp-clauses
npm install && npm run build

Then point your client at the built entry point:

config.json

{
  "mcpServers": {
    "clauses": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-clauses/dist/index.js"]
    }
  }
}

@theluckystrike/mcp-clauses is not published on npm yet, so an npx -y @theluckystrike/mcp-clauses command will fail. The three paths above are the working ones and each is exercised by CI.

clauses demo

Read-only mirror of mcp-servers/servers/clauses. See MIRROR.md.

Say "draft a service agreement for Beta Corp, 4,500 EUR, 14-day terms" and get a real .docx built from your own clause library. This MCP server keeps the contract and proposal paragraphs you reuse, scope, payment terms, late fees, IP assignment, confidentiality, termination, liability cap and twenty more, as searchable clauses with {{variables}} in them. It ships with 25 generic freelance starters, finds the right ones by ranked search, fills the variables you supply, leaves every fact you did not supply as a visible bracketed prompt like [late fee percent], and writes the assembled document to Word or markdown. Every document opens with the line that it is a generic template and not legal advice. Everything runs locally: no upload, no account, no native dependency.

In the official MCP Registry (io.github.theluckystrike/contract-clause-library-proposal-template-docx).

Stop pasting last year's contract into a new file and hoping you changed every name.

60-second install

npm publish for @theluckystrike/mcp-clauses is pending. Until then, the .mcpb one-click bundle or a clone+build is the working path, both are verified below.

One-click (.mcpb): download clauses.mcpb from the latest release and double-click it in Claude Desktop: https://github.com/theluckystrike/mcp-servers/releases/latest

(claude_desktop_config.json):

config.json

{
  "mcpServers": {
    "clauses": {
      "command": "npx",
      "args": ["-y", "@theluckystrike/mcp-clauses"]
    }
  }
}

Claude Code:

Terminal

claude mcp add clauses -- npx -y @theluckystrike/mcp-clauses

(.cursor/mcp.json):

config.json

{
  "mcpServers": {
    "clauses": {
      "command": "npx",
      "args": ["-y", "@theluckystrike/mcp-clauses"]
    }
  }
}

The npx form above starts working the moment the package is published. Until then, use the .mcpb bundle above, or build from source with exactly these three commands:

git clone https://github.com/theluckystrike/mcp-servers.git && cd mcp-servers
npm install
npm run build -w packages/mcp-license -w servers/docx -w servers/clauses

Then point your client's command at node with one arg: the absolute path to servers/clauses/dist/index.js.

To run in Pro mode set MCP_LICENSE_KEY in the same config block, or call license_activate once with your key.

This is not legal advice

The 25 starter clauses are generic freelance templates written in plain language. They are not drafted for your country, your trade or your deal, and no clause here has been reviewed by a lawyer. Every starter carries the note generic template, not legal advice, and every document contract_assemble writes opens with the same line. Treat the output as a first draft to take to a qualified lawyer, not as a contract to sign.

Tools

Tool	What it does
`clause_add`	Save a reusable clause: title, body with `{{variables}}`, category, tags, optional jurisdiction and language
`clause_get`	Return one clause in full, by id or by title (a partial title matches)
`clause_update`	Change the text, category, tags, variables or jurisdiction. In Pro the previous text is kept as a version
`clause_delete`	Remove a clause. A deleted starter is not re-seeded on the next call
`clause_list`	List every clause, in assembly order, optionally narrowed to one category
`clause_search`	Ranked search over titles, tags, categories and bodies. A title match outranks a body mention; a term matches on a real word boundary ("fee" never matches inside "coffee"), with plain substring containment kept only as a lower-ranked fallback. The jurisdiction filter is free (citing a clause from the wrong jurisdiction is the error this prevents); the tag filter is Pro and is skipped, never refusing the search
`clause_import`	Bulk-load from a markdown file (`## Title`, `category:` / `tags:` lines, blank line, body) or from JSON (Pro). Only short, field-shaped lines right after the title are read as metadata, so body prose that happens to open with a word like "note:" is kept as body, not swallowed
`clause_export`	Write the whole library to markdown (free) or JSON (Pro). An existing destination is never replaced unless you pass `overwrite: true`
`contract_assemble`	Build a document from clause ids or whole categories: orders the clauses, numbers them, fills the variables, brackets what is missing, prepends the not-legal-advice line, writes `.docx` or `.md`. An existing `out_path` is never replaced unless you pass `overwrite: true`
`variables_list`	Every `{{variable}}` a selection of clauses needs, and which clause needs it, before you assemble
`license_status`	Show free or Pro mode
`license_activate`	Activate a Pro key (verified offline)

Resource: clauses://categories returns every category in the library with its clause count, in assembly order. Prompt: draft_contract picks clauses that fit an engagement, assembles them, and reports the facts still missing.

The 25 starter clauses

Category	Clauses
scope	Scope of Work, Revisions, Acceptance of Deliverables, Change Requests
payment	Payment Terms, Late Payment, Kill Fee, Rush Fee
expenses	Expenses
ip	Intellectual Property Assignment, Portfolio and Credit
confidentiality	Confidentiality
data	Data Protection
term	Termination
liability	Limitation of Liability
warranty	Warranty Disclaimer
disputes	Dispute Resolution
general	Governing Law, Force Majeure, Independent Contractor, Non-Solicitation, Notices, Entire Agreement, Severability, Assignment

They use variables such as {{client}}, {{contractor}}, {{project}}, {{fee}}, {{currency}}, {{payment_days}}, {{deposit_percent}}, {{late_fee_percent}}, {{liability_cap}}, {{notice_days}}, {{revision_rounds}}, {{acceptance_days}}, {{kill_fee_percent}}, {{rush_fee_percent}} and {{jurisdiction}}. Call variables_list with the clauses you picked to see exactly which ones your document needs.

What you can say

You say	Tool
"What clauses do I have about late payment?"	`clause_search`
"Save this as a clause called Retainer, category payment."	`clause_add`
"Draft a service agreement for Beta Corp: scope, payment, late fees, IP, termination. Fee 4,500 EUR, 14-day terms."	`contract_assemble`
"What do I still need to fill in for those five clauses?"	`variables_list`
"Import my old clauses from clauses.md."	`clause_import`
"Export the whole library so I can keep a copy."	`clause_export`

Free vs Pro

	Free	Pro
25 starter clauses	yes	yes
Your own clauses	10	unlimited
Ranked search, category filter	yes	yes
Filter by jurisdiction or tag	no	yes
Clauses per assembled document	8	unlimited
Markdown import and export	yes	yes
JSON import and export	no	yes
Clause version history on `clause_update`	no	yes

Get Pro: https://mcp.zovo.one/buy/clauses, $19 one-time, or $39 for the whole collection.

Pairs with

mcp-docx, the document engine this server assembles through. Install both and the same conversation that picks clauses can also write the covering letter and read the client's own .docx back.
mcp-invoice, the payment terms you agreed in the contract are the terms you bill on.
mcp-recurring, once a retainer clause is signed, the schedule that raises its invoices.

Privacy

Every clause and every assembled document stays on your machine, in ${XDG_DATA_HOME:-~/.local/share}/mcp-servers/clauses/. The server makes no network calls at all. Your licence key is verified offline.

Built by theluckystrike. Support: support@zovo.one

One business profile for the whole suite

Your identity is stored once, at ${XDG_DATA_HOME:-~/.local/share}/mcp-servers/profile/business.json, and every server in the suite reads it: the invoice issuer, the docx letterhead, the recurring issuer, expense-tracker's default VAT rate, time-tracker's and timezone's home zone, and the resume and contract letterheads. Set it once with business_set (invoice or docx) - you never repeat it anywhere else. An email address is only ever taken from that profile or from an explicit argument; when none is stored, documents show [add: email] and the tool says so rather than letting anyone improvise an address.

Use these docs as an MCP server

Any MCP client (Claude, Cursor, Windsurf, VS Code) can read this repository's documentation directly via GitMCP — no install:

Docs MCP URL: https://gitmcp.io/theluckystrike/mcp-clauses