---
title: "Listar centros de costos"
method: POST
path: "/tools/accounting_listCostCenters"
tags: ["Accounting"]
---

# Listar centros de costos

`POST /tools/accounting_listCostCenters`

## Request

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

Herramienta MCP: `accounting_listCostCenters`.

Lista todos los centros de costos registrados en la compañía con filtros opcionales y paginación.

Ejemplo de llamada JSON-RPC:

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "accounting_listCostCenters",
    "arguments": { "limit": 30, "metadata": true }
  }
}
```

Soporta paginación por `start` y `limit` (hasta 30 resultados por página, 30 por defecto), orden con `order_field` (`id`, `name`, `code` o `status`) y `order_direction` (`ASC` o `DESC`, ascendente por defecto), filtro por estado con `status` (`active` o `inactive`) y búsqueda parcial por nombre con `name`. Con `metadata` en `true` la respuesta incluye el total de registros.

Úsala como punto de partida para descubrir los `id` que necesita `accounting_getCostCenter`.

Solo lectura.

## Request body

- object
  - `start` integer: Índice desde el cual consultar. Por defecto 0.
  - `limit` integer: Cantidad de resultados a retornar. Máximo 30, por defecto 30.
  - `order_direction` 'ASC' | 'DESC': Dirección de ordenamiento: ASC (por defecto) o DESC.
  - `order_field` 'id' | 'name' | 'code' | 'status': Campo por el cual ordenar.
  - `status` 'active' | 'inactive': Filtra por estado del centro de costo.
  - `name` string: Filtra por nombre (búsqueda parcial).
  - `metadata` boolean: Incluir metadatos (total de registros) en la respuesta.

## Response `200`

Lista de centros de costos

## 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)