Docs
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 toolupdate_organization

Purpose

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
org:update / settings:update
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 introduction

Related tools