# SQAI — deterministic, read-only structured data

> SQAI — deterministic, read-only structured data is a freemium MCP server for analytics and data. Read-only, replayable structured-data queries for AI agents over local files and databases. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $25 a month
- **Platforms:** CLI, self-hosted
- **Website:** https://sqai.com
- **Repository:** https://github.com/thyn-ai/sqai-mcp
- **MCP Registry name:** io.github.thyn-ai/sqai
- **Categories:** analytics and data, databases
- **Listing updated:** 2026-11-17

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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

## 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

- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [Midplane](https://ai-powered.com/mcp/midplane): Midplane is an open-source MCP server for databases.
- [World Monitor](https://ai-powered.com/mcp/world-monitor): World Monitor is a freemium MCP server for analytics and data.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.
- [Quantivex Research](https://ai-powered.com/mcp/quantivex-research): Quantivex Research is a free MCP server for finance and payments.

---
Source: https://ai-powered.com/mcp/sqai-deterministic-read-only-structured-data
