# change order [Health: Active]

**Category:** 💻 Developer Tools  
**Repository:** https://github.com/theluckystrike/mcp-change-order  
**GitHub Stars:** 0  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/change-order

## Description
Change orders against a quote or work order: deltas, approval, running contract value.

## Tools
Capabilities this server exposes over MCP:

- **change_order_create** — Raise a change order against a quote or work order: reference, client, title, date, and the original contract value on the first one
- **change_order_add_line** — Add an added, removed or changed line to a draft, with its quantity, unit price in minor units, reason and date
- **change_order_status** — Move it along: draft to sent, sent to approved or rejected, draft or sent to void, each step dated
- **change_order_get** — One change order in full: every line with its delta, the VAT, the history and the running value of the reference
- **change_order_list** — Change orders by reference, status, client and date range, with approved and pending deltas per currency
- **change_order_delete** — Delete an empty draft raised by mistake. Free on every tier
- **contract_value** — The running value of one reference: original, approved delta, current value, pending delta held apart
- **change_order_document** — The change order as a plain-text document for the client to approve
- **change_order_invoice_payload** — The approved delta as `invoice_create` items (MAJOR units) and `quote_create` items (MINOR units)
- **license_status** — Free or Pro, and where to upgrade

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

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

## Documentation

## What change order MCP server does

The change order MCP server manages variations linked to a quote or work order. A change order records its reference, client, title, date, lines, and status history. Lines can represent additions, removals, or changes, with quantities, unit prices in minor currency units, reasons, and dates.

The first change order for a reference establishes the original contract value. Later change orders inherit that value, and a different original value is refused. The running value is calculated from the original amount plus approved deltas. Pending changes remain separate until the client responds.

## How it works

A change order begins as a draft. Lines may be added while it is still a draft, after which it can be sent to the client. A sent order can become approved or rejected, while a draft or sent order can be voided. Approved, rejected, and voided orders are final, and each transition has a date. Dates that move backward in the history are rejected.

Totals, VAT, currency handling, rounding, and formatted money use arithmetic shared with the invoice functionality. The server recalculates deltas and values when tools are called. For changed lines, invoice output can contain a reversal of the original line and the revised line, allowing the customer to reproduce the change rather than seeing only a net amount.

## Setup and configuration

You can run the server locally from source or use its hosted streamable-HTTP endpoint. A source checkout is built with Node after cloning the repository, installing dependencies, and running the build command. The resulting MCP entry point is `dist/index.js`.

Hosted connections use `https://mcp.zovo.one/mcp/change-order` and require a bearer token. Clients that cannot set headers can put the token in the URL path instead. The endpoint returns unauthorized responses for tool calls without a token. A Claude Desktop package is also available from the latest release.

The npm package is not published, so an `npx` installation currently fails. Local data is stored under `${XDG_DATA_HOME:-~/.local/share}/mcp-servers/change-order/`. The server does not require an account or API key for local use, and license keys are checked offline.

## Tools and capabilities

Available operations include:

- Create, add lines to, retrieve, list, delete, and change the status of orders.
- Query contract value with original, approved, current, and pending amounts.
- Produce a plain-text client document for approval.
- Return approved deltas as `invoice_create` items in major units and `quote_create` items in minor units.
- Check whether the installation is on the Free or Pro tier.

Free usage allows five open draft or sent orders and up to 200 lines per order. Pro removes the open-order limit; both tiers retain the 200-line limit. Documents and invoice-ready payloads require Pro.

## Limitations and notes

The change order MCP server keeps data in its own local directory and reads the shared business profile for VAT rate, currency, and business name. It does not write to sibling stores. Deleting is limited to empty drafts. A sent order cannot receive another line; it must be voided and replaced so the client approves the exact version they received.

_Full upstream README: https://allmcps.com/mcp/change-order/readme_