MCP serverAvailable tools
Update organization
Update one coherent organization settings section: profile, fiscal identity, essential sales defaults, automatic global invoice, or SAT synchronization. Read get_organization first.
MCP tool
update_organizationPurpose
Update one coherent organization settings section.
- Use when
- Organization profile, fiscal identity, essential sales defaults, global invoice, or SAT synchronization must change.
- Do not use when
- The change belongs to a specific document or catalog entry.
- Required permissions
- Side effects
- External side effect
- 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": { "section": { "type": "string", "const": "profile" }, "name": { "type": "string", "minLength": 1 }, "timeZone": { "type": "string", "minLength": 1 } }, "required": [ "section" ], "additionalProperties": false }, { "type": "object", "properties": { "section": { "type": "string", "const": "fiscal" }, "legalName": { "type": "string", "minLength": 1, "maxLength": 100 }, "rfc": { "type": "string", "minLength": 12, "maxLength": 13 }, "taxSystem": { "type": "string", "enum": [ "601", "603", "605", "606", "607", "608", "610", "611", "612", "614", "615", "616", "620", "621", "622", "623", "624", "625", "626" ], "description": "Active SAT tax-system code.", "x-exac-sat-catalog": "tax-systems" }, "address": { "type": "object", "properties": { "postalCode": { "type": "string", "pattern": "^\\d{5}$" }, "street": { "type": "string" }, "city": { "type": "string" }, "state": { "type": "string" }, "exterior": { "type": "string" }, "interior": { "type": "string" }, "neighborhood": { "type": "string" }, "municipality": { "type": "string" } }, "required": [ "postalCode" ], "additionalProperties": false }, "website": { "type": "string", "format": "uri" }, "phone": { "type": "string" } }, "required": [ "section", "legalName", "taxSystem", "address" ], "additionalProperties": false }, { "type": "object", "properties": { "section": { "type": "string", "const": "portal" }, "allowedCfdiUses": { "type": "array", "items": { "type": "string", "enum": [ "G01", "D06", "I07", "I06", "I01", "I05", "D09", "G02", "D04", "I04", "I03", "D08", "G03", "D03", "D02", "D01", "D05", "I02", "CN01", "I08", "CP01", "D10", "D07", "S01" ], "description": "Active SAT CFDI-use code.", "x-exac-sat-catalog": "cfdi-uses" } }, "receiptExpirationDays": { "anyOf": [ { "type": "integer", "minimum": 0, "maximum": 365 }, { "type": "null" } ] }, "receiptLocationRequired": { "type": "boolean" } }, "required": [ "section" ], "additionalProperties": false }, { "type": "object", "properties": { "section": { "type": "string", "const": "globalInvoice" }, "enabled": { "type": "boolean" }, "periodicity": { "type": "string", "enum": [ "day", "week", "fortnight", "month", "two_months" ] }, "eligibilityStartAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$" } }, "required": [ "section" ], "additionalProperties": false }, { "type": "object", "properties": { "section": { "type": "string", "const": "automation" }, "cfdiSyncEnabled": { "type": "boolean" }, "declarationSyncEnabled": { "type": "boolean" } }, "required": [ "section" ], "additionalProperties": false } ] } }, "required": [ "idempotencyKey", "input" ], "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false}Output schema
JSON Schema{ "type": "object", "properties": { "data": { "type": "object", "properties": { "name": { "type": "string" }, "timeZone": { "type": "string" }, "fiscal": { "type": "object", "properties": { "legalName": { "$ref": "#/definitions/__schema0" }, "rfc": { "$ref": "#/definitions/__schema0" }, "taxSystem": { "$ref": "#/definitions/__schema0" }, "rfcPersonType": { "$ref": "#/definitions/__schema0" }, "usesBorderRegionStimulus": { "type": "boolean" }, "website": { "$ref": "#/definitions/__schema0" }, "phone": { "$ref": "#/definitions/__schema0" }, "address": { "type": "object", "properties": { "street": { "$ref": "#/definitions/__schema0" }, "city": { "$ref": "#/definitions/__schema0" }, "state": { "$ref": "#/definitions/__schema0" }, "exterior": { "$ref": "#/definitions/__schema0" }, "interior": { "$ref": "#/definitions/__schema0" }, "neighborhood": { "$ref": "#/definitions/__schema0" }, "municipality": { "$ref": "#/definitions/__schema0" }, "postalCode": { "type": "string" } }, "required": [ "postalCode" ], "additionalProperties": false } }, "additionalProperties": false }, "readiness": { "type": "object", "properties": { "production": { "type": "boolean" }, "csd": { "type": "boolean" }, "fiel": { "type": "boolean" } }, "required": [ "production", "csd", "fiel" ], "additionalProperties": false }, "certificates": { "type": "object", "properties": { "csd": { "type": "object", "properties": { "configured": { "type": "boolean" }, "expiresAt": { "$ref": "#/definitions/__schema0" }, "serialNumber": { "$ref": "#/definitions/__schema0" } }, "required": [ "configured" ], "additionalProperties": false }, "fiel": { "type": "object", "properties": { "configured": { "type": "boolean" }, "expiresAt": { "$ref": "#/definitions/__schema0" } }, "required": [ "configured" ], "additionalProperties": false } }, "required": [ "csd", "fiel" ], "additionalProperties": false }, "globalInvoice": { "type": "object", "properties": { "enabled": { "type": "boolean" }, "periodicity": { "$ref": "#/definitions/__schema0" }, "eligibilityStartAt": { "allOf": [ { "$ref": "#/definitions/__schema1" } ] }, "lastRunAt": { "allOf": [ { "$ref": "#/definitions/__schema1" } ] } }, "required": [ "enabled" ], "additionalProperties": false }, "automation": { "type": "object", "properties": { "cfdiSyncEnabled": { "type": "boolean" }, "declarationSyncEnabled": { "type": "boolean" } }, "required": [ "cfdiSyncEnabled", "declarationSyncEnabled" ], "additionalProperties": false }, "portal": { "type": "object", "properties": { "allowedCfdiUses": { "type": "array", "items": { "type": "string" } }, "receiptExpirationDays": { "type": "number" }, "receiptLocationRequired": { "type": "boolean" } }, "required": [ "receiptLocationRequired" ], "additionalProperties": false } }, "required": [ "name", "timeZone", "fiscal", "readiness", "certificates", "globalInvoice", "automation", "portal" ], "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" }, "__schema1": { "type": "string", "format": "date-time" } }, "oneOf": [ { "required": [ "data" ] }, { "required": [ "error" ] } ]}Related workflow
See the canonical workflows in the introductionRelated tools
Read organization
Get the active organization profile, fiscal identity, readiness, certificate status, global-invoice settings, SAT synchronization, and essential sales defaults.
Search documents
Search one public document family at a time. Use cfdi for income, credit-note, transfer, payroll, and payment-complement documents; use withholding, sales_receipt, quote, expense, declaration, tax_compliance_opinion, or sales_receipt_refund for the other families.