Datachain

MCP Tools

Tools exposed by the Studio MCP server. The last column is the token scope and role a tool needs; OAuth sessions get both scopes.

ToolWhat it doesAccess
search_knowledge_baseFull-text search over the generated knowledge of datasets and storagesDatasets: read
list_datasetsList datasets that have a complete version, filtered by namespace and projectDatasets: read
get_datasetReturn a dataset's schema, versions, knowledge page, and up to 5 preview rowsDatasets: read
get_row_contentRead the file a dataset row points to, as an image or textDatasets: read
list_storagesList indexed storage rootsDatasets: read
get_storageReturn an indexed storage's listing statistics and knowledge pageDatasets: read
get_knowledge_baseReturn a Markdown index of enriched datasets and storagesDatasets: read
enrich_datasetGenerate the knowledge page for one dataset, using the team's provider and budgetDatasets: write
enrich_allGenerate pages for every dataset and storage that lacks a current oneDatasets: admin
get_datachain_guideReturn the DataChain SDK rules a run_job script must followJobs: read
list_clustersList the team's compute clusters, default firstJobs: read
run_jobSubmit a Python DataChain script as a Studio jobJobs: write
get_jobReturn a job's settings, status, progress, errors, and produced dataset versionsJobs: read
get_job_logsReturn a job's most recent log linesJobs: read
cancel_jobCancel an active jobJobs: write

Limits

  • get_dataset previews at most 5 rows and truncates each cell to 200 characters.
  • get_row_content reads files from s3://, gs://, az://, and hf:// only, up to 4 MiB; JPG, PNG, GIF, and WebP come back as images, UTF-8 files as text.
  • search_knowledge_base returns at most 50 matches per call; list_datasets at most 200 datasets per page.
  • Requests are rate limited per user and per IP address; a limited request gets HTTP
  • Wait and retry.
  • Knowledge search and the knowledge index cover only datasets and storages with a generated page; enrich_dataset and enrich_all generate pages using the team's provider and budget.

Example prompts

What datasets do we have about product images? Show the schema of the largest one.
Find storages with audio files and summarize what the knowledge base says about them.

The loop that makes an agent and Studio worth combining: a question comes in, no existing column answers it, the agent runs a pass over the files, saves the result as a dataset, and the next person who asks gets it from the store.

Do we already have embeddings for the oxford-pets images?
Which pets in s3://dc-readme/oxford-pets-micro/ were photographed outdoors?
Why did job <job-id> fail? Show the relevant log lines.