droid-mcp-location/io.droidmcp.location/GetCurrentLocationTool

GetCurrentLocationTool

class GetCurrentLocationTool(context: Context) : McpTool

Returns the device's location from android.location.LocationManager: the freshest cached fix, or — when no provider has one (e.g. a fresh device where no app has asked yet) — a fresh fix requested from every enabled provider at once, bounded by FRESH_FIX_TIMEOUT_MS. Output key source is "cache" or "fresh". Requires ACCESS_FINE_LOCATION or ACCESS_COARSE_LOCATION. Accepts an accuracy param ("fine" | "coarse", default "coarse") that only reorders the provider preference (GPS/network/fused). Every enabled provider is consulted and the freshest cached fix wins (preference order breaks ties); a SecurityException from one provider (e.g. GPS under a coarse-only grant) just skips it. Output: latitude, longitude, accuracy_meters, altitude, speed_mps, timestamp, provider. Returns ToolResult.error when permission is missing (or every enabled provider refused with a SecurityException), the accuracy value is invalid, or no cached fix exists on any enabled provider.

Constructors

constructor(context: Context)

Properties

annotations

open override val annotations: ToolAnnotations

description

open override val description: String

name

open override val name: String

outputSchema

open override val outputSchema: Map<String, Any>

parameters

open override val parameters: List<ToolParameter>

Functions

execute

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