McpStamp Work Orders

io.github.theluckystrikePublished by GitHub account theluckystrikev0.23.0Updated Nov 3, 2026

Work orders for site jobs: parts and labour, status steps, completion reports, invoice lines.

VerifiedStreamable HTTPWeb executableProductivity & WorkflowBusiness & Commerce

Overview

McpStamp Work Orders's hosted MCP server (mcp.zovo.one); no sign-in required; Streamable HTTP; 12 tools.

No AI overview yet: these facts come from the registry entry and the server itself.

Endpoint
mcp.zovo.one
Last checked

Installation

In SourceWeft

  1. Open McpStamp Work Orders in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.theluckystrike%2Fwork-order/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "mcpstamp-work-orders": {
      "type": "http",
      "url": "https://mcp.zovo.one/mcp/work-order"
    }
  }
}

README

mcp-work-order

In the official MCP Registry (io.github.theluckystrike/work-order). Job orders for trades and field work, kept the way a job card is kept. Raise a work order against a client (the same client record your invoices use), give it a site address, the date it was asked for, what the job is and how urgent. Log what the job actually used as it goes: labour as hours at a rate, parts as a quantity at a unit cost with an optional markup. Move it along one step at a time, draft to scheduled to in progress to done to invoiced, each step stamped with its date and a note. When it is finished, hand the customer a completion report with the hours, the materials, the totals and a sign-off block, and take the invoice payload straight to invoice_create without retyping a single figure.

Nothing is invented and nothing is stored twice: the value, the hours, the materials and the VAT are derived from the lines on every call, and the invoice payload's unit prices are already the billed units, so the invoice reproduces the work order to the minor unit.

npm publish for @theluckystrike/mcp-work-order is pending, so npx -y @theluckystrike/mcp-work-order returns 404 today. Until then, the .mcpb one-click bundle or a clone+build is the working path.

Install

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

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

Claude Code

sh
claude mcp add work-order -- npx -y @theluckystrike/mcp-work-order

Cursor

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

Tools

ToolWhat it does
work_order_createRaise a job order and return its WO-YYYY-NNNN number: client, site address, requested date, description, priority
work_order_add_lineAdd one line: parts with a quantity and a unit cost in minor units and an optional markup percent, or labour with hours and an hourly rate
work_order_statusMove it one step: draft, scheduled, in_progress, done, invoiced, stamping the date and a note
work_order_getOne work order in full: every line with its billed unit, the hours, the materials, net and VAT, and the status history
work_order_listList work orders by status, by client and by requested-date range
work_order_deleteDelete a work order raised by mistake. Draft with no lines only. Free on every tier
completion_report_textThe completion report as plain text, ready to paste into an email
completion_report_pdfThe completion report as an A4 PDF, with the sign-off block
work_order_invoice_payloadAn invoice_create-ready payload from the lines, with VAT at the shared profile rate
work_orders_reportThe whole board: work orders per status, hours logged this month, unbilled value per currency
license_status / license_activateFree or Pro, and where to upgrade

Free vs Pro

FreePro
Open work orders5unlimited
Lines per work order200200
Raise, log, move, list, deleteyesyes
Completion report (text)yesyes
Completion report (PDF)noyes
Invoice payloadnoyes
Board reportnoyes

The cap counts OPEN work orders (draft, scheduled, in progress), not the ones you have ever raised, so finishing a job frees its slot. So does work_order_delete on a draft that has no lines, which is free on every tier: a way back that only a Pro key can reach is not a way back.

Get Pro: https://mcp.zovo.one/buy/work-order (one-time $19, lifetime), or all servers for $39: https://mcp.zovo.one/buy/bundle

Where the money comes from

This server keeps no arithmetic of its own. computeTotals, currencyDecimals, formatMoney and roundHalfUp are imported from @theluckystrike/mcp-invoice/lib, the A4 renderer from @theluckystrike/mcp-billing-docs/lib, the corrupt-store quarantine from @theluckystrike/mcp-timezone/lib. The VAT rate, the currency and the business name come from the shared business profile that business_set in the invoice server writes; the client comes from that server's client records. Nothing is written outside this server's own directory.

The measured insight

A markup belongs on the unit cost, not on the line total, and one minor unit is what says so. Seven parts at EUR 12.99 with 15 percent on top is EUR 14.94 a unit and EUR 104.58 on the line. Marking up the line total instead is round(9093 * 1.15) = 10,457 minor units, a cent less. Both look like the same sum, and only one of them is the figure the customer will be billed: the invoice server rounds the unit price to the minor unit first and multiplies (its D-R24 basis), so a work order that quotes the line-total figure quotes a number its own invoice cannot reproduce. The gap appears on every line whose marked-up unit does not land on a whole cent, it never nets out across lines because it is a rounding direction and not an error, and it is invisible in a spreadsheet check because both bases add up correctly. The unit suite asserts the 1-unit gap explicitly, so a change of basis fails the build instead of quietly re-pricing every job on the board.

Privacy

All data stays on your machine, in ${XDG_DATA_HOME:-~/.local/share}/mcp-servers/work-order/. Nothing is sent anywhere. There is no account and no API key. License keys are verified offline. This server reads one sibling file, the invoice server's clients.json, and writes into no store but its own.

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:

Source: servers/work-order/README.md at commit 6535b33

Tools

12

work_order_create

Raise a work order

Raise a job order and return its WO-YYYY-NNNN number: the client, the site address, the date it was asked for, what the job is and how urgent. Free tier: 5 open orders.

Parametersnoteclientrequiredcurrencyprioritydescriptionrequiredclient_emailduplicate_oksite_addressrequiredclient_vat_idclient_addressrequested_daterequired

work_order_add_line

Add a parts or labour line

Add one line: parts with quantity, unit_cost_minor in whole MINOR units and optional markup, or labour with hours and rate_minor. A line on an invoiced order, or dated before the request, is refused.

Parametersdatekindrequirednotehoursquantityrate_minorwork_orderrequireddescriptionrequiredmarkup_percentunit_cost_minor

work_order_status

Move a work order along

Move one work order exactly one step: draft, scheduled, in_progress, done, invoiced, stamping date and note. A skipped, backwards or backdated step is refused and nothing is written. Free.

Parametersdatenotestatusrequiredwork_orderrequired

work_order_get

Show one work order

Return one work order in full by WO number or client: the site, every parts and labour line with the unit billed, hours, materials, net and VAT, and the status history. Reads only. Free.

Parameterswork_orderrequired

work_order_list

List work orders

List work orders newest requested first: status, priority, client, site, hours, labour, materials and net value, with totals per currency. Filter by status, client and requested-date range. Free.

Parameterstofromlimitclientstatus

work_order_delete

Delete a draft work order

Delete a DRAFT work order with no lines, freeing an open slot. One past draft is refused, naming the date it got there, and so is one carrying lines. The WO number is never reissued. work_order_status moves it on.

Parameterswork_orderrequired

completion_report_text

Completion report as plain text

Turn a work order into a plain-text completion report: what was done, the labour hours, the materials, the totals and a sign-off block, ready to paste into an email. The same text also comes back as a .txt download link valid for one hour. Free on every tier.

Parameterswork_orderrequired

completion_report_pdf

Completion report as a PDF

Call this tool to render the A4 completion report of one work order and return a download link valid for one hour: the lines, the hours, the materials, the totals and the sign-off block. Pro.

Parametersout_pathwork_orderrequired

work_order_invoice_payload

Invoice payload for a work order

Build an invoice_create-ready payload from the lines, with VAT at the shared profile rate. Writes nothing and marks nothing: raise the invoice in the invoice server, then set this order invoiced. Pro.

Parameterstax_rateissue_datework_orderrequired

work_orders_report

Report the board

Report the whole board: how many work orders sit at each status, the hours logged this month, and the value not yet invoiced per currency, with the oldest open jobs named. Pro.

Parameterslimitmonth

license_status

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.

Takes no parameters.

license_activate

Activate license

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.

Parameterskeyrequired

Version history

5
  1. v0.23.0LatestNov 3, 2026
  2. v0.22.6Oct 14, 2026
  3. v0.22.1Oct 9, 2026
  4. v0.22.0Sep 17, 2026
  5. v0.21.0Sep 16, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts