droid-mcp-network/io.droidmcp.network/GetDataUsageTool

GetDataUsageTool

class GetDataUsageTool(context: Context) : McpTool

Returns mobile (cellular) data usage over a look-back window. Prefers android.app.usage.NetworkStatsManager.querySummaryForDevice which requires the PACKAGE_USAGE_STATS special-access grant; on SecurityException/failure it silently falls back to android.net.TrafficStats cumulative-since-boot totals (which ignore the days window and add a note). Param days (1-90, default 30). Output: bytes_rx, bytes_tx, query_period_days, and note only on the fallback path. Returns ToolResult.error only when even TrafficStats is unsupported.

Constructors

GetDataUsageTool

constructor(context: Context)

Properties

annotations

open override val annotations: ToolAnnotations

description

open override val description: String

name

open override val name: String

parameters

open override val parameters: List<ToolParameter>

Functions

execute

open suspend override fun execute(params: Map<String, Any>): ToolResult