Docs
MCP serverAvailable tools

Read fiscal series

Get the organization fiscal series and their development and production counters.

MCP toolget_fiscal_series

Purpose

Read fiscal series and development/production folio counters.

Use when
You need current series configuration before issuing a CFDI.
Do not use when
You need to update a series counter.
Required permissions
settings:read
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": {          "type": "string",          "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": {                "type": "string",                "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": {          "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",      "format": "date-time"    },    "__schema1": {      "type": "integer",      "minimum": 1,      "maximum": 9007199254740991    }  },  "oneOf": [    {      "required": [        "data"      ]    },    {      "required": [        "error"      ]    }  ]}

Related workflow

See the canonical workflows in the introduction

Related tools