Quilt Mcp Server

Configure Quilt catalog URL - Quilt authentication and catalog navigation workflows WORKFLOW: 1. Map friendly catalog names (demo, sandbox, open) to their canonical URLs if applicable. 2. Validate that the provided/resolved URL includes an HTTP(S) scheme. 3. Persist the catalog setting through ``QuiltOps.configure_catalog``. 4. Return confirmation and recommended actions (login, status check, exploration tools). Args: catalog_url: Full catalog URL (e.g., ``https://demo.quiltdata.com``) or friendly name (e.g., ``demo``). Returns: Dict with ``status``, the normalized catalog URL, and follow-up instructions for login verification. Response format: { "status": "success", "catalog_url": "https://demo.quiltdata.com", "configured_url": "https://demo.quiltdata.com", "next_steps": ["Login with: quilt3 login", "..."] } Next step: Run ``quilt3 login`` (or instruct the user to do so) and confirm connectivity via ``auth.auth_status()``. Example: ```python from quilt_mcp.tools import catalog # Using a full URL outcome = catalog.catalog_configure("https://nightly.quilttest.com") # Using a friendly name outcome = catalog.catalog_configure("demo") if outcome["status"] == "success": login_hint = outcome["next_steps"][0] ```

Build Quilt+ URI - Quilt authentication and catalog navigation workflows WORKFLOW: 1. Normalize the registry to ``quilt+s3://{bucket}``. 2. Append package fragments (``package``, ``path``, ``catalog``) based on the supplied context. 3. Return the URI so downstream tools or clients can reference the same package version consistently. Args: registry: Registry backing the URI (``s3://bucket`` or bucket name). package_name: Optional ``namespace/package`` for linking to a specific package. path: Optional package or bucket path fragment to include in the URI. top_hash: Optional immutable package hash to lock the reference to a revision. tag: Optional human-friendly tag (ignored when ``top_hash`` is provided). catalog_host: Optional catalog hostname hint to embed in the fragment. Returns: CatalogUriSuccess with the computed Quilt+ URI when successful, or CatalogUriError on failure. Success response: { "success": True, "status": "success", "quilt_plus_uri": "quilt+s3://example-bucket#package=team/pkg@1111abcd&path=data/raw", "bucket": "example-bucket", "package_name": "team/pkg", "path": "data/raw", "top_hash": "1111abcd", "tag": null, "catalog_host": "catalog.example.com" } Next step: Combine ``result.quilt_plus_uri`` with ``catalog.catalog_url`` when the user needs both shareable link formats, or return it directly so the client can persist the protocol URI. Example: ```python from quilt_mcp.tools import catalog result = catalog.catalog_uri( registry="s3://example-bucket", package_name="team/forecast", top_hash="1111abcd", path="models/best.pkl", ) if isinstance(result, CatalogUriSuccess): print(result.quilt_plus_uri) ```

Generate Quilt catalog URL - Quilt authentication and catalog navigation workflows WORKFLOW: 1. Detect or accept the catalog host and assemble the fully qualified URL. 2. Return structured metadata (bucket, view type, path) so follow-up tools can reason about the link. 3. Pair with ``auth.catalog_uri`` when the user also needs the Quilt+ URI representation. Args: registry: Target registry, either ``s3://bucket`` or bare bucket name. package_name: Optional ``namespace/package`` for direct package view navigation. path: Optional path inside the bucket or package for deep links (e.g., ``data/metrics.csv``). catalog_host: Optional override for the catalog host when auto-detection is unavailable. Returns: CatalogUrlSuccess with URL metadata when successful, or CatalogUrlError on failure. Success response: { "success": True, "status": "success", "catalog_url": "https://catalog.example.com/b/bucket/packages/ns/pkg/tree/latest/data", "view_type": "package", "bucket": "bucket", "package_name": "ns/pkg", "path": "data", "catalog_host": "catalog.example.com" } Next step: Share ``result.catalog_url`` with the user or feed it into the next navigation helper (for example ``auth.catalog_uri`` or messaging back to the MCP client). Example: ```python from quilt_mcp.tools import catalog result = catalog.catalog_url( registry="s3://example-bucket", package_name="team/forecast", path="reports/summary.pdf", ) if isinstance(result, CatalogUrlSuccess): print(result.catalog_url) ```

List S3 buckets accessible to authenticated user - Bucket discovery and access verification This tool queries the Quilt platform to retrieve the list of buckets that the authenticated user has permission to access. The list includes bucket metadata such as titles, descriptions, and tags configured in the platform. Returns: BucketListSuccess on success with list of bucket configurations, BucketListError on failure with error details. Next step: Use the returned bucket names with other bucket tools like bucket_objects_list to explore bucket contents. Example: ```python from quilt_mcp.tools import buckets result = buckets.bucket_list() if result.success: for bucket in result.buckets: print(f"Bucket: {bucket.name} - {bucket.title}") # Next step: Use bucket names with bucket_objects_list to explore contents ```

Fetch binary or text data from an S3 object - S3 bucket exploration and object retrieval tasks Args: s3_uri: Full S3 URI to the object max_bytes: Maximum bytes to read (1 byte to 10MB) base64_encode: Return binary data as base64 (true) or attempt text decoding (false) Returns: BucketObjectFetchSuccess on success with object data (base64 or text), BucketObjectFetchError on failure with error details. Version-specific Error Responses: - InvalidVersionId: Generic error with operation details - NoSuchVersion: "Version {versionId} not found for {s3_uri}" - AccessDenied (with versionId): "Access denied for version {versionId} of {s3_uri}" Next step: Use the returned S3 metadata to answer the user's question or pass identifiers into the next bucket tool. Example: ```python from quilt_mcp.tools import buckets result = buckets.bucket_object_fetch(s3_uri="s3://my-bucket/file.bin") # Next step: Use the returned S3 metadata to answer the user's question or pass identifiers into the next bucket tool. ```

Check authentication status and catalog configuration

Get catalog configuration details

Check filesystem permissions and writability

List all users in the Quilt registry with their roles and status (requires admin privileges)

List all available roles in the Quilt registry (requires admin privileges)