> ## Documentation Index
> Fetch the complete documentation index at: https://docs.attio.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

> Query your workspace data with read-only SQL

Attio exposes your workspace data through a read-only SQL interface so you can answer questions that go beyond what filters and reports allow — joining across objects and lists, aggregating, and running ad-hoc analytical queries.

SQL is only available on the Enterprise plan.

## Ways to query

There are several ways to run SQL against your workspace:

* **REST API:** send a query to the [Query SQL endpoint](/rest-api/endpoint-reference/sql/query-sql) and get results back as JSON.
* **MCP:** the [`query-particle-sql` tool](/mcp/overview#sql) lets AI tools run SQL on your behalf, for natural-language analytical questions.
* **[Data connectors](/sql/data-connectors):** generate database credentials to query your workspace data from external tools.

## Available data

Workspace data is exposed as SQL tables across two queryable schemas: `objects` (one table per object) and `lists` (one table per list entry). See [Available data](/sql/available-data) for what's queryable today and how to discover the schema.

## Limitations

* **Read-only**: only `SELECT` is supported. `INSERT`, `UPDATE`, `DELETE`, and DDL statements are rejected.
* **Query timeout**: the [Query SQL endpoint](/rest-api/endpoint-reference/sql/query-sql) has a 30-second execution timeout, so very complex queries may fail.
* **Rate limits**: the [Query SQL endpoint](/rest-api/endpoint-reference/sql/query-sql) and [`query-particle-sql` MCP tool](/mcp/overview#sql) are subject to rate limits.

These limits may be subject to adjustments in the future.

## Next steps

* [Available data](/sql/available-data) — the schemas and tables you can query, and how to discover them.
* [Querying with SQL](/sql/guides/querying-with-sql) — guidance for writing queries including worked examples.
* [Data connectors](/sql/data-connectors) — create a data connector to query your workspace data from external tools over the PostgreSQL protocol.