MCP serverAvailable tools
Set price override
Set or remove one product price override for a customer or location. Set price to null to restore the product default.
MCP tool
set_price_overridePurpose
Set or remove a product price override for a customer or location.
- Use when
- A customer- or location-specific price must change.
- Do not use when
- You need to change the base product price.
- Required permissions
- Side effects
- Writes data
- Idempotency
- Idempotent
Input schema
JSON Schema{ "type": "object", "properties": { "idempotencyKey": { "type": "string", "minLength": 1, "maxLength": 200, "description": "Unique retry key for this exact operation. Reuse it only when retrying the same request." }, "input": { "oneOf": [ { "type": "object", "properties": { "scope": { "type": "string", "const": "customer" }, "customerId": { "type": "string" }, "productId": { "type": "string" }, "price": { "anyOf": [ { "type": "number", "minimum": 0 }, { "type": "null" } ] } }, "required": [ "scope", "customerId", "productId", "price" ], "additionalProperties": false }, { "type": "object", "properties": { "scope": { "type": "string", "const": "location" }, "locationId": { "type": "string" }, "productId": { "type": "string" }, "price": { "anyOf": [ { "type": "number", "minimum": 0 }, { "type": "null" } ] } }, "required": [ "scope", "locationId", "productId", "price" ], "additionalProperties": false } ] } }, "required": [ "idempotencyKey", "input" ], "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false}Output schema
JSON Schema{ "type": "object", "properties": { "data": { "anyOf": [ { "type": "object", "properties": { "scope": { "type": "string", "const": "customer" }, "customerId": { "type": "string" }, "productId": { "$ref": "#/definitions/__schema0" }, "overridePrice": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "removed": { "type": "boolean" } }, "required": [ "scope", "customerId", "productId", "overridePrice", "removed" ], "additionalProperties": false }, { "type": "object", "properties": { "scope": { "type": "string", "const": "location" }, "locationId": { "type": "string" }, "productId": { "$ref": "#/definitions/__schema0" }, "overridePrice": { "anyOf": [ { "type": "number" }, { "type": "null" } ] }, "removed": { "type": "boolean" } }, "required": [ "scope", "locationId", "productId", "overridePrice", "removed" ], "additionalProperties": false } ] }, "error": { "$schema": "http://json-schema.org/draft-07/schema#", "type": "object", "properties": { "code": { "type": "string", "enum": [ "validation_error", "unauthenticated", "forbidden", "not_found", "method_not_allowed", "conflict", "idempotency_conflict", "operation_in_progress", "recovery_required", "rate_limited", "provider_unavailable", "internal" ] }, "message": { "type": "string" }, "details": { "type": "object", "properties": { "issues": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "array", "items": { "anyOf": [ { "type": "string" }, { "type": "number" } ] } }, "message": { "type": "string" }, "code": { "type": "string" } }, "required": [ "path", "message" ], "additionalProperties": false } }, "retryable": { "type": "boolean" }, "retryAfterSeconds": { "type": "integer", "exclusiveMinimum": 0, "maximum": 9007199254740991 } }, "additionalProperties": false } }, "required": [ "code", "message" ], "additionalProperties": false } }, "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "definitions": { "__schema0": { "type": "string", "minLength": 1 } }, "oneOf": [ { "required": [ "data" ] }, { "required": [ "error" ] } ]}Related workflow
See the canonical workflows in the introductionRelated tools
Read prices
List product price overrides for one customer or business location. subjectId is the customerId from get_contacts or locationId from get_configuration.
Read employees
Search payroll employees or retrieve one employee. Search matches name, RFC, CURP, employee number, job title, or department.