Servidor MCP

change-order

io.github.theluckystrike/change-order
Negocio y operaciones Finanzas e inversión Público y accesible MCP 2026-07-28

Qué hace este MCP

Creates and manages change orders against quotes or work orders, including line-item deltas, approvals, contract values, and invoice payloads.

change_order_add_line
Add a changed line
Add one line to a draft change order: added or removed with a quantity and a unit price in minor units, or changed with the old and the new quantity and price, each with a reason and a date. Free.
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['change_order', 'kind', 'description', 'quantity', 'unit_price_minor', 'reason'], 'properties': {'date': {'type': 'string', 'maxLength': 10, 'description': "The day the change was asked for, YYYY-MM-DD. Default the change order's date"}, 'kind': {'enum': ['added', 'removed', 'changed'], 'type': 'string', 'description': 'added for new work, removed for work taken out, changed for a line whose quantity or price moves'}, 'note': {'type': 'string', 'maxLength': 2000}, 'reason': {'type': 'string', 'maxLength': 2000, 'description': "Why, in the client's words if you have them, e.g. Client asked for a second page after the kickoff"}, 'quantity': {'type': 'number', 'maximum': 1000000, 'description': 'added or removed: how many. changed: the NEW quantity', 'exclusiveMinimum': 0}, 'tax_rate': {'type': 'number', 'maximum': 1000, 'minimum': 0, 'description': "VAT percent for this line, overriding the shared profile's default"}, 'description': {'type': 'string', 'maxLength': 2000, 'description': 'The line as it reads on the quote or work order, e.g. Website audit'}, 'change_order': {'type': 'string', 'maxLength': 200, 'description': 'The change order id, e.g. CO-2026-0001, or its title when only one carries it'}, 'was_quantity': {'type': 'number', 'maximum': 1000000, 'description': 'changed only: the quantity before the change', 'exclusiveMinimum': 0}, 'unit_price_minor': {'type': 'integer', 'maximum': 1000000000000, 'minimum': 0, 'description': 'added or removed: the unit price in whole minor units. changed: the NEW unit price. 45000 is EUR 450.00'}, 'was_unit_price_minor': {'type': 'integer', 'maximum': 1000000000000, 'minimum': 0, 'description': 'changed only: the unit price before the change, in whole minor units'}}, 'additionalProperties': False}
change_order_create
Raise a change order
Raise a change order against a quote or work order and return its CO-YYYY-NNNN number: the reference, the client, a title, the date, and the original contract value in minor units. Free tier: 5 open.
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['reference', 'client', 'title'], 'properties': {'date': {'type': 'string', 'maxLength': 10, 'description': 'The day the change was raised, YYYY-MM-DD. Default today'}, 'note': {'type': 'string', 'maxLength': 2000}, 'title': {'type': 'string', 'maxLength': 2000, 'description': 'What the change is, in one line, e.g. Add a second landing page and drop hosting'}, 'client': {'type': 'string', 'maxLength': 200, 'description': 'The client the change is agreed with, as named on the quote or work order'}, 'currency': {'type': 'string', 'pattern': '^[A-Za-z]{3}$', 'description': "ISO code the contract is priced in. Defaults to the shared business profile's currency"}, 'reference': {'type': 'string', 'maxLength': 64, 'description': 'The quote or work order this change order is against, by its id, e.g. Q-2026-0003 or WO-2026-0001'}, 'duplicate_ok': {'type': 'boolean', 'description': 'Raise it even though an identical change order exists on this reference. Default false'}, 'reference_kind': {'enum': ['quote', 'work_order'], 'type': 'string', 'description': 'What the reference is. Inferred from the id when omitted: WO-... is a work order, anything else a quote'}, 'original_value_minor': {'type': 'integer', 'maximum': 1000000000000, 'minimum': 0, 'description': 'The contract value BEFORE any change order, net of VAT, in whole minor units. Required on the first change order against a reference; inherited by every later one'}}, 'additionalProperties': False}
change_order_delete
Delete an empty draft
Delete a DRAFT change order with no lines, freeing an open slot. One sent, approved, rejected or voided is refused, and so is one carrying lines: void it with change_order_status instead. The number is not reissued.
Destructivo
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['change_order'], 'properties': {'change_order': {'type': 'string', 'maxLength': 200, 'description': 'The change order id, e.g. CO-2026-0001, or its title when only one carries it'}}, 'additionalProperties': False}
change_order_document
Change order document
Render one change order as a plain-text document for the client to approve: every line with its reason, the delta net and gross, the contract value before and after, and an approval block. The same text also comes back as a .txt download link valid for one hour. Pro.
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['change_order'], 'properties': {'change_order': {'type': 'string', 'maxLength': 200, 'description': 'The change order id, e.g. CO-2026-0001, or its title when only one carries it'}}, 'additionalProperties': False}
change_order_get
Show one change order
Return one change order in full by CO number or client: every added, removed and changed line with its reason and delta, VAT, delta gross, the status history and the running value. change_order_list finds the id.
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['change_order'], 'properties': {'change_order': {'type': 'string', 'maxLength': 200, 'description': 'The change order id, e.g. CO-2026-0001, or its title when only one carries it'}}, 'additionalProperties': False}
change_order_invoice_payload
Invoice payload for an approved delta
Build the approved delta as invoice_create-ready items in MAJOR units and quote_create-ready items in MINOR units, with VAT at the shared profile rate. Writes nothing and creates nothing. Pro.
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['change_order'], 'properties': {'tax_rate': {'type': 'number', 'maximum': 1000, 'minimum': 0, 'description': "VAT percent for lines with no rate of their own, overriding the shared business profile's default"}, 'issue_date': {'type': 'string', 'maxLength': 10, 'description': 'The invoice issue date, YYYY-MM-DD. Default today'}, 'change_order': {'type': 'string', 'maxLength': 200, 'description': 'The change order id, e.g. CO-2026-0001, or its title when only one carries it'}}, 'additionalProperties': False}
change_order_list
List change orders
List change orders newest first with status, reference, client, currency and net delta, and above them the APPROVED and the pending delta per currency, kept apart. Filter by reference, status, client, date.
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'to': {'type': 'string', 'maxLength': 10, 'description': 'Latest date, YYYY-MM-DD'}, 'from': {'type': 'string', 'maxLength': 10, 'description': 'Earliest date, YYYY-MM-DD'}, 'limit': {'type': 'integer', 'maximum': 500, 'minimum': 1, 'description': 'Maximum rows returned, default and ceiling 500'}, 'client': {'type': 'string', 'maxLength': 200, 'description': 'Only change orders whose client name contains this text'}, 'status': {'enum': ['draft', 'sent', 'approved', 'rejected', 'void', 'open'], 'type': 'string', 'description': 'One status, or open for draft and sent together'}, 'reference': {'type': 'string', 'maxLength': 64, 'description': 'Only change orders against this quote or work order'}}, 'additionalProperties': False}
change_order_status
Move a change order along
Move one change order along and stamp the date and note: draft to sent, sent to approved or rejected, either to void. Backwards steps, an unsent approval and a backdated move are all refused.
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['change_order', 'status'], 'properties': {'date': {'type': 'string', 'maxLength': 10, 'description': 'The day it happened, YYYY-MM-DD. Default today'}, 'note': {'type': 'string', 'maxLength': 2000, 'description': 'What happened, e.g. Emailed to the client, or Approved by phone, confirmed in writing'}, 'status': {'enum': ['draft', 'sent', 'approved', 'rejected', 'void'], 'type': 'string', 'description': 'The status to move to'}, 'change_order': {'type': 'string', 'maxLength': 200, 'description': 'The change order id, e.g. CO-2026-0001, or its title when only one carries it'}}, 'additionalProperties': False}
contract_value
Running contract value
The running value of one quote or work order: original, approved deltas and current value, with pending draft and sent deltas kept apart. Net of VAT. A reference with no change order is refused.
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['reference'], 'properties': {'reference': {'type': 'string', 'maxLength': 64, 'description': 'The quote or work order this change order is against, by its id, e.g. Q-2026-0003 or WO-2026-0001'}}, 'additionalProperties': False}
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.
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['key'], 'properties': {'key': {'type': 'string', 'description': 'License key from checkout, MCPL1.<payload>.<signature>'}}, 'additionalProperties': False}
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.
Solo lectura Idempotente
Esquema de entrada
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
Modificado
license_activate
21 de September de 2026 a las 02:56
Modificado
license_status
21 de September de 2026 a las 02:56
Modificado
change_order_invoice_payload
21 de September de 2026 a las 02:56
Modificado
change_order_document
21 de September de 2026 a las 02:56
Modificado
contract_value
21 de September de 2026 a las 02:56
Modificado
change_order_delete
21 de September de 2026 a las 02:56
Modificado
change_order_list
21 de September de 2026 a las 02:56
Modificado
change_order_get
21 de September de 2026 a las 02:56
Modificado
change_order_status
21 de September de 2026 a las 02:56
Modificado
change_order_add_line
21 de September de 2026 a las 02:56
Modificado
change_order_create
21 de September de 2026 a las 02:56
Añadido
license_activate
17 de September de 2026 a las 12:52
Añadido
license_status
17 de September de 2026 a las 12:52
Añadido
change_order_invoice_payload
17 de September de 2026 a las 12:52
Añadido
change_order_document
17 de September de 2026 a las 12:52
Añadido
contract_value
17 de September de 2026 a las 12:52
Añadido
change_order_delete
17 de September de 2026 a las 12:52
Añadido
change_order_list
17 de September de 2026 a las 12:52
Añadido
change_order_get
17 de September de 2026 a las 12:52
Añadido
change_order_status
17 de September de 2026 a las 12:52
Añadido
change_order_add_line
17 de September de 2026 a las 12:52
Añadido
change_order_create
17 de September de 2026 a las 12:52