io.github.theluckystrike/bill-of-sale

Official10 toolsLive

by theluckystrike · JavaScript

Bills of sale for equipment, vehicles and stock: draft, finalize, print with signature lines.

io.github.theluckystrike/bill-of-sale (MCP) Server

The MCP server provides bills of sale for equipment, vehicles, and stock. It supports drafting, finalizing, and printing documents, including signature lines, based on the server description.

🛠️ Key Features

Bills of sale for equipment
Bills of sale for vehicles
Bills of sale for stock
Draft bills of sale
Finalize bills of sale
Print bills of sale with signature lines

🚀 Use Cases

Preparing documentation to transfer ownership of equipment
Creating bills of sale for vehicle transactions
Documenting stock-related sales using a bill of sale format

⚡ Developer Benefits

Clear document workflow: draft → finalize → print
Consistent inclusion of signature lines for execution

⚠️ Limitations

Scope is limited to bills of sale for equipment, vehicles, and stock, as described

Topics

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

Captured live from the server via tools/list.

sale_create

Record a sale and generate the bill of sale: who sold, who bought, what item (with VIN, serial or IMEI where it has one), the price in minor units and the date. Returns the BOS-YYYY-NNNN number of the draft. The draft can still be changed with sale_update; sale_finalize freezes it into the signing copy and sale_render prints it. Free tier: 10 drafts.

Parameters23

buyer_name	string	required	Who is buying, e.g. Jane Kowalska or Northwind Sp. z o.o.
buyer_address	string	optional	The buyer's postal address, one string
buyer_email	string	optional	The buyer's email
buyer_phone	string	optional	The buyer's phone number
seller_name	string	optional	Who is selling. Defaults to the shared business profile's name when the profile has one
seller_address	string	optional	The seller's postal address, one string
seller_email	string	optional	The seller's email
seller_phone	string	optional	The seller's phone number
item_description	string	required	What was sold, specific enough to identify it, e.g. 2019 Honda Civic 1.5 petrol, grey, or MacBook Pro 14-inch 2021
item_category	string	optional	What kind of item, e.g. vehicle, equipment, electronics, stock
vin	string	optional	Vehicle Identification Number, 17 characters, for a vehicle sale
serial	string	optional	Serial number, for equipment and electronics
imei	string	optional	IMEI, 15 digits, for a phone or tablet
identifier_other	string	optional	Any other identifying number, e.g. a hull number or an asset tag
quantity	integer	optional	How many units this document covers. Default 1
condition	string	optional	The condition at handover, e.g. used, good working order, or new, sealed
price_minor	integer	required	The sale price in whole minor units (integer cents). 120000 is USD 1,200.00
currency	string	required	ISO code the price is in
date	string	optional	The date of the sale, YYYY-MM-DD. Default today
as_is	boolean	optional	Include the as-is clause: sold with all faults, no warranties except any written here. Default true, the norm for second-hand sales; pass false to leave it out
warranty	string	optional	A warranty the seller does give, in their own words, e.g. The seller warrants the engine for 30 days from the sale date
notes	string	optional	Anything else the document should say, e.g. payment method or what is included in the sale
duplicate_ok	boolean	optional	Record it even though an identical sale to the same buyer exists, for a genuinely repeated sale. Default false

Raw schema

{
  "type": "object",
  "properties": {
    "buyer_name": {
      "type": "string",
      "maxLength": 200,
      "description": "Who is buying, e.g. Jane Kowalska or Northwind Sp. z o.o."
    },
    "buyer_address": {
      "type": "string",
      "maxLength": 4000,
      "description": "The buyer's postal address, one string"
    },
    "buyer_email": {
      "type": "string",
      "maxLength": 200,
      "description": "The buyer's email"
    },
    "buyer_phone": {
      "type": "string",
      "maxLength": 200,
      "description": "The buyer's phone number"
    },
    "seller_name": {
      "type": "string",
      "maxLength": 200,
      "description": "Who is selling. Defaults to the shared business profile's name when the profile has one"
    },
    "seller_address": {
      "type": "string",
      "maxLength": 4000,
      "description": "The seller's postal address, one string"
    },
    "seller_email": {
      "type": "string",
      "maxLength": 200,
      "description": "The seller's email"
    },
    "seller_phone": {
      "type": "string",
      "maxLength": 200,
      "description": "The seller's phone number"
    },
    "item_description": {
      "type": "string",
      "maxLength": 4000,
      "description": "What was sold, specific enough to identify it, e.g. 2019 Honda Civic 1.5 petrol, grey, or MacBook Pro 14-inch 2021"
    },
    "item_category": {
      "type": "string",
      "maxLength": 200,
      "description": "What kind of item, e.g. vehicle, equipment, electronics, stock"
    },
    "vin": {
      "type": "string",
      "maxLength": 40,
      "description": "Vehicle Identification Number, 17 characters, for a vehicle sale"
    },
    "serial": {
      "type": "string",
      "maxLength": 200,
      "description": "Serial number, for equipment and electronics"
    },
    "imei": {
      "type": "string",
      "maxLength": 20,
      "description": "IMEI, 15 digits, for a phone or tablet"
    },
    "identifier_other": {
      "type": "string",
      "maxLength": 200,
      "description": "Any other identifying number, e.g. a hull number or an asset tag"
    },
    "quantity": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100000,
      "description": "How many units this document covers. Default 1"
    },
    "condition": {
      "type": "string",
      "maxLength": 200,
      "description": "The condition at handover, e.g. used, good working order, or new, sealed"
    },
    "price_minor": {
      "type": "integer",
      "minimum": 0,
      "maximum": 999999999999,
      "description": "The sale price in whole minor units (integer cents). 120000 is USD 1,200.00"
    },
    "currency": {
      "type": "string",
      "pattern": "^[A-Za-z]{3}$",
      "description": "ISO code the price is in"
    },
    "date": {
      "type": "string",
      "maxLength": 10,
      "description": "The date of the sale, YYYY-MM-DD. Default today"
    },
    "as_is": {
      "type": "boolean",
      "description": "Include the as-is clause: sold with all faults, no warranties except any written here. Default true, the norm for second-hand sales; pass false to leave it out"
    },
    "warranty": {
      "type": "string",
      "maxLength": 4000,
      "description": "A warranty the seller does give, in their own words, e.g. The seller warrants the engine for 30 days from the sale date"
    },
    "notes": {
      "type": "string",
      "maxLength": 4000,
      "description": "Anything else the document should say, e.g. payment method or what is included in the sale"
    },
    "duplicate_ok": {
      "type": "boolean",
      "description": "Record it even though an identical sale to the same buyer exists, for a genuinely repeated sale. Default false"
    }
  },
  "required": [
    "buyer_name",
    "item_description",
    "price_minor",
    "currency"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

sale_update

Change anything on a bill of sale that is not finalized yet: price, buyer, seller, item details, identifiers, the as-is clause, warranty or notes. Pass an empty string to clear an optional field. A finalized document cannot be edited.

Parameters23

sale	string	required	The bill of sale id, e.g. BOS-2026-0001
buyer_name	string	optional	Who is buying
buyer_address	string	optional
buyer_email	string	optional
buyer_phone	string	optional
seller_name	string	optional	Who is selling
seller_address	string	optional
seller_email	string	optional
seller_phone	string	optional
item_description	string	optional
item_category	string	optional
vin	string	optional
serial	string	optional
imei	string	optional
identifier_other	string	optional
quantity	integer	optional
condition	string	optional
price_minor	integer	optional	The sale price in whole minor units (integer cents)
currency	string	optional
date	string	optional	The date of the sale, YYYY-MM-DD
as_is	boolean	optional
warranty	string	optional
notes	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "sale": {
      "type": "string",
      "maxLength": 200,
      "description": "The bill of sale id, e.g. BOS-2026-0001"
    },
    "buyer_name": {
      "type": "string",
      "maxLength": 200,
      "description": "Who is buying"
    },
    "buyer_address": {
      "type": "string",
      "maxLength": 4000
    },
    "buyer_email": {
      "type": "string",
      "maxLength": 200
    },
    "buyer_phone": {
      "type": "string",
      "maxLength": 200
    },
    "seller_name": {
      "type": "string",
      "maxLength": 200,
      "description": "Who is selling"
    },
    "seller_address": {
      "type": "string",
      "maxLength": 4000
    },
    "seller_email": {
      "type": "string",
      "maxLength": 200
    },
    "seller_phone": {
      "type": "string",
      "maxLength": 200
    },
    "item_description": {
      "type": "string",
      "maxLength": 4000
    },
    "item_category": {
      "type": "string",
      "maxLength": 200
    },
    "vin": {
      "type": "string",
      "maxLength": 40
    },
    "serial": {
      "type": "string",
      "maxLength": 200
    },
    "imei": {
      "type": "string",
      "maxLength": 20
    },
    "identifier_other": {
      "type": "string",
      "maxLength": 200
    },
    "quantity": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100000
    },
    "condition": {
      "type": "string",
      "maxLength": 200
    },
    "price_minor": {
      "type": "integer",
      "minimum": 0,
      "maximum": 999999999999,
      "description": "The sale price in whole minor units (integer cents)"
    },
    "currency": {
      "type": "string",
      "pattern": "^[A-Za-z]{3}$"
    },
    "date": {
      "type": "string",
      "maxLength": 10,
      "description": "The date of the sale, YYYY-MM-DD"
    },
    "as_is": {
      "type": "boolean"
    },
    "warranty": {
      "type": "string",
      "maxLength": 4000
    },
    "notes": {
      "type": "string",
      "maxLength": 4000
    }
  },
  "required": [
    "sale"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

sale_finalize

Finalize a bill of sale so it is ready to sign: the document is frozen from this call on, sale_update refuses it, and every later render is the signing copy without the DRAFT watermark. Free tier: 5 finalized documents.

Parameters1

sale

string

required

The bill of sale id, e.g. BOS-2026-0001

Raw schema

{
  "type": "object",
  "properties": {
    "sale": {
      "type": "string",
      "maxLength": 200,
      "description": "The bill of sale id, e.g. BOS-2026-0001"
    }
  },
  "required": [
    "sale"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

sale_list

List every bill of sale, drafts and finalized, newest first: id, status, date, item, buyer, seller and price. Filter to drafts or finalized documents with status.

Parameters2

status	string	optional	Which documents to list: all (default), draft, or final
limit	integer	optional	Maximum rows, default 500

Raw schema

{
  "type": "object",
  "properties": {
    "status": {
      "type": "string",
      "enum": [
        "all",
        "draft",
        "final"
      ],
      "description": "Which documents to list: all (default), draft, or final"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 500,
      "description": "Maximum rows, default 500"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

sale_get

Read one bill of sale in full by its BOS number: both parties, the item and its identifiers, price, terms, and whether it is still a draft or the finalized signing copy.

Parameters1

sale

string

required

The bill of sale id, e.g. BOS-2026-0001

Raw schema

{
  "type": "object",
  "properties": {
    "sale": {
      "type": "string",
      "maxLength": 200,
      "description": "The bill of sale id, e.g. BOS-2026-0001"
    }
  },
  "required": [
    "sale"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

sale_delete

Delete a bill of sale by its BOS number. A draft goes outright. A finalized document needs confirm_finalized true, because it is the local copy of a record the buyer may hold. The BOS number is never reissued, so a gap in the series is the record that a document was deleted.

Parameters2

sale	string	required	The bill of sale id, e.g. BOS-2026-0001
confirm_finalized	boolean	optional	Required true to delete a finalized document. Default false

Raw schema

{
  "type": "object",
  "properties": {
    "sale": {
      "type": "string",
      "maxLength": 200,
      "description": "The bill of sale id, e.g. BOS-2026-0001"
    },
    "confirm_finalized": {
      "type": "boolean",
      "description": "Required true to delete a finalized document. Default false"
    }
  },
  "required": [
    "sale"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

sale_render

Render a bill of sale as a clean printable document: Markdown, a self-contained HTML file ready for print-to-PDF, or both, with signature lines for seller and buyer. Drafts render with a DRAFT watermark so a review copy cannot be signed by mistake. Every file comes back as a download link valid for one hour, and out_path is only the stem the files are named with. Free.

Parameters4

sale	string	required	The bill of sale id, e.g. BOS-2026-0001
format	string	optional	What to render: markdown, html, or both (default). The HTML is one self-contained file, no external assets
out_path	string	optional	Name for the downloaded files, e.g. civic-sale; with format both, .md and .html are appended to the stem. Default: the document id. Each file comes back as a download link valid for one hour
overwrite	boolean	optional	Replace an existing file at out_path. Default false: an occupied explicit path is refused, a derived one gets -2, -3, ...

Raw schema

{
  "type": "object",
  "properties": {
    "sale": {
      "type": "string",
      "maxLength": 200,
      "description": "The bill of sale id, e.g. BOS-2026-0001"
    },
    "format": {
      "type": "string",
      "enum": [
        "markdown",
        "html",
        "both"
      ],
      "description": "What to render: markdown, html, or both (default). The HTML is one self-contained file, no external assets"
    },
    "out_path": {
      "type": "string",
      "maxLength": 1000,
      "description": "Name for the downloaded files, e.g. civic-sale; with format both, .md and .html are appended to the stem. Default: the document id. Each file comes back as a download link valid for one hour"
    },
    "overwrite": {
      "type": "boolean",
      "description": "Replace an existing file at out_path. Default false: an occupied explicit path is refused, a derived one gets -2, -3, ..."
    }
  },
  "required": [
    "sale"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

sale_summary

Summarize the book: how many drafts and finalized documents, and the total sold value per currency, drafts separate from finalized. Currencies are never added together. Free.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$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/bill-of-sale/README.md5 KBView on GitHub

mcp-bill-of-sale

In the official MCP Registry (io.github.theluckystrike/bill-of-sale). Record a sale and get a signed-paper-ready bill of sale. Tell your assistant who sold, who bought, what the item is, with the VIN, serial number or IMEI where it has one, the price and the date, and the server writes the document: parties, item, price, an as-is clause for second-hand sales, any warranty in your own words, and signature lines for both sides. Work on it as a draft, finalize it into the frozen signing copy, and print it as Markdown or as a single self-contained HTML file that prints to PDF from any browser with no assets beside it. Everything stays on your machine; there is no account and no network call in this server at all.

Built by theluckystrike.

npm publish for @theluckystrike/mcp-bill-of-sale is pending, so npx -y @theluckystrike/mcp-bill-of-sale returns 404 today. Until then, a clone+build is the working path.

Install

Claude Desktop

macOS ~/Library/Application Support/Claude/claude_desktop_config.json, Windows %APPDATA%\Claude\claude_desktop_config.json:

json

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

Claude Code

claude mcp add bill-of-sale -- npx -y @theluckystrike/mcp-bill-of-sale

Cursor

~/.cursor/mcp.json (global) or .cursor/mcp.json (project), same entry as Claude Desktop.

Tools

tool	what it does
`sale_create`	Record a sale and generate the bill of sale: seller, buyer, item with VIN/serial/IMEI where it has one, price in minor units, date. Returns `BOS-YYYY-NNNN`. An identical repeat sale is refused unless you confirm it
`sale_update`	Change anything on a draft before signing: price, parties, item details, identifiers, the as-is clause, warranty, notes. Empty string clears an optional field
`sale_finalize`	Freeze the draft into the signing copy. From here `sale_update` refuses it and every render prints without the DRAFT watermark
`sale_list`	Every bill of sale, newest first: id, status, date, item, buyer, seller, price. Filter to drafts or finalized
`sale_get`	One bill of sale in full by its BOS number
`sale_delete`	Delete a draft outright; a finalized document needs `confirm_finalized: true`. The number is never reissued, so a gap in the series is the record of the deletion
`sale_render`	Print the document: Markdown, a self-contained HTML file for print-to-PDF, or both, with signature lines. Drafts carry a DRAFT watermark so a review copy cannot be signed by mistake
`sale_summary`	The book at a glance: draft and finalized counts, total value per currency. Currencies are never added together
`license_status` / `license_activate`	Free or Pro, and the key

Free vs Pro

	Free	Pro
Open drafts	10	Unlimited
Finalized documents	5	Unlimited
Render to Markdown and HTML (`sale_render`)	Unlimited	Unlimited
Read, list and summarize (`sale_get`, `sale_list`, `sale_summary`)	Unlimited	Unlimited
Delete (`sale_delete`)	Yes	Yes

The document itself is never metered. Whether you hold a signed record of the sale is the question this server exists to answer, and a free tier that withholds the document is a demo. What is metered is the volume of records held: ten open drafts and five finalized documents is a real year of side-business sales, not a trial. sale_delete is free for the same reason the cap is on records held: a draft typed in twice would otherwise cost a slot with no way back but a key.

Get Pro: https://mcp.zovo.one/buy/bill-of-sale, $19 one-time for this server, or $39 for the bundle.

How a sale flows

sale_create with the facts. The seller defaults to the shared business profile's name when the profile has one, so the seller block is typed once for the whole suite.
sale_render prints the review copy, watermarked DRAFT.
sale_update fixes anything the buyer or seller spots.
sale_finalize freezes it. sale_render now prints the signing copy: sign the printed page or print the HTML to PDF, and both parties keep a copy.

Every amount is an integer number of minor units, a price is never a float, and dates are checked as real calendar dates. A VIN that is not 17 characters or an IMEI that is not 15 digits is stored as given but flagged in the response, because those are the two identifiers a buyer most often misreads.

Privacy

All data stays local, in ${XDG_DATA_HOME:-~/.local/share}/mcp-servers/bill-of-sale/. Two files: sales.json, counter.json, plus rendered documents under documents/. Nothing is sent anywhere, there is no account, no API key and no network call in this server at all. License keys are verified offline.

The rendered document is a generic template, not legal advice. Bills of sale for vehicles, boats and regulated goods may have statutory form or filing requirements where the sale happens.

Built by theluckystrike. https://github.com/theluckystrike

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-bill-of-sale

Install

Tools (10)

sale_createsale_updatesale_finalizesale_listsale_getsale_deletesale_rendersale_summary

Remote endpoint

Streamable HTTP

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

url

https://mcp.zovo.one/mcp/bill-of-sale

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": {
    "bill-of-sale": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.zovo.one/mcp/bill-of-sale"
      ]
    }
  }
}

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

io.github.theluckystrike/bill-of-sale (MCP) Server

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

sale_create

sale_update

sale_finalize

sale_list

sale_get

sale_delete

sale_render

sale_summary

license_status

license_activate

mcp-bill-of-sale

Install

Claude Desktop

Claude Code

Cursor

Tools

Free vs Pro

How a sale flows

Privacy

Use these docs as an MCP server

Install

Remote endpoint

Configuration

Related servers