Listar contactos

Herramienta MCP: contacts_getContacts.

Lista los contactos de la cuenta (clientes, proveedores o ambos) con filtros opcionales y paginación. Los filtros se envían dentro del objeto params (p. ej. {"arguments": {"params": {"type": "client", "limit": 10}}}).

Ejemplo de llamada JSON-RPC:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "contacts_getContacts",
    "arguments": {
      "params": { "type": "client", "limit": 10 }
    }
  }
}

Soporta paginación con start y limit (hasta 30 por página), orden con order_field y order_direction, búsqueda por texto libre con query (nombre, identificación, email, etc.) y coincidencia exacta de documento con identification. Con type filtras por client o provider; con status por active o inactive.

Con metadata: true la respuesta es { metadata: { total }, data: [...] } e incluye el total de contactos que coinciden con los filtros; sin metadata devuelve solo el arreglo de contactos.

Para buscar un contacto cuando ya conoces su nombre, usa contacts_getContactByName.

Solo lectura.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
params
object

Filtros de la búsqueda de contactos.

Responses

401

No autorizado (token de Alegra inválido o expirado).

Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json