---
title: "Consultar claves de producto"
method: POST
path: "/tools/config_getProductKeys"
tags: ["Config"]
---

# Consultar claves de producto

`POST /tools/config_getProductKeys`

## Request

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

Herramienta MCP: `config_getProductKeys`.

Devuelve los códigos de claves de producto disponibles para clasificar ítems, con filtros opcionales de búsqueda y cantidad de resultados.

Ejemplo de llamada JSON-RPC:

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "config_getProductKeys",
    "arguments": { "name_contains": "alimentos" }
  }
}
```

Los filtros de búsqueda `name`, `name_contains` y `key` son mutuamente excluyentes: usa solo uno por llamada. Usa `name_contains` para búsquedas amplias y `key` para la consulta exacta de un código. Con `limit` limitas la cantidad máxima de resultados (por defecto 50).

Notas por país:

- Colombia, México, Argentina, Panamá, Perú, España, Venezuela y República Dominicana: solo los parámetros compartidos.
- Costa Rica: `deprecated`, `includeDueDate`, `productType` (valores: `product`, `service`, `kit`, `surtido`) y `tax`.

Úsala para descubrir el código de clasificación correcto antes de crear o actualizar un ítem con las herramientas de ítems.

Solo lectura.

## Request body

- object
  - `name` string: Coincidencia exacta del nombre de la clave de producto. Mutuamente excluyente con name_contains y key.
  - `name_contains` string: Búsqueda por nombre de la clave de producto (sin distinguir mayúsculas ni acentos). Mutuamente excluyente con name y key.
  - `key` string: Coincidencia exacta del código de la clave de producto. Mutuamente excluyente con name y name_contains.
  - `limit` integer: Cantidad máxima de resultados a devolver. Por defecto 50.
  - `deprecated` 'true' | 'false': Filtra por estado de obsolescencia de la clave. Solo Costa Rica.
  - `includeDueDate` 'true' | 'false': Si es true, incluye las claves de producto vencidas. Por defecto false. Solo Costa Rica.
  - `productType` 'product' | 'service' | 'kit' | 'surtido': Filtra por tipo de producto: product, service, kit o surtido. Solo Costa Rica.
  - `tax` string: Filtra por porcentaje de impuesto (por ejemplo 0, 1 o 4). Solo Costa Rica.

## Response `200`

Lista de claves de producto disponibles

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