io.github.theluckystrike/catalogue

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

A price list and rate card the quotes and invoice servers read by SKU.

Add to your agent

Copy this into your MCP client config:

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

Measured tools (12)

• sku_set

  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.

  Parameters:

  • sku (required) — string — The code, e.g. WEB-AUDIT. Upper case, no spaces. This is what an invoice line is filed under
  • name (required) — string — What it is on the customer's document, e.g. Website audit
  • price_minor (required) — integer — The price of ONE, in whole minor units. 45000 is EUR 450.00. Never a decimal
  • note — string
  • tier — string — Price tier, e.g. trade or list. Default standard. A second tier is Pro
  • unit — string — What one of it is: each, hour, month, 1000 words. Default each. Required the first time
  • currency — string — ISO code this price is in. Defaults to the shared business profile's currency
  • vat_rate — number — VAT percent for this product, overriding the shared profile's default on a resolved line
  • valid_from — string — The first day this price applies, YYYY-MM-DD. Default today
  • duplicate_ok — boolean — Add it even though another code already carries the same product at the same price. Default false

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

• sku_get read-only

  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.

  Parameters:

  • sku (required) — string — The SKU code, e.g. WEB-AUDIT, or the product name when only one product carries it
  • date — string — The day the price is wanted for, YYYY-MM-DD. Default today
  • tier — string — Price tier. Default standard
  • currency — string — Defaults to the shared business profile's currency

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

• sku_list read-only

  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.

  Parameters:

  • date — string — Show the price in force on this day instead of today, YYYY-MM-DD
  • tier — string — Price tier. Default standard
  • limit — integer — Maximum rows returned, default and ceiling 500
  • prefix — string — Only codes starting with this, e.g. HOST- for every hosting line
  • currency — string — The currency the price in force is shown in. Defaults to the profile's

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

• sku_delete destructive

  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.

  Parameters:

  • sku (required) — string — The SKU code, e.g. WEB-AUDIT, or the product name when only one product carries it

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

• rate_set

  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.

  Parameters:

  • role (required) — string — The role charged for, e.g. senior developer. Lower case, this is what an hours line is priced from
  • hourly_minor (required) — integer — The hourly rate in whole minor units. 8500 is EUR 85.00 an hour. Never a decimal
  • sku — string — A catalogue code this role bills under, so a resolved hours line carries the SKU's name and VAT rate
  • note — string
  • currency — string — ISO code this rate is in. Defaults to the shared business profile's currency
  • valid_from — string — The first day this rate applies, YYYY-MM-DD. Default today

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

• rate_get read-only

  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.

  Parameters:

  • date — string — The day the rate is wanted for, YYYY-MM-DD. Default today
  • role — string — The role, e.g. senior developer. Omit to list every rate card
  • currency — string — Defaults to the shared business profile's currency

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

• lines_resolve read-only

  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.

  Parameters:

  • lines (required) — array — The lines to price, each a sku with a quantity or a role with hours
  • date — string — The day the whole list is priced as of, YYYY-MM-DD. Default today
  • tier — string — Price tier for every line. Default standard
  • client — string — Client name or id, copied into both payloads. invoice_create and quote_create both need one
  • currency — The currency for every line. Defaults to the shared business profile's
  • tax_rate — number — VAT percent for lines whose SKU carries no rate of its own, overriding the shared profile

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

• price_list_text read-only

  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.

  Parameters:

  • date — string — The day the list is in force, YYYY-MM-DD. Default today
  • tier — string — One tier, or omit for standard. Pass all for every tier, which is Pro
  • currency — string — Defaults to the shared business profile's currency

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

• price_list_pdf read-only

  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.

  Parameters:

  • date — string — The day the list is in force, YYYY-MM-DD. Default today
  • tier — string — One tier. Default standard
  • currency — string — Defaults to the shared business profile's currency
  • out_path — string — Name for the downloaded file, e.g. trade-prices-april. Defaults to price-list-<currency>-<tier>-<date>; the list comes back as a download link valid for one hour

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

• catalogue_report read-only

  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.

  Parameters:

  • date — string — The day the report is in force, YYYY-MM-DD. Default today
  • limit — integer — Maximum rows listed in each section, default and ceiling 500

  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.