io.github.theluckystrike/terms

Official12 toolsLive

by theluckystrike · JavaScript

Reusable contract terms and clauses assembled into a Word docx with variables filled.

io.github.theluckystrike/terms — Model Context Protocol (MCP) Server

This MCP server assembles reusable contract terms and clauses into a Word .docx document with variables filled. It maintains a clause library for proposals and service agreements, enabling clause search and ranked selection before generating the final document output.

🛠️ Key Features

Reusable contract terms and clauses compiled into a .docx
Variable placeholders ({{variables}}) filled from provided inputs
Ranked search to find relevant clauses from a stored library
Unprovided facts left as visible bracketed prompts like [late fee percent]

🚀 Use Cases

Drafting service agreements for a specified party and amount using reusable clauses
Reusing common proposal paragraphs (e.g., scope, payment terms, late fees, IP assignment, confidentiality, termination, liability cap)

⚡ Developer Benefits

Searchable clause library covering many common agreement sections
Standardized variable handling to parameterize templates for repeated drafting workflows

⚠️ Limitations

Output formatting details are limited to .docx generation and bracketed prompts for missing inputs
Only supplied variables are filled; missing facts remain visible as bracketed placeholders

Topics

claudecursorinvoicemcpmcp-servermodel-context-protocolspreadsheetaccountingai-toolsbookkeepingclaude-desktopfreelanceinvoicinglocal-firstmcp-serverspdfself-hostedtime-trackingvatproductivity

Captured live from the server via tools/list.

clause_add

Save a reusable contract or proposal clause to the library. Returns the stored clause id, title, category, tags and the variables detected in its body, plus how many clauses of your own the library now holds.

Parameters7

title	string	required	Clause heading, for example 'Late Payment'
body	string	required	The clause text. Use {{variable}} placeholders for the facts that change per client, for example {{client}}, {{fee}} or {{late_fee_percent}}; contract_assemble fills them at assembly time. Free tier: 10 clauses of your own on top of the 25 starters
category	string	required	Grouping. The known ones, in assembly order, are parties, scope, payment, expenses, ip, confidentiality, data, term, liability, warranty, disputes, general -- reuse one of these; any other name is accepted but sorts last in a category-based assembly
tags	array	optional
variables	array	optional	Declared variable names. Anything {{...}} in the body is detected anyway
jurisdiction	string	optional	Where the clause is meant to apply, for example 'PL' or 'England and Wales'
language	string	optional	ISO language code, default en

Raw schema

{
  "type": "object",
  "properties": {
    "title": {
      "type": "string",
      "minLength": 1,
      "description": "Clause heading, for example 'Late Payment'"
    },
    "body": {
      "type": "string",
      "minLength": 1,
      "description": "The clause text. Use {{variable}} placeholders for the facts that change per client, for example {{client}}, {{fee}} or {{late_fee_percent}}; contract_assemble fills them at assembly time. Free tier: 10 clauses of your own on top of the 25 starters"
    },
    "category": {
      "type": "string",
      "description": "Grouping. The known ones, in assembly order, are parties, scope, payment, expenses, ip, confidentiality, data, term, liability, warranty, disputes, general -- reuse one of these; any other name is accepted but sorts last in a category-based assembly"
    },
    "tags": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "variables": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Declared variable names. Anything {{...}} in the body is detected anyway"
    },
    "jurisdiction": {
      "type": "string",
      "description": "Where the clause is meant to apply, for example 'PL' or 'England and Wales'"
    },
    "language": {
      "type": "string",
      "description": "ISO language code, default en"
    }
  },
  "required": [
    "title",
    "body",
    "category"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

clause_get

Return one clause in full by id or title: body, category, tags, jurisdiction, variables and the revision count, which stays 0 on free. A partial title matching several is refused with the candidates.

Parameters2

id	string	optional	Clause id, for example late-fees
title	string	optional	Clause title; a partial title matches too

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Clause id, for example late-fees"
    },
    "title": {
      "type": "string",
      "description": "Clause title; a partial title matches too"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

clause_update

Change the text, category, tags, variables or jurisdiction of a clause. In Pro the previous text is kept as a version; in the free tier the change is applied without history.

Parameters8

id	string	required	Clause id or exact title
title	string	optional
body	string	optional
category	string	optional
tags	array	optional
variables	array	optional
jurisdiction	string	optional
language	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Clause id or exact title"
    },
    "title": {
      "type": "string"
    },
    "body": {
      "type": "string"
    },
    "category": {
      "type": "string"
    },
    "tags": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "variables": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "jurisdiction": {
      "type": "string"
    },
    "language": {
      "type": "string"
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

clause_delete

Delete one clause by id or exact title and report how many are left. There is no undo, and a deleted starter clause is not re-seeded. Use clause_update to change one you want to keep.

Parameters1

string

required

Clause id or exact title

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Clause id or exact title"
    }
  },
  "required": [
    "id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

clause_list

List the library as id, title, category, tags and variables, in contract order by category then title, which is the order contract_assemble uses. Narrow with category; use clause_search for words.

Parameters1

clause_search

Ranked search over clause titles, tags, categories and bodies. Title and tag matches outrank body matches. Jurisdiction filtering is free; the tag filter is Pro and is skipped rather than refusing the search.

Parameters4

query	string	required	Words to look for, for example 'late payment interest'
category	string	optional
tags	array	optional	Pro: every tag listed must be present. On free the search still runs, without this filter
jurisdiction	string	optional	Exact jurisdiction match. Free

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Words to look for, for example 'late payment interest'"
    },
    "category": {
      "type": "string"
    },
    "tags": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Pro: every tag listed must be present. On free the search still runs, without this filter"
    },
    "jurisdiction": {
      "type": "string",
      "description": "Exact jurisdiction match. Free"
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

clause_import

Call this tool to load clauses from a .md or .json file, reporting added, replaced, skipped and capped counts. A duplicate title is skipped unless overwrite. json is Pro. Free: 10 of your own.

Parameters2

path	string	required	Path to a .md or .json file. Markdown form: '## Title', then optional 'category:' / 'tags:' / 'variables:' lines, a blank line, then the body. JSON form: an array of clauses. JSON import is a Pro feature; markdown import works in the free tier, within the free clause cap
overwrite	boolean	optional	Replace clauses whose title already exists instead of skipping them

Raw schema

{
  "type": "object",
  "properties": {
    "path": {
      "type": "string",
      "description": "Path to a .md or .json file. Markdown form: '## Title', then optional 'category:' / 'tags:' / 'variables:' lines, a blank line, then the body. JSON form: an array of clauses. JSON import is a Pro feature; markdown import works in the free tier, within the free clause cap"
    },
    "overwrite": {
      "type": "boolean",
      "description": "Replace clauses whose title already exists instead of skipping them"
    }
  },
  "required": [
    "path"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

clause_export

Call this tool to write the whole library to one file and return the path, format and count. It is written in contract order, so it re-imports the same way. markdown is free; json is Pro.

Parameters3

path	string	required	Destination file path. The clauses are written in assembly order, categories first
format	string	required	json (a Pro feature) or markdown (works in the free tier)
overwrite	boolean	optional	Replace the destination if a file is already there. Without it an existing file is never touched

Raw schema

{
  "type": "object",
  "properties": {
    "path": {
      "type": "string",
      "description": "Destination file path. The clauses are written in assembly order, categories first"
    },
    "format": {
      "type": "string",
      "enum": [
        "json",
        "markdown"
      ],
      "description": "json (a Pro feature) or markdown (works in the free tier)"
    },
    "overwrite": {
      "type": "boolean",
      "description": "Replace the destination if a file is already there. Without it an existing file is never touched"
    }
  },
  "required": [
    "path",
    "format"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

contract_assemble

Call this tool to build a contract from library clauses as .docx or markdown. A variable you omit stays as a bracketed prompt, never invented. clause_ids order is document order. Free: 8 clauses.

Parameters8

title	string	required	Document title, for example 'Service Agreement - Beta Corp'
clause_ids	array	optional	Clause ids in the order they should appear; this is the document order. Free tier: up to 8 clauses per document
categories	array	optional	Instead of ids: every clause in these categories, ordered by category. Free tier: up to 8 clauses per document
values	object	optional	Values for the {{variables}} in the chosen clauses, for example {"fee":"4500","late_fee_percent":"2"}. Any variable you leave out stays in the document as a bracketed prompt such as [late fee percent], never as an invented value
client	string	optional	Client name; also fills the {{client}} variable
out_path	string	optional	Where to write the file. Default: the server data directory, under a name built from the client and the title
format	string	optional	docx (default) or markdown; the document opens with the not-legal-advice line either way
overwrite	boolean	optional	Replace out_path if a file is already there. Without it an existing file is never touched

Raw schema

{
  "type": "object",
  "properties": {
    "title": {
      "type": "string",
      "description": "Document title, for example 'Service Agreement - Beta Corp'"
    },
    "clause_ids": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Clause ids in the order they should appear; this is the document order. Free tier: up to 8 clauses per document"
    },
    "categories": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Instead of ids: every clause in these categories, ordered by category. Free tier: up to 8 clauses per document"
    },
    "values": {
      "type": "object",
      "additionalProperties": {
        "type": "string"
      },
      "description": "Values for the {{variables}} in the chosen clauses, for example {\"fee\":\"4500\",\"late_fee_percent\":\"2\"}. Any variable you leave out stays in the document as a bracketed prompt such as [late fee percent], never as an invented value"
    },
    "client": {
      "type": "string",
      "description": "Client name; also fills the {{client}} variable"
    },
    "out_path": {
      "type": "string",
      "description": "Where to write the file. Default: the server data directory, under a name built from the client and the title"
    },
    "format": {
      "type": "string",
      "enum": [
        "docx",
        "markdown"
      ],
      "description": "docx (default) or markdown; the document opens with the not-legal-advice line either way"
    },
    "overwrite": {
      "type": "boolean",
      "description": "Replace out_path if a file is already there. Without it an existing file is never touched"
    }
  },
  "required": [
    "title"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

variables_list

List every {{variable}} the clauses you name use, and which clause uses each, so the facts are gathered before contract_assemble leaves bracketed prompts. Reads only; a title matching several is refused.

Parameters1

clause_ids

array

required

Clause ids or titles

Raw schema

{
  "type": "object",
  "properties": {
    "clause_ids": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "minItems": 1,
      "description": "Clause ids or titles"
    }
  },
  "required": [
    "clause_ids"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

license_status

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.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

license_activate

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.

Parameters1

key

string

required

License key from checkout, MCPL1.<payload>.<signature>

Raw 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#"
}

servers/clauses/README.md9 KBView on GitHub

mcp-clauses

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).

clauses demo

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):

json

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

Claude Code:

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

(.cursor/mcp.json):

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

Install

Tools (12)

clause_addclause_getclause_updateclause_deleteclause_listclause_searchclause_importclause_export

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://mcp.zovo.one/mcp/terms

Configuration

Environment variables

MCP_LICENSE_KEYsecret

Optional Pro license key (MCPL1....). Verified offline.

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "terms": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.zovo.one/mcp/terms"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

io.github.theluckystrike/terms — Model Context Protocol (MCP) Server

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

clause_add

clause_get

clause_update

clause_delete

clause_list

clause_search

clause_import

clause_export

contract_assemble

variables_list

license_status

license_activate

mcp-clauses

60-second install

This is not legal advice

Tools

The 25 starter clauses

What you can say

Free vs Pro

Pairs with

Privacy

One business profile for the whole suite

Use these docs as an MCP server

Install

Remote endpoint

Configuration

Related servers