Skip to content
MCP server

SQAI — deterministic, read-only structured data

Read-only, replayable structured-data queries for AI agents over local files and databases

Runs locallyStatus and history
Pricing
Freemium
Platforms
CLI, self-hosted
Runs
Locally
Version
0.1.20
Listing updated
today

About SQAI — deterministic, read-only structured data

SQAI — deterministic, read-only structured data is a freemium MCP server for analytics and data. It runs locally on your machine and is started by your AI client.

SQAI turns a model's request into a typed plan instead of SQL or code, checks it against a hash-pinned capability contract and your allow-list policy, then runs it on a pinned deterministic runtime. Each answer carries hashes so it can be replayed exactly. There is no raw SQL, no eval and no write path.

The MCP package runs locally over stdio (npx @thyn-ai/sqai-mcp) and exposes the same governed tools as the company's AI SDK package. Listing the tools needs no credentials, but executing one needs a free one-time device login or an SQAI_API_KEY; after that it works offline. Sources are set with SQAI_SOURCES and can be CSV, JSON, records or other files, with private deployments reaching databases such as PostgreSQL or Snowflake.

The free Developer tier covers one device for non-commercial use. Pro is $25 a month for commercial use and three devices, and Team is $99. The code is Apache-2.0 licensed.

Install

Run in a terminal

claude mcp add sqai --env SQAI_API_KEY='<SQAI_API_KEY>' -- npx -y @thyn-ai/sqai-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "sqai": {
      "command": "npx",
      "args": [
        "-y",
        "@thyn-ai/sqai-mcp"
      ],
      "env": {
        "SQAI_API_KEY": "<SQAI_API_KEY>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "sqai": {
      "command": "npx",
      "args": [
        "-y",
        "@thyn-ai/sqai-mcp"
      ],
      "env": {
        "SQAI_API_KEY": "<SQAI_API_KEY>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "sqai": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@thyn-ai/sqai-mcp"
      ],
      "env": {
        "SQAI_API_KEY": "<SQAI_API_KEY>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "sqai": {
      "command": "npx",
      "args": [
        "-y",
        "@thyn-ai/sqai-mcp"
      ],
      "env": {
        "SQAI_API_KEY": "<SQAI_API_KEY>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "sqai": {
      "command": "npx",
      "args": [
        "-y",
        "@thyn-ai/sqai-mcp"
      ],
      "env": {
        "SQAI_API_KEY": "<SQAI_API_KEY>"
      }
    }
  }
}

Configuration

  • SQAI_API_KEYAPI 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.
  • SQAI_DEPLOYMENT_URLPrivate deployment endpoint; selects deployment mode when present. Optional.
  • SQAI_SOURCESJSON array of SqaiSourceInput (path/URL string, array of row objects, or { "data": …, "name": "…" }). Sources connect lazily on the first tool call. Optional.

Tools this server provides (3)

Taken from the project documentation; the running server may differ.

listSources
Discover sources, field names, types and allowed operations
queryData
Run one deterministic read-only query or computation
explainQuery
Dry-run a plan and return its hash and validation

What it does

Typed, policy-checked plans
Models never write SQL or code; plans are checked against an allow-list.
Replayable answers
Results include plan and computation hashes for exact replay.
Read-only by design
No write path, and tools are annotated read-only and idempotent.
Source flexibility
Local files in-process, plus databases via private deployment.
Dry-run explain
Preview the resolved plan and hash before running it.
Truncation handles
Large results stay retrievable through a result_id.

Good for

  • Let an agent query a sales CSV without exposing SQL
  • Audit and replay an AI-generated number
  • Run finance or engineering calculations deterministically
  • Restrict an agent to approved fields and functions

Pricing

Freemium, from $25 a month

Free Developer tier; Pro $25/mo; Team $99/mo; server licences $150 per compute unit/mo

Prices change. Check sqai.com before you buy.

SQAI — deterministic, read-only structured data FAQ

Is it free?

The Developer tier is free for one device and non-commercial use; Pro starts at $25 a month.

Do I need an account?

Listing tools needs none; executing needs a free device login or an API key.

Can it modify data?

No. It has no write path.

What licence is the code?

Apache-2.0.

Is SQAI — deterministic, read-only structured data free?

SQAI — deterministic, read-only structured data has a free plan, with paid plans for more usage or features. Paid plans start at $25 a month.

How do I add SQAI — deterministic, read-only structured data to Claude Code?

Run this command in your terminal: claude mcp add sqai --env SQAI_API_KEY='<SQAI_API_KEY>' -- npx -y @thyn-ai/sqai-mcp

What are the best alternatives to SQAI — deterministic, read-only structured data?

The closest alternatives to SQAI — deterministic, read-only structured data are Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, Tapetide - Indian Stock Market MCP, Midplane and World Monitor.

Alternatives to SQAI — deterministic, read-only structured data

  1. Open-source analytics app where an AI agent builds charts and dashboards from your data

    • Remote
    • Open source
    • 7.7K GitHub stars
    • Analytics and data
  2. Hosted MCP connector for managing Google Ads, Meta Ads, GA4 and Search Console from chat

    • 8 tools
    • Remote
    • Freemium
    • 8.1K GitHub stars
    • Marketing and SEO
  3. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  4. Midplane

    MCP server

    Postgres gateway for AI agents with table grants, column masking and approval for writes

    Runs locally
    • Open source
    • 5 GitHub stars
    • Databases
  5. World Monitor

    MCP server

    Live geopolitical intelligence dashboard with an API and MCP server for agents

    • Remote
    • Freemium
    • Analytics and data
  6. CompanyData

    MCP server

    Search and enrich company records from official registers via the CompanyData API

    • 3 tools
    • Remote
    • Paid
    • 3 GitHub stars
    • Analytics and data