tracker_settings_app_delete

Remove a specific tracker setting for an app to revert it to the global configuration. This tool manages analytics settings in Piwik PRO by deleting app-specific overrides.

Instructions

Delete a specific tracker setting for an app.

    This causes the setting to revert to the global setting.

    Args:
        app_id: UUID of the app
        setting: Name of the tracker setting to delete

    Returns:
        Dictionary containing deletion status:
        - status: "success" if deletion was successful
        - message: Descriptive message about the deletion

Input Schema

TableJSON Schema

Name	Required	Description	Default
`app_id`	Yes
`setting`	Yes

Implementation Reference

src/piwik_pro_mcp/tools/tracker_settings/tools.py:239-254 (handler)

MCP tool handler 'tracker_settings_app_delete' decorated with @mcp.tool, which calls the helper function to perform the deletion.

@mcp.tool(annotations={"title": "Piwik PRO: Delete App Tracker Setting"})
def tracker_settings_app_delete(app_id: str, setting: str) -> OperationStatusResponse:
    """Delete a specific tracker setting for an app.

    This causes the setting to revert to the global setting.

    Args:
        app_id: UUID of the app
        setting: Name of the tracker setting to delete

    Returns:
        Dictionary containing deletion status:
        - status: "success" if deletion was successful
        - message: Descriptive message about the deletion
    """
    return delete_app_tracker_setting(app_id, setting)

src/piwik_pro_mcp/tools/tracker_settings/tools.py:100-112 (helper)

Helper function that executes the core logic: creates Piwik client and calls delete_app_setting API method.

def delete_app_tracker_setting(app_id: str, setting: str) -> OperationStatusResponse:
    try:
        client = create_piwik_client()
        client.tracker_settings.delete_app_setting(app_id, setting)

        return OperationStatusResponse(
            status="success",
            message=f"Tracker setting '{setting}' deleted successfully for app {app_id}",
        )
    except NotFoundError:
        raise RuntimeError(f"App with ID {app_id} or setting '{setting}' not found")
    except Exception as e:
        raise RuntimeError(f"Failed to delete app tracker setting: {str(e)}")

src/piwik_pro_mcp/tools/__init__.py:22-42 (registration)

Registration call to register_tracker_settings_tools(mcp) which registers the tracker_settings_app_delete tool among others.

from .tracker_settings import register_tracker_settings_tools


def register_all_tools(mcp: FastMCP) -> None:
    """Register all MCP tools with the server."""
    register_parameter_discovery_tool(mcp)
    # Register app management tools
    register_app_tools(mcp)

    # Register CDP tools
    register_cdp_tools(mcp)

    # Register Tag Manager tools
    register_tag_tools(mcp)
    register_trigger_tools(mcp)
    register_variable_tools(mcp)
    register_version_tools(mcp)
    register_template_tools(mcp)

    # Register tracker settings tools
    register_tracker_settings_tools(mcp)

Piwik PRO MCP Server