Listar beneficiarios Global66

Libreta de beneficiarios registrados en Global66, con su beneficiaryId y global66Contact.


Tool ID	`global66.beneficiarios.listar`
Nombre MCP	`global66__beneficiarios__listar`
Conector	`global66`
Plano	`action`
Scope (permiso)	`global66:read`
Auth	`connection_credentials`
Versión	`1`
Sensible	no
Deprecado	no
Comportamiento	readOnly=true, destructive=false, idempotent=true, openWorld=true

Requiere conexión. Indica cuál en cada llamada: header X-Connect-Connection en REST y campo connectionId en el execute de MCP. No hay resolución implícita, ni siquiera con una sola conexión activa: la conexión es la empresa. El id sale de conexiones.estado.consultar.

Qué hace

Global66 no permite crear beneficiarios por API ni MCP.

Entrada

Campo	Tipo	Requerido	Descripción
`currency`	string	no	Moneda del beneficiario.
`country`	string	no	País ISO alfa-2.
`search`	string	no	Texto por nombre.
`document`	string	no	Documento del beneficiario.
`documentType`	string	no	Tipo de documento.
`accountNumber`	string	no	Número de cuenta.
`limit`	entero 1-200	no	Máximo 200; Global66 usa 50 por defecto.

JSON Schema de entrada

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "currency": {
      "description": "Moneda del beneficiario.",
      "type": "string"
    },
    "country": {
      "description": "País ISO alfa-2.",
      "type": "string"
    },
    "search": {
      "description": "Texto por nombre.",
      "type": "string",
      "maxLength": 100
    },
    "document": {
      "description": "Documento del beneficiario.",
      "type": "string"
    },
    "documentType": {
      "description": "Tipo de documento.",
      "type": "string"
    },
    "accountNumber": {
      "description": "Número de cuenta.",
      "type": "string"
    },
    "limit": {
      "description": "Máximo 200; Global66 usa 50 por defecto.",
      "type": "integer",
      "minimum": 1,
      "maximum": 200
    }
  }
}

Salida

Campo	Tipo	Requerido	Descripción
`datos`	valor	null	sí

JSON Schema de salida

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "datos": {
      "anyOf": [
        {
          "anyOf": [
            {
              "type": "object",
              "propertyNames": {
                "type": "string"
              },
              "additionalProperties": {}
            },
            {
              "type": "array",
              "items": {}
            }
          ]
        },
        {
          "type": "null"
        }
      ],
      "description": "Respuesta de la tool MCP de Global66 sin reinterpretar."
    }
  },
  "required": [
    "datos"
  ],
  "additionalProperties": false
}

Errores de esta tool

Código	HTTP	Reintentable	Qué hacer
`connection_disabled`	403	no	Reactívala en /connections o usa otra conexión del mismo sistema.
`connection_not_found`	404	no	Usa uno de los connectionId que lista el error, o revisa la conexión en /connections. No hace falta reactivar nada.
`connection_credential_required`	428	no	Crea un enlace con conexiones.enlace.crear (modo reconectar si la conexión ya existe) y pide a la persona que entregue la credencial de nuevo. No reintentes con la credencial anterior.
`connection_busy`	409	sí	Espera unos segundos y reintenta. Es una espera transitoria: no necesitas volver a conectar ni ingresar la credencial otra vez.
`upstream_error`	502	sí	Reintenta más tarde. Si persiste, el problema está en el sistema externo, no en tu integración.
`timeout`	504	sí	Reintenta. Para sincronizaciones largas usa la vía asíncrona y consulta el estado del trabajo.

Toda llamada puede devolver además los códigos transversales (validation_error, unauthorized, scope_not_granted, rate_limited, entre otros): el detalle vive en el catálogo de errores.

Listar beneficiarios Global66

Qué hace

Entrada

Salida

Errores de esta tool

En esta página