McpStamp Price Catalogue

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

A price list and labour rate card by SKU with dated prices, used to price quotes and invoices.

The publisher's own server: PriceWin

VerifiedStreamable HTTPWeb executableProductivity & WorkflowFinanceBusiness & Commerce

Overview

McpStamp Price Catalogue'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 Price Catalogue 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%2Fcatalogue/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-price-catalogue": {
      "type": "http",
      "url": "https://mcp.zovo.one/mcp/catalogue"
    }
  }
}

README

mcp-catalogue

In the official MCP Registry (io.github.theluckystrike/catalogue). One price list and one rate card, kept where the invoice and the quote can both read them. Give a product a code, a name, a unit and a price in minor units, with the day that price comes into force. Give a role an hourly rate the same way. Then hand the catalogue a list of what a customer had, and it hands back the line items already priced: the quantity, the description, the unit price and the VAT rate, in the exact argument shape invoice_create takes and in the exact argument shape quote_create takes.

Nothing is invented and nothing is stored twice. A SKU holds its price ROWS, each with a valid-from date; the price on a date is worked out on the call, so raising a price in July does not rewrite what June's job was quoted at. An unknown code comes back as a refusal naming the code, never as a guessed price.

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

Claude Code

sh
claude mcp add catalogue -- npx -y @theluckystrike/mcp-catalogue

Cursor

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

Tools

ToolWhat it does
sku_setAdd a catalogue line or reprice one: code, name, unit, optional VAT rate, and a price in minor units for one currency, tier and valid-from date
sku_getThe price of one SKU as of a date, naming the row it came from and any later price already booked
sku_listThe catalogue with the price in force, filtered by code prefix, currency and tier
sku_deleteDelete a line raised by mistake. Only one nothing depends on. Free on every tier
rate_setSet an hourly rate on a role's rate card, from the day it applies, optionally bound to a SKU
rate_getThe hourly rate for a role as of a date, or every rate card
lines_resolvePrice a list of sku and role lines into invoice_create-ready and quote_create-ready items
price_list_textThe price list as plain text: prices in force, valid-from dates, then the labour rates
price_list_pdfThe price list as an A4 PDF, per currency and tier
catalogue_reportSKUs, rows in force, rows a later row already replaces, rows with no price in the default currency
license_status / license_activateFree or Pro, and where to upgrade

Free vs Pro

FreePro
SKUs in the catalogue25unlimited
Price rows per SKU100100
Rate cardsunlimitedunlimited
Set, price, list, resolve linesyesyes
Price list (text)yesyes
Delete an unused SKUyesyes
Price tiers beyond standardnoyes
Price list (PDF)noyes
Catalogue reportnoyes

Get Pro: https://mcp.zovo.one/buy/catalogue ($19 one-time for this server, $39 for all of them, lifetime). Keys are verified offline; nothing is sent anywhere.

Where the price comes from

A price row is (currency, tier, valid_from, amount). The price on a date is the latest valid_from at or before that date, for that currency and that tier. Setting a row on a key that already exists REPLACES it, so two rows can never share one key and "the price that day" is never a coin toss. A date before every row has no price and is refused; a price that did not exist yet is not a price.

Nothing here converts a currency. A EUR price shown under a PLN heading would be an invented number, so a SKU with no price in the currency you asked for is listed as having none, and catalogue_report counts them.

The measured insight

The two servers this catalogue feeds take the same price in different scales, and the gap is exactly 100x. invoice_create's item carries unit_price in MAJOR units ("Price per unit in major units, e.g. 90 for 90 EUR", servers/invoice/src/index.ts); quote_create's item carries unit_price_minor in MINOR units ("9000 = 90.00 EUR, 90 = JPY 90. Never a decimal", servers/quotes/src/index.ts). Both fields are called the unit price, both take a plain number, and neither tool can tell that the number it was handed was scaled for the other one: 45000 passed as unit_price is a valid invoice line for EUR 45,000.00.

Measured on the worked resolution in test/unit.test.mjs: the correct payload nets EUR 2,613.63, and the same items with the quote server's field fed into the invoice server's engine net EUR 261,363.00, which the suite asserts is exactly 100x. In a 3-decimal currency such as KWD it is 1000x. So the catalogue stores minor units, which is the only lossless form, and builds BOTH payloads itself in one call, printing the scale against each. That is the whole reason lines_resolve returns two payloads instead of one "price" the caller reshapes.

The second half of that: every stored price is a whole number of minor units, so invoice_create's own computeTotals rounds the major-unit form straight back to the integer it came from. rounding_drift_minor on a resolution is zero by construction and the suite asserts it, which is the machine-checkable form of "the invoice will show the figure the price list showed".

Privacy

All data stays local: ${XDG_DATA_HOME:-~/.local/share}/mcp-servers/catalogue/. No network call is made by any tool. The only file outside that directory this server touches is the shared business profile, read-only, for the default currency, the default VAT rate and the name at the top of the price list. It creates no invoice and no quote.

Built by 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/catalogue/README.md at commit 6535b33

Tools

12

sku_set

Add or reprice a SKU

Add a catalogue line or reprice one: a code, a name, a unit, an optional VAT rate, and price_minor in whole minor units for one currency, tier and valid_from. A repriced line keeps its old rows. Free: 25 SKUs, one tier.

Parametersskurequirednamerequirednotetierunitcurrencyvat_ratevalid_fromprice_minorrequiredduplicate_ok

sku_get

The price of one SKU on a date

Show the price of one SKU as of a date, in one currency and tier: the row picked is the latest valid_from at or before that date, and the answer names the row and any later one already booked. Free.

Parametersskurequireddatetiercurrency

sku_list

List the catalogue

List catalogue lines with the price in force today, filtered by code prefix, by currency and by tier. A SKU with no price in that currency and tier is listed and said to have none. Free.

Parametersdatetierlimitprefixcurrency

sku_delete

Delete an unused SKU

Delete a catalogue line no rate card points at and that never priced a resolved line, freeing a free-tier slot. Otherwise it is refused, naming what depends on it: reprice it to withdraw it instead.

Parametersskurequired

rate_set

Set a labour rate

Set the hourly charge-out rate on a labour card: role, currency, hourly_minor in whole MINOR units and the day it starts. The same role, currency and date REPLACES that row rather than adding one. Free.

Parametersskunoterolerequiredcurrencyvalid_fromhourly_minorrequired

rate_get

The hourly rate on a date

Show the hourly rate for a role as of a date and currency: the row picked is the latest valid_from at or before that date, and the answer names it. With no role given, lists every card. Free.

Parametersdaterolecurrency

lines_resolve

Price lines from the catalogue

Turn a list of sku or role lines into invoice_create-ready and quote_create-ready items priced from the catalogue as of each line's date. An unknown code is refused by name and never priced. Free.

Parametersdatetierlinesrequiredclientcurrencytax_rate

price_list_text

The price list as plain text

Print the price list as plain text: every SKU with its unit, the price in force on a date and any later price booked, then the labour rate cards, under your business name. Also a .txt download link valid one hour. Free; price_list_pdf writes the A4 page.

Parametersdatetiercurrency

price_list_pdf

The price list as an HTML document (print to PDF)

Call this tool to render the price list for one currency and tier as an A4 HTML document laid out for print-to-PDF (this hosted endpoint has no PDF renderer) and return a download link valid for one hour: every SKU with its unit, its price in force and the day that price started. Pro.

Parametersdatetiercurrencyout_path

catalogue_report

Report the catalogue

Report the catalogue as at date: how many SKUs there are, how many price rows are in force, which rows a later row already replaces, and which SKUs carry no price in the profile's default currency. Reads only. Pro.

Parametersdatelimit

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

4
  1. v0.23.0LatestNov 3, 2026
  2. v0.22.6Oct 14, 2026
  3. v0.22.0Sep 17, 2026
  4. 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

Other Price integrations