dlt._workspace.mcp.tools.secrets_tools

secrets_list

@with_mcp_tool_telemetry()
def secrets_list() -> List[Dict[str, Any]]

View source on GitHub

List secret file paths, profiles, and whether each file exists.

secrets_view_redacted

@with_mcp_tool_telemetry()
def secrets_view_redacted(
    path: Annotated[
        Optional[str],
        Field(description=(
            "Absolute path to a specific secrets file (from secrets_list)."
            " Omit to get the unified merged view of all secret files.")),
    ] = None
) -> str

View source on GitHub

Show secrets TOML with every value replaced by '***'.

Without path: returns the unified merged view across all project secret files (read-only, shows effective configuration). With path: returns that single file redacted. Use secrets_list to discover file paths.

secrets_update_fragment

@with_mcp_tool_telemetry()
def secrets_update_fragment(fragment: Annotated[
    str,
    Field(description="TOML fragment to deep-merge into the secrets file"),
], path: Annotated[
    str,
    Field(description=
          "Absolute path to the secrets file to update (from secrets_list)."),
]) -> str

View source on GitHub

Deep-merge a TOML fragment into a secrets file; returns the redacted result. The file is created if it does not exist.