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

Use search_datasets for a topic or list_datasets for broad discovery.
Call get_dataset_schema before constructing a query.
Use query_dataset with only the columns and rows needed.
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.

Overview

MCP

Data API

Provenance

MCP tools

MCP tools

Recommended sequence

Safety contract

​MCP tools

​Recommended sequence

​Safety contract

MCP tools

Recommended sequence

Safety contract