SQAI — deterministic, read-only structured data
Read-only, replayable structured-data queries for AI agents over local files and databases
- 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-mcpAdd 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

Agent-Native Analytics
MCP serverOpen-source analytics app where an AI agent builds charts and dashboards from your data
- Remote
- Open source
- 7.7K GitHub stars
- Analytics and data

Google Ads + Meta Ads + SEO/GEO MCP
MCP serverHosted 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

Tapetide - Indian Stock Market MCP
MCP serverIndian NSE and BSE stock market data for AI assistants through 48 MCP tools
- 17 tools
- Remote
- Freemium
- 150 GitHub stars
- Finance and payments

Midplane
MCP serverPostgres gateway for AI agents with table grants, column masking and approval for writes
Runs locally- Open source
- 5 GitHub stars
- Databases

World Monitor
MCP serverLive geopolitical intelligence dashboard with an API and MCP server for agents
- Remote
- Freemium
- Analytics and data

CompanyData
MCP serverSearch and enrich company records from official registers via the CompanyData API
- 3 tools
- Remote
- Paid
- 3 GitHub stars
- Analytics and data