---
title: "Listar terceros"
method: POST
path: "/tools/accounting_listThirdParties"
tags: ["Accounting"]
---

# Listar terceros

`POST /tools/accounting_listThirdParties`

## Request

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

Herramienta MCP: `accounting_listThirdParties`.

Lista los terceros (contactos) activos de la compañía con su `id` e `idGlobal`, para identificar los terceros disponibles y resolver los identificadores que requieren los flujos de cierre de cuentas por terceros sin necesidad de conocerlos de antemano.

Ejemplo de llamada JSON-RPC:

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "accounting_listThirdParties",
    "arguments": { "name": "Adrián" }
  }
}
```

`name` es opcional: úsalo para buscar por nombre parcial (por ejemplo "Adrián"); sin `name` devuelve todos los contactos activos. Solo se devuelven contactos con estado activo.

Si hay varios contactos con nombres similares, muéstralos y deja que el usuario elija antes de continuar con el flujo de cierre.

Solo lectura.

## Request body

- object
  - `name` string: Texto para buscar terceros por nombre (parcial). Omítelo para listar todos los activos.

## Response `200`

Lista de terceros activos

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