SQAI — deterministic, read-only structured data

Name: SQAI — deterministic, read-only structured data
Author: thyn-ai

de thyn-aiversión 0.1.20i★ –iSe ejecuta en tu computadora

Nombre en el registroio.github.thyn-ai/sqai

Instalar

Resumen

Descripción del creador (original en inglés)

SQAI MCP server — four governed, deterministic, read-only data tools. Free login to execute.

Los tres pilares de PopNx MCP

Estos tres nunca se combinan en una sola puntuación: las opiniones, las mediciones y la popularidad son cosas distintas.

Opinión de usuariosiAún no hay reseñasLas reseñas se abrirán junto con las cuentas en una etapa posterior
Nuestras revisiones básicasi1 de 1 superadasRevisado con información pública; el código aún no se ha escaneado
UsoiAún sin medir★ –

Qué puedes hacer con él

Todavía no escribimos un resumen sencillo para este. Abajo están los datos que leímos del registro.

Conexión: Se ejecuta en tu computadora
Transporte: stdio
Categoría: Otros
Debes completar: SQAI_API_KEY

Instalación

Elige la app de IA que usas y copia la configuración.

Antes de instalar

Revisiones básicas: 1 de 1 superadas
Se ejecuta en tu computadora con los permisos de tu usuario (archivos, red, apps).
Debes completar tú: SQAI_API_KEY, SQAI_DEPLOYMENT_URL, SQAI_SOURCES

Los valores marcados como secretos son llaves de tu cuenta. Nunca los compartas ni los pegues en un chat.

Necesitas

npmNode.js instalado (para el comando npx)

¿Qué app usas?

ClaudeClaude CodeCursorVS CodeChatGPT

Elige tu app arriba. La recordamos, así que la próxima vez el botón dirá “Instalar en …”.

Abre Claude Desktop → Settings → Developer → Edit Config y pega esto en claude_desktop_config.json

{
  "mcpServers": {
    "sqai": {
      "command": "npx",
      "args": [
        "-y",
        "@thyn-ai/sqai-mcp"
      ],
      "env": {
        "SQAI_API_KEY": "your-value",
        "SQAI_DEPLOYMENT_URL": "your-value",
        "SQAI_SOURCES": "your-value"
      }
    }
  }
}

Ejecuta esto en tu terminal

claude mcp add sqai --env SQAI_API_KEY=your-value --env SQAI_DEPLOYMENT_URL=your-value --env SQAI_SOURCES=your-value -- npx -y @thyn-ai/sqai-mcp

Completa los valores vacíos antes de ejecutarlo.

Abrir en Cursor

O copia la configuración tú

Pégalo en .cursor/mcp.json de tu proyecto, o en ~/.cursor/mcp.json

{
  "mcpServers": {
    "sqai": {
      "command": "npx",
      "args": [
        "-y",
        "@thyn-ai/sqai-mcp"
      ],
      "env": {
        "SQAI_API_KEY": "your-value",
        "SQAI_DEPLOYMENT_URL": "your-value",
        "SQAI_SOURCES": "your-value"
      }
    }
  }
}

Tu navegador te pide permiso para abrir la app; luego la app muestra la configuración y te pide confirmar. Los valores de las claves quedan vacíos para que los completes tú.

Abrir en VS Code

O copia la configuración tú

Pégalo en .vscode/mcp.json de tu proyecto

{
  "servers": {
    "sqai": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@thyn-ai/sqai-mcp"
      ],
      "env": {
        "SQAI_API_KEY": "your-value",
        "SQAI_DEPLOYMENT_URL": "your-value",
        "SQAI_SOURCES": "your-value"
      }
    }
  }
}

Tu navegador te pide permiso para abrir la app; luego la app muestra la configuración y te pide confirmar. Los valores de las claves quedan vacíos para que los completes tú.

Este se ejecuta en tu computadora, y ChatGPT solo puede conectarse a servidores en internet. Elige otra app.

Tu elección se guarda en una cookie en este dispositivo; no necesitas cuenta.

Valores que debes completar

SQAI_API_KEY secreto env
API key for licensing / API mode (semantics owned by @thyn-ai/sqai). Introspection (initialize/tools/list) needs no credentials; executing tools requires a free community login (`sqai login` device r…
SQAI_DEPLOYMENT_URL env
Private deployment endpoint; selects deployment mode when present. Optional.
SQAI_SOURCES env
JSON array of SqaiSourceInput (path/URL string, array of row objects, or { "data": …, "name": "…" }). Sources connect lazily on the first tool call. Optional.

Esta configuración se genera a partir de la ficha del creador en el registro. Si el README dice otra cosa, sigue el README.

Qué puede hacer

Se ejecuta en tu computadora; la lista de herramientas aparece en tu app de IA después de instalarlo.

Revisiones básicasi

Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 7 nov 2026

✓ Superada
El creador coincide con el repo
El nombre en el registro se verificó con la cuenta de GitHub thyn-ai, dueña del repo
… Aún sin revisar
Sigue en mantenimiento
Todavía no hemos leído este repo en GitHub
… Aún sin revisar
Tiene licencia
Todavía no hemos leído este repo en GitHub
– No aplica
El endpoint responde
Este se ejecuta en tu computadora; no hay endpoint en internet
– No aplica
Inicio de sesión con OAuth
Se ejecuta en tu computadora y usa ajustes locales en su lugar
… Aún sin revisar
Sin instrucciones ocultas en las descripciones de herramientas
Se ejecuta en tu computadora; solo podemos leer listas de herramientas de endpoints en internet

Comparado con otros en Otrosi

Más estrellas que el 0% de los otros 32706 servidores de esta categoría
Publicado en el registro más recientemente que el 49% de los otros 32706 servidores de esta categoría
Revisiones básicas iguales o mejores que el 100% de los otros 32706 servidores de esta categoría

Comparado con todos los servidores activos de esta categoría en el registro. Las estrellas solo cuentan cuando quien lo publica es dueño del repo.

Preguntas frecuentes

¿Es seguro SQAI — deterministic, read-only structured data?

Superó 1 de 1 revisiones básicas aplicables. No hemos leído el código. Antes de agregar una clave o un token, revisa qué acceso pide el servidor y usa una clave que tenga solo los permisos que necesitas.

¿Qué claves o códigos necesita?

Debes completar: SQAI_API_KEY

¿Se ejecuta en mi computadora o en la nube?

Se ejecuta en tu computadora. Tu app de IA lo inicia cuando hace falta, y los datos no pasan por los servidores del creador (a menos que el propio servidor llame a un servicio en línea).

¿Sigue en mantenimiento?

El repo de GitHub cambió por última vez –, y la última versión (0.1.20) llegó al registro hace 43 días.

¿Qué apps pueden usarlo?

Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. También necesitas Node.js en tu computadora.

¿Qué puedo usar en su lugar?

En la misma categoría: Spec Driven Development, Remote Desktop Commander, Kanal Varna — drains, leaks & plumbing (Varna, BG)

Alternativas

Servidores de la misma categoría hechos por otros creadores, ordenados por estrellas.

Cómo leer una tarjeta:★ Estrellas de GitHubiTres pilares: reseñas · revisiones · usoiActualizado = fecha en que se publicó la última versión en el registroi

Spec Driven Development

de formulahendry

MCP Server that facilitates spec-driven development workflows, not just Vibe Coding.

Se ejecuta en tu computadora★ 440MITActualizado hace 14 meses

Instalar

Remote Desktop Commander

de desktop-commander

Remote Desktop Commander: use files, terminal and processes on your own computers from any AI app.

Se ejecuta en la nube★ 211Actualizado anteayer

Instalar

Kanal Varna — drains, leaks & plumbing (Varna, BG)

de kanalvarna.com

Drain unblocking, leak detection & plumbing in Varna, Bulgaria: services, prices, areas, contact

Se ejecuta en la nubeActualizado hoy

Instalar

README del creador

Abrir el README

Copiado tal cual del repo del creador. PopNx MCP no lo ha revisado ni lo respalda. Se quitaron HTML, imágenes y scripts. Los enlaces llevan fuera de este sitio.

SQAI — Structured Query AI

SQAI is the deterministic, read-only structured-data tool for AI agents, with governed execution and replayable provenance.

Apache-2.0 · TypeScript + Python · built on Algenta as the underlying substrate · a Thyn product

The model proposes meaning. SQAI controls execution: typed intent in, policy-checked deterministic execution, replayable results with full provenance out. No raw SQL, no eval, no write path.

Architecture

Layer	Package	What it is
AI SDK tools	`@thyn-ai/sqai-ai-sdk` (npm)	Three Vercel AI SDK 7 tools — `listSources`, `queryData`, `explainQuery`
Product SDK	`@thyn-ai/sqai` (npm)	SQAI query plane + full computation plane
Product SDK	`sqai` (PyPI)	Same SQAI surface, 1:1 vocabulary
CLI	`@thyn-ai/sqai-cli` (npm, bin `sqai`)	`sqai doctor --parity`, `sqai runtime install/verify/status/stop`
Capability contract	Embedded SQAI contract	The generated, hash-pinned inventory of every capability SQAI exposes
Execution substrate	Algenta (exact-pinned)	Underlying deterministic execution substrate and managed signed runtime bundle

Quickstart (AI SDK)

import { generateText } from "ai";

import { createSQAI } from "@thyn-ai/sqai-ai-sdk";

const sqai = createSQAI({ sources: [{ data: "./data/sales.csv", name: "sales" }] });

const { text } = await generateText({ model: "openai/gpt-5-mini", tools: sqai.tools(), prompt: "Which region had the highest total revenue?", });

No server. No daemon for the query plane. The computation plane provisions a signed managed runtime transparently on first use.

MCP server

The same four governed tools are available to any MCP host (Claude Desktop, Cursor, …) as a stdio server — descriptions, Zod schemas, and execute functions are read straight off the AI-SDK tool objects, never forked:

npx @thyn-ai/sqai-mcp

"mcpServers": { "sqai": { "command": "npx", "args": ["-y", "@thyn-ai/sqai-mcp"], "env": { "SQAI_SOURCES": "[{\"data\": \"./data/sales.csv\", \"name\": \"sales\"}]" } } } }

Introspection (initialize / tools/list) needs no credentials — zero environment is a valid configuration. Executing any of the four tools requires a free community login (sqai login once / device registration, or SQAI_API_KEY) — fully offline thereafter; without it every tools/call returns a structured login_required error. SQAI_DEPLOYMENT_URL keeps its usual semantics from @thyn-ai/sqai.

Tool	What it does
`listSources`	Discovery: sources with exact field names, types, and allowed operations; computation-catalog search; per-module signatures.
`queryData`	One deterministic, read-only query or computation; truncated results stay retrievable via `result_id`.
`explainQuery`	Dry-run: resolved plan, `plan_hash`, validation — or a computation-signature check with a preview `invocation_hash`.

All three are annotated readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false. All three execute under the one uniform license gate: free on 1 machine with a one-time device registration (sqai login) — licensing moves a signed token, never your data; without it, every tool call — local CSV reads included — returns a structured login_required error by design.

What works today

Query plane (connect / resolve / query / verify / ask) — in-process, both languages
Full SQAI computation plane behind capability-contract validation
Policy allow-lists (sources, fields, functions) the model can never override
Cross-language conformance: identical values, plan_hash, intent_signature
Model-context truncation with opaque result handles

Repository layout

contracts/        generated capability contract + tested version pair

packages/sdk/ @thyn-ai/sqai (TypeScript product SDK) packages/ai-sdk/ @thyn-ai/sqai-ai-sdk (Vercel AI SDK tools) packages/cli/ sqai CLI (doctor, runtime verbs) packages/mcp/ @thyn-ai/sqai-mcp (MCP stdio server) packages/python-sdk/ sqai (PyPI) examples/ runnable examples (AI SDK registry example) scripts/ contract sync + parity gate docs/ GitBook (docs.sqai.com)

Key documents

Doc	Purpose
docs/quickstart-ts.md	TypeScript quickstart
docs/quickstart-python.md	Python quickstart
docs/ai-sdk-tools.md	Tool schemas and truncation contract
docs/determinism.md	Hashes, envelopes, "deterministic within the declared execution scope"
docs/licensing.md	Free developer tier, entitlements, runtime bundle trust
SECURITY.md	Security policy

SQAI — deterministic, read-only structured data

Resumen

Los tres pilares de PopNx MCP

Qué puedes hacer con él

Instalación

Antes de instalar

Valores que debes completar

Qué puede hacer

Revisiones básicasi

El creador coincide con el repo

Sigue en mantenimiento

Tiene licencia

El endpoint responde

Inicio de sesión con OAuth

Sin instrucciones ocultas en las descripciones de herramientas

Comparado con otros en Otrosi

Preguntas frecuentes

Alternativas

Spec Driven Development

Remote Desktop Commander

Kanal Varna — drains, leaks & plumbing (Varna, BG)

README del creador

SQAI — Structured Query AI

Architecture

Quickstart (AI SDK)

MCP server

What works today

Repository layout

Key documents