Job Card Template

io.github.theluckystrikePublished by GitHub account theluckystrikev0.22.6Updated Nov 4, 2026

Open a job card, log hours and materials against it, print the card for client sign-off.

VerifiedSTDIODesktop onlyProductivity & WorkflowFinanceBusiness & Commerce

Overview

AI-generated overview

Local MCP server that lets an assistant open job cards, log labor hours and materials, track running totals, and print cards for client sign-off.

What you can do
  • Create job cards with client, site, description, currency and scheduled date, and list or read them with hours and totals
  • Log labor hours per worker at an hourly rate and log materials with quantity and unit cost, all in integer cents
  • Move a card one step through open, in progress, done, invoiced and archived, with date and note in its history
  • Print a card as markdown or self-contained HTML with a signature line for client sign-off
  • Summarize a day or a week: cards touched, hours per worker, and labor and materials value per currency
  • Delete a mistaken card, and check or activate a free or Pro license
When to use it
Useful for small crews or solo tradespeople who want an assistant to keep a paper-style job board: recording hours and materials per job, watching running totals, and producing a printable card for the client to sign. It suits offline, single-machine bookkeeping where no account or cloud service is wanted.
Requirements
Runs as a local process on the desktop; the manifest lists an MCPB package, while the README notes the npm package is not yet published, so a clone and build is the current path. Data is stored locally under the user's data directory. No account, API key or network access is needed; an optional Pro license key is supplied through the MCP_LICENSE_KEY environment variable and verified offline.
Before you install
The server writes, changes and deletes job records on the local machine, so mistakes affect the stored board; deletion is refused for cards holding labor or materials. Pro lifts the ten-active-card limit and is a paid one-time purchase, though the key is optional and verified offline. Amounts are stored in integer cents and currencies are never converted, so mixed-currency totals stay separate.

Installation

In SourceWeft

  1. Open Job Card Template in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

mcp-job-card

[theluckystrike/mcp-job-card MCP server]

In the official MCP Registry (io.github.theluckystrike/job-card). One card per job, the way the paper one on the dashboard works. Open a card for the client and the site, log the hours each worker puts in at their rate and the materials that go into the job, and the card keeps the running totals: labor, materials and the grand total, always in integer cents. Move the card along as the job moves, open, in progress, done, invoiced, archived, and when the client wants to see it, print the card with its signature line for sign-off. A daily or weekly summary answers where the crew's hours went and what the work is worth, per currency. Everything stays on this machine; there is no account and no network call.

Built by theluckystrike.

npm publish for @theluckystrike/mcp-job-card is pending, so npx -y @theluckystrike/mcp-job-card 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": {    "job-card": {      "command": "npx",      "args": ["-y", "@theluckystrike/mcp-job-card"]    }  }}

Claude Code

sh
claude mcp add job-card -- npx -y @theluckystrike/mcp-job-card

Cursor

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

Tools

toolwhat it does
job_card_createOpen a job card: client, site, what the job is, currency, scheduled date. Returns JC-YYYY-NNNN
job_card_log_laborLog hours on a job card: who did the work, the day, the hours, the hourly rate in cents, what was done
job_card_log_materialLog materials used on a job card: the item, the quantity, the unit cost in cents
job_card_update_statusMove the card exactly one step -- open, in_progress, done, invoiced, archived -- stamping date and note into its history
job_card_listList cards newest first with hours and totals; filter by status and client; totals kept per currency
job_card_getRead one card in full: every entry, hours per worker, and the running totals in integer cents
job_card_printRender the card ready to print, with a signature line for client sign-off. Markdown or self-contained HTML
job_card_deleteDelete a card entered by mistake. One holding labor or materials is refused; archive it instead
job_card_summaryA day or a week: cards touched, hours per worker, labor and materials value per currency. A week runs Monday to Sunday
license_status / license_activateFree or Pro, and the key

Free vs Pro

FreePro
Active job cards10Unlimited
Labor and material entries per cardUnlimitedUnlimited
Running totals, list and getYesYes
Printable card, markdown and HTMLYesYes
Daily and weekly summaryYesYes

The record is never metered. Ten active cards is a real working board for a small crew, and a card stops counting the moment it is archived, so logging, totals, printing and summaries stay free for good. What Pro lifts is how many jobs are on the board at once.

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

Money and rounding

Every amount is an integer number of cents (a cent is 1/100 of the currency unit). A labor line is hours times the hourly rate; a materials line is quantity times the unit cost; each line value is rounded half-up to the nearest cent once, at the moment it is logged, and stored on the entry. Totals are the sums of those stored line values, so a total can never drift from its lines. Hours are carried as integer hundredths and quantities as integer thousandths, so 2.5 hours at 4999 cents an hour is 12498 cents, never 12497.499999. Currencies are never added together: this server holds no exchange rate.

Privacy

All data stays local, in ${XDG_DATA_HOME:-~/.local/share}/mcp-servers/job-card/. Two files: cards.json, counter.json. 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.

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/job-card/README.md at commit 1bd9d69

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

3
  1. v0.22.6LatestOct 14, 2026
  2. v0.22.0Oct 12, 2026
  3. v0.21.0Sep 16, 2026

Score

50% 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 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts