MCPサーバー

scope-change

io.github.theluckystrike/scope-change
ビジネス・業務 公開・接続可能 MCP 2026-07-28

このMCPでできること

Creates and tracks work-order or quote change orders, including line deltas, reasons, 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.
入力スキーマ
{'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.
入力スキーマ
{'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.
破壊的操作あり
入力スキーマ
{'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.
入力スキーマ
{'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.
入力スキーマ
{'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.
入力スキーマ
{'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.
入力スキーマ
{'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.
入力スキーマ
{'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.
入力スキーマ
{'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.
入力スキーマ
{'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.
読み取り専用 冪等
入力スキーマ
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
追加
license_activate
2026年9月24日2:40
追加
license_status
2026年9月24日2:40
追加
change_order_invoice_payload
2026年9月24日2:40
追加
change_order_document
2026年9月24日2:40
追加
contract_value
2026年9月24日2:40
追加
change_order_delete
2026年9月24日2:40
追加
change_order_list
2026年9月24日2:40
追加
change_order_get
2026年9月24日2:40
追加
change_order_status
2026年9月24日2:40
追加
change_order_add_line
2026年9月24日2:40
追加
change_order_create
2026年9月24日2:40