query_documents
Query Documents
Query a selected dataset with GROQ. Call list_projects and manage_datasets to discover scope. Results preserve the query shape; apply explicit GROQ ordering and slices to bound reads.
Ask your agent in plain language. Each of these maps to a real tool on the server.
query_documents
Query a selected dataset with GROQ. Call list_projects and manage_datasets to discover scope. Results preserve the query shape; apply explicit GROQ ordering and slices to bound reads.
manage_webhooks
List, read, create, or delete GROQ-powered document webhooks in an accessible project. Creating a hook can deliver content to its receiver when content changes. Deletion does not erase previously delivered events, queued attempts, or external records.
list_projects
Discover accessible native project IDs and names, or read one project by projectId. Robot tokens are limited by their granted scope; no projects are inferred from token contents.
mutate_documents
Submit document mutations in one native transaction. Discover project/dataset first. Native receipts distinguish accepted operations and dry-run validation; deletion does not promise to erase transaction history, caches, backups, webhooks, or external effects.
upload_asset
Upload bounded base64 image/file bytes into a selected dataset. Returns native assetId content hash and explicit documentId/_id for references and document operations. Identical bytes can reuse an existing asset, and CDN caches can persist after deletion.
manage_datasets
List datasets, read one dataset, create a dataset, or permanently delete a dataset. Call list_projects to select a project. Dataset deletion affects all content and does not promise removal from caches, history, backups, or external deliveries.
get_document
Read exact current document IDs or one historical revision using current access permissions. Discover project and dataset with list_projects and manage_datasets.
download_asset
Prepare the original file or image from an exact Content Lake asset document. Use upload_asset documentId/_id or query_documents to discover asset documents. This excludes Media Library signed/container URLs and transformations.
get_current_user
Read the actual authenticated personal user profile. This endpoint requires a user session and is unavailable to robot tokens; project access does not imply user identity.
Every client uses the same Magic MCP URL, and so does any other MCP client. Add it once and sign in with SSO.
{"mcpServers": {"metorial": {"url": "<your-magic-mcp-url>"}}}
claude mcp add --transport http metorial <your-magic-mcp-url>
codex mcp add metorial --url <your-magic-mcp-url>codex mcp login metorial
One governed layer for every app your agents reach, not a separate connector per tool.
Query and mutate Content Lake documents, discover projects and datasets, read document revisions, manage datasets and document webhooks, upload assets, download original dataset files, and read personal user identity.
Common questions about connecting Sanity to AI agents with Metorial.