---
title: "Listar reglas de categoría"
method: POST
path: "/tools/ledger_listCategoryRules"
tags: ["Ledger"]
---

# Listar reglas de categoría

`POST /tools/ledger_listCategoryRules`

## Request

- Base URL: `https://mcp.alegra.com`
- URL: `https://mcp.alegra.com/tools/ledger_listCategoryRules`
- Auth: HTTP bearer

Herramienta MCP: `ledger_listCategoryRules`.

Lista las reglas de categoría (reglas contables) registradas en Alegra, con filtros opcionales por tipo, estado, clave, ID, ordenamiento y selección de campos.

Ejemplo de llamada JSON-RPC:

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "ledger_listCategoryRules",
    "arguments": { "type": "income", "status": "active" }
  }
}
```

Filtras por tipo de regla con `type` (`asset`, `cost`, `equity`, `expense`, `income`, `liability`, `order`, `other` o `productionCost`), con inclusión múltiple vía `type_in` y exclusión vía `type_notIn` (separados por coma). Filtras por estado con `status` (`active` o `inactive`), por clave con `key`, `key_in` y `key_notIn`, y por ID con `id`, `id_in` e `id_notIn` (los listados separados por coma).

Con `order` eliges el criterio de ordenamiento y con `fields` los campos a retornar, separados por coma.

Las `key` de las reglas son los identificadores que aceptan los filtros `categoryRule_key` de `ledger_listCategories` y `exclude`.

Solo lectura.

## Request body

- object
  - `type` 'asset' | 'cost' | 'equity' | 'expense' | 'income' | 'liability' | 'order' | 'other' | 'productionCost': Filtra por tipo de regla.
  - `type_in` string: Múltiples tipos de regla separados por coma (inclusión).
  - `type_notIn` string: Múltiples tipos de regla separados por coma (exclusión).
  - `status` 'active' | 'inactive': Filtra por estado de la regla: active o inactive.
  - `key` string: Filtra por clave exacta de la regla.
  - `key_in` string: Múltiples claves separadas por coma (inclusión).
  - `key_notIn` string: Múltiples claves separadas por coma (exclusión).
  - `id` string: Filtra por ID numérico de la regla.
  - `id_in` string: Múltiples IDs separados por coma (inclusión).
  - `id_notIn` string: Múltiples IDs separados por coma (exclusión).
  - `order` string: Criterio de ordenamiento.
  - `fields` string: Campos a retornar, separados por coma.

## Response `200`

Lista de reglas de categoría

## Other responses

- `401`: No autorizado (token de Alegra inválido o expirado).

---

[API](https://skmtc.dev/alegra/apis/mcp-alegra.md) - [All operations](https://skmtc.dev/alegra/apis/mcp-alegra/llms.txt) - [OpenAPI document](https://skmtc.dev/alegra/apis/mcp-alegra/revisions/528447af020b?raw)