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

# MCP tools

> The read-only tools exposed by the Soria customer connector.

# MCP tools

The Soria connector exposes one read-only tool set. It does not expose internal administration, ingestion, pipeline, warehouse-management, or mutation tools.

| Tool                      | Use it when                                                                                                                           |
| ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- |
| `list_datasets`           | You need a compact list of datasets available to the signed-in account.                                                               |
| `search_datasets`         | You know the topic, business domain, or likely column but not the dataset name.                                                       |
| `get_dataset_info`        | You need a short description, update cadence, providers, grain, or provenance counts.                                                 |
| `get_dataset_schema`      | You need column names, types, accepted values, methodology, and source lineage before querying.                                       |
| `get_dataset_stats`       | You need row count or a bounded profile of one column without fetching rows.                                                          |
| `list_dataset_files`      | You need the source-file IDs and URLs that contribute through a dataset's recursive lineage.                                          |
| `get_dataset_source_file` | You have a file ID from `list_dataset_files` and need its verified metadata, parsed text, or a short-lived link to the retained file. |
| `query_dataset`           | You need selected columns, structured filters, sorting, and paginated rows from one published dataset.                                |
| `search_documents`        | You need relevant passages from the public source-document corpus behind Soria datasets.                                              |

## Recommended sequence

1. Use `search_datasets` for a topic or `list_datasets` for broad discovery.
2. Call `get_dataset_schema` before constructing a query.
3. Use `query_dataset` with only the columns and rows needed.
4. Use `list_dataset_files` and `get_dataset_source_file` when the answer needs source evidence.

## Safety contract

* Every tool is marked read-only, non-destructive, and idempotent.
* Dataset queries accept structured filters; the connector does not accept arbitrary SQL.
* Results are bounded and may be paginated or truncated.
* Licensed columns remain subject to the signed-in account's entitlements.
* Third-party licensed source files are not redistributed through the connector.

Tool names and response shapes can be refreshed by connector clients. Material behavior changes are reviewed before release.