io.github.theluckystrike/bill-of-sale

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

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

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "bill-of-sale": {
      "url": "https://mcp.zovo.one/mcp/bill-of-sale",
      "transport": "streamable-http"
    }
  }
}

Measured tools (10)

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

  Parameters:

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

  Hints: read-only no · destructive no · idempotent no · open-world no

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

  Parameters:

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

  Hints: read-only no · destructive no · idempotent no · open-world no

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

  Parameters:

  • sale (required) — string — The bill of sale id, e.g. BOS-2026-0001

  Hints: read-only no · destructive no · idempotent no · open-world no

• sale_list read-only

  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.

  Parameters:

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

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• sale_get read-only

  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.

  Parameters:

  • sale (required) — string — The bill of sale id, e.g. BOS-2026-0001

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• sale_delete destructive

  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.

  Parameters:

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

  Hints: read-only no · destructive yes · idempotent no · open-world no

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

  Parameters:

  • sale (required) — string — The bill of sale id, e.g. BOS-2026-0001
  • format — string — What to render: markdown, html, or both (default). The HTML is one self-contained file, no external assets
  • out_path — string — 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 — Replace an existing file at out_path. Default false: an occupied explicit path is refused, a derived one gets -2, -3, ...

  Hints: read-only no · destructive no · idempotent no · open-world no

• sale_summary read-only

  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.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• license_status read-only

  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.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

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

  Parameters:

  • key (required) — string — License key from checkout, MCPL1.<payload>.<signature>

  Hints: read-only no · destructive no · idempotent no · open-world no

Publisher website Repository

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.