# Listar propósitos de operación Global66

> Propósitos válidos para preparar una operación MCP; usa el id real.



{/* AUTO-GENERATED by @emisso/codegen. DO NOT EDIT. */}

|                     |                                                                   |
| ------------------- | ----------------------------------------------------------------- |
| **Tool ID**         | `global66.propositos_operacion.listar`                            |
| **Nombre MCP**      | `global66__propositos_operacion__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`](/docs/referencia/conexiones/estado-consultar).

## Entrada [#entrada]

| Campo       | Tipo                   | Requerido | Descripción        |
| ----------- | ---------------------- | --------- | ------------------ |
| `operation` | `"TRANSFER"` · `"P2P"` | sí        | Tipo de operación. |
| `search`    | string                 | no        | Texto a buscar.    |

<details>
  <summary>
    JSON Schema de entrada
  </summary>

  ```json
  {
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "type": "object",
    "properties": {
      "operation": {
        "type": "string",
        "enum": [
          "TRANSFER",
          "P2P"
        ],
        "description": "Tipo de operación."
      },
      "search": {
        "description": "Texto a buscar.",
        "type": "string",
        "maxLength": 100
      }
    },
    "required": [
      "operation"
    ]
  }
  ```
</details>

## Salida [#salida]

| Campo   | Tipo  | Requerido | Descripción |                                                         |
| ------- | ----- | --------- | ----------- | ------------------------------------------------------- |
| `datos` | valor | null      | sí          | Respuesta de la tool MCP de Global66 sin reinterpretar. |

<details>
  <summary>
    JSON Schema de salida
  </summary>

  ```json
  {
    "$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
  }
  ```
</details>

## Errores de esta tool [#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](/docs/referencia/errores).