MCP Marketplace
Sign inSign up
Back to Browse

Sqai MCP Server

by Thyn Ai
Developer ToolsLow Risk10.0MCP RegistryLocal
Free

Server data from the Official MCP Registry

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

About

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

Security Report

10.0
Low Risk10.0Low Risk

Valid MCP server (2 strong, 1 medium validity signals). No known CVEs in dependencies. Package registry verified. Imported from the Official MCP Registry.

9 files analyzed · 1 issue found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

file_system

Check that this permission is expected for this type of plugin.

env_vars

Check that this permission is expected for this type of plugin.

Shell Command Execution

Runs commands on your machine. Be cautious — only use if you trust this plugin.

What You'll Need

Set these up before or after installing:

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 registration) or this key — fully offline thereafter.Required

Environment variable: SQAI_API_KEY

Private deployment endpoint; selects deployment mode when present. Optional.Optional

Environment variable: SQAI_DEPLOYMENT_URL

JSON array of SqaiSourceInput (path/URL string, array of row objects, or { "data": …, "name": "…" }). Sources connect lazily on the first tool call. Optional.Optional

Environment variable: SQAI_SOURCES

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-thyn-ai-sqai": {
      "env": {
        "SQAI_API_KEY": "your-sqai-api-key-here",
        "SQAI_SOURCES": "your-sqai-sources-here",
        "SQAI_DEPLOYMENT_URL": "your-sqai-deployment-url-here"
      },
      "args": [
        "-y",
        "@thyn-ai/sqai-mcp"
      ],
      "command": "npx"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub README.

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

LayerPackageWhat 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 SDKsqai (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 contractEmbedded SQAI contractThe generated, hash-pinned inventory of every capability SQAI exposes
Execution substrateAlgenta (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.

ToolWhat it does
listSourcesDiscovery: sources with exact field names, types, and allowed operations; computation-catalog search; per-module signatures.
queryDataOne deterministic, read-only query or computation; truncated results stay retrievable via result_id.
explainQueryDry-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

DocPurpose
docs/quickstart-ts.mdTypeScript quickstart
docs/quickstart-python.mdPython quickstart
docs/ai-sdk-tools.mdTool schemas and truncation contract
docs/determinism.mdHashes, envelopes, "deterministic within the declared execution scope"
docs/licensing.mdFree developer tier, entitlements, runtime bundle trust
SECURITY.mdSecurity policy

Reviews

No reviews yet

Be the first to review this server!

More Developer Tools MCP Servers

Fetch

Free

by Modelcontextprotocol · Developer Tools

Web content fetching and conversion for efficient LLM usage

90.7K
Stars
18
Installs
5.3
Security
5.0
Local

Git

Free

by Modelcontextprotocol · Developer Tools

Read, search, and manipulate Git repositories programmatically

90.7K
Stars
20
Installs
6.5
Security
No ratings yet
Local

Paperclip

Free

by Paperclipai · Developer Tools

Trending hip-hop artist momentum scores across four cultural dimensions.

81.1K
Stars
1
Installs
10.0
Security
No ratings yet
Remote

Toleno

Free

by Toleno · Developer Tools

Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.

224
Stars
799
Installs
8.0
Security
4.8
Local

mcp-creator-python

Free

by mcp-marketplace · Developer Tools

Create, build, and publish Python MCP servers to PyPI — conversationally.

-
Stars
138
Installs
10.0
Security
4.7
Local

MCP Marketplace

Free

by mcp-marketplace · Developer Tools

Search and install MCP servers from inside your AI client.

-
Stars
127
Installs
10.0
Security
5.0
Remote