MCP serverAvailable tools
Read fiscal series
Read fiscal series and development/production folio counters.
MCP tool
get_fiscal_seriesPurpose
- Use when
- You need current series configuration before issuing a CFDI.
- Do not use when
- You need to update a series counter.
- Required permissions
- Side effects
- None
- Idempotency
- Idempotent
Input schema
JSON Schema{ "type": "object", "properties": {}, "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false}Output schema
JSON Schema{ "type": "object", "properties": { "data": { "type": "object", "properties": { "status": { "enum": [ "preparing", "ready", "attention_required" ] }, "initializedAt": { "allOf": [ { "$ref": "#/definitions/__schema0" } ] }, "lastVerifiedAt": { "allOf": [ { "$ref": "#/definitions/__schema0" } ] }, "series": { "type": "array", "items": { "type": "object", "properties": { "seriesId": { "type": "string", "minLength": 1 }, "code": { "type": "string" }, "nextFolioProduction": { "$ref": "#/definitions/__schema1" }, "nextFolioDevelopment": { "$ref": "#/definitions/__schema1" }, "status": { "enum": [ "active", "inactive" ] }, "updatedAt": { "$ref": "#/definitions/__schema0" } }, "required": [ "seriesId", "code", "nextFolioProduction", "nextFolioDevelopment", "status", "updatedAt" ], "additionalProperties": false } } }, "required": [ "status", "series" ], "additionalProperties": false }, "error": { "$schema": "http://json-schema.org/draft-07/schema#", "type": "object", "properties": { "code": { "enum": [ "validation_error", "unauthenticated", "forbidden", "payment_required", "not_found", "method_not_allowed", "conflict", "idempotency_conflict", "operation_in_progress", "recovery_required", "migration_required", "rate_limited", "provider_unavailable", "internal" ] }, "message": { "type": "string" }, "details": { "type": "object", "properties": { "document": { "type": "object", "properties": { "documentRef": { "type": "string", "pattern": "^(invoice|withholding|sales_receipt|declaration|tax_compliance_opinion|sales_receipt_refund):.+$" }, "editable": { "type": "boolean" } }, "required": [ "documentRef", "editable" ], "additionalProperties": false }, "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 }, "reason": { "type": "string" }, "balanceMinor": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "topUpUrl": { "type": "string" } }, "additionalProperties": false } }, "required": [ "code", "message" ], "additionalProperties": false } }, "$schema": "http://json-schema.org/draft-07/schema#", "additionalProperties": false, "definitions": { "__schema0": { "type": "string", "format": "date-time" }, "__schema1": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 } }, "oneOf": [ { "required": [ "data" ] }, { "required": [ "error" ] } ]}Related workflow
See the canonical workflows in QuickstartRelated tools
Refresh invoice status
Ask SAT for the current status of a stamped production CFDI and reconcile local state. Exac sandbox documents are simulated and cannot be verified with SAT; use get_document to read their stored state.
Update fiscal series
Edit an existing fiscal series code and its folio counters.