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.

{
  "params": {
    "order_direction": "ASC",
    "order_field": "name",
    "query": "Acme",
    "identification": "900123456",
    "name": "Acme S.A.S"
  }
}