---
title: "Listar monedas"
method: POST
path: "/tools/currencies_getCurrencies"
tags: ["Currencies"]
---

# Listar monedas

`POST /tools/currencies_getCurrencies`

## Request

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

Herramienta MCP: `currencies_getCurrencies`.

Devuelve las monedas configuradas en la empresa, paginadas y con filtros opcionales de moneda principal, estado, ordenamiento y selección de campos.

Ejemplo de llamada JSON-RPC:

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "currencies_getCurrencies",
    "arguments": { "start": 0, "limit": 30 }
  }
}
```

Paginación con `start` (desplazamiento desde 0, por defecto 0) y `limit` (de 1 a 80 monedas, 30 por defecto). Filtra por moneda principal de la empresa con `main` (`yes` o `no`) y por estado con `status` (por ejemplo `active` o `inactive`); con `onlyActive` en `true` devuelve solo las monedas activas.

Ordena con `order_field` (por defecto `id`; valores pendientes de verificar con una llamada real) y `order_direction` (`ASC` o `DESC`, `ASC` por defecto). Con `fields` solicitas campos adicionales separados por coma (`deletable`, `canBeInactive`, `autoUpdate`, `idCurrency`) y con `metadata` en `true` la respuesta se envuelve en un objeto con el total de resultados.

Úsala para obtener el catálogo completo de monedas, por ejemplo al consultar tasas de cambio o clasificar documentos en otras monedas. Si solo necesitas la moneda principal de la empresa, usa `currencies_getDefaultCurrency`.

Solo lectura.

## Request body

- object
  - `start` integer: Desplazamiento de paginación (desde 0). Por defecto 0.
  - `limit` integer: Cantidad máxima de monedas a devolver por página, entre 1 y 80. Por defecto 30.
  - `main` 'yes' | 'no': Indica si se incluye la moneda principal de la empresa. Con yes devuelve solo la moneda principal. Por defecto no.
  - `order_field` string: Campo por el cual ordenar. Por defecto id. Valores pendientes de verificar con una llamada real.
  - `order_direction` 'ASC' | 'DESC': Dirección de ordenamiento: ASC o DESC. Por defecto ASC.
  - `fields` string: Campos adicionales a retornar, separados por coma: deletable, canBeInactive, autoUpdate, idCurrency.
  - `metadata` boolean: Si es true, envuelve la respuesta en un objeto con el arreglo de datos y el total de resultados.
  - `status` string: Filtra monedas por estado (por ejemplo active o inactive). Valores pendientes de verificar con una llamada real.
  - `onlyActive` boolean: Si es true, devuelve solo las monedas activas.

## Response `200`

Lista de monedas

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