run_select_query

Ejecuta una instrucción SELECT sobre los providers configurados y devuelve las filas del resultado. De solo lectura - no se aceptan mutaciones ni operaciones de ciclo de vida; para ellas, use run_mutation_query o run_lifecycle_operation.

Las filas del resultado se devuelven al cliente, pero se excluyen deliberadamente del log de auditoría.

Consulte también: [ Descripción general de MCP ] [ validate_select_query ] [ list_methods ] [ SELECT en la especificación del lenguaje ]

---

Entradas

Argumento	Obligatorio	Descripción
sql	Sí	Una instrucción SELECT. El control de políticas clasifica las instrucciones de metadatos (SHOW, DESCRIBE, DESC, EXPLAIN) como de solo lectura, por lo que también se aceptan; DESC se reconoce a partir de StackQL v0.12.732.
row_limit	No	Límite del número de filas que se devuelven al cliente. 0 (valor predeterminado) significa que no hay límite en el lado del cliente.
source	No	ID de la entrada de la Query Library cuando el SQL procede de query_library_get. Solo para atribución; no cambia la ejecución ni las aprobaciones.
format	No	Renderizado del texto: markdown o json. Cuando se omite, usa la configuración de renderizado del servidor.

---

Salida

Renderizador	Forma
Tabla	{rows: [...]} - un objeto por fila, con el nombre de la columna como clave

---

Control

Permitida en todos los modos del servidor (read_only, safe, delete_safe, full_access) cuando todas las instrucciones de la carga útil son de solo lectura. A partir de v1.0, esta herramienta rechaza INSERT, UPDATE, REPLACE, DELETE y EXEC en todos los modos, incluido full_access, con un error que indica run_mutation_query o run_lifecycle_operation. Una carga útil que contiene varias instrucciones se clasifica según su instrucción con más privilegios, de modo que una mutación detrás de un SELECT inicial se rechaza de la misma forma. La herramienta declara destructiveHint: false y openWorldHint: true.

---

Ejemplo

Pruebe este prompt con cualquier cliente MCP que admita la elicitación y tenga registrado el servidor MCP de StackQL:

List the VPC networks in my Google Cloud project my-project  
and tell me which ones use auto subnet creation.

Este es un ejemplo en Claude Desktop: