get_preferred_location

Retrieve the currently selected Kroger store location for grocery shopping, enabling personalized product searches and cart management.

Instructions

    Get the currently set preferred store location.
    
    Returns:
        Dictionary containing the preferred location information

Input Schema

TableJSON Schema

Name	Required	Description	Default
No arguments

Implementation Reference

src/kroger_mcp/tools/location_tools.py:271-316 (handler)

The main handler function for the 'get_preferred_location' tool. It retrieves the preferred location ID using a helper, fetches details via the Kroger API client, and returns formatted location information or an error.

@mcp.tool()
async def get_preferred_location(ctx: Context = None) -> Dict[str, Any]:
    """
    Get the currently set preferred store location.
    
    Returns:
        Dictionary containing the preferred location information
    """
    preferred_location_id = get_preferred_location_id()
    
    if not preferred_location_id:
        return {
            "success": False,
            "message": "No preferred location set. Use set_preferred_location to set one."
        }
    
    if ctx:
        await ctx.info(f"Getting preferred location details for {preferred_location_id}")
    
    # Get location details
    client = get_client_credentials_client()
    
    try:
        location_details = client.location.get_location(preferred_location_id)
        loc_data = location_details.get("data", {})
        
        return {
            "success": True,
            "preferred_location_id": preferred_location_id,
            "location_details": {
                "name": loc_data.get("name"),
                "chain": loc_data.get("chain"),
                "phone": loc_data.get("phone"),
                "address": loc_data.get("address", {})
            }
        }
        
    except Exception as e:
        if ctx:
            await ctx.error(f"Error getting preferred location details: {str(e)}")
        return {
            "success": False,
            "error": str(e),
            "preferred_location_id": preferred_location_id
        }

src/kroger_mcp/server.py:72-72 (registration)
Registration of the location_tools module, which includes the get_preferred_location tool via its register_tools function.
```
location_tools.register_tools(mcp)
```

src/kroger_mcp/tools/shared.py:152-156 (helper)

Helper function that loads and returns the stored preferred location ID from the preferences JSON file, used by the get_preferred_location handler.

def get_preferred_location_id() -> Optional[str]:
    """Get the current preferred location ID from preferences file"""
    preferences = _load_preferences()
    return preferences.get("preferred_location_id")

src/kroger_mcp/tools/shared.py:158-163 (helper)

Companion helper function to store the preferred location ID to the preferences file, referenced in related tools.

def set_preferred_location_id(location_id: str) -> None:
    """Set the preferred location ID in preferences file"""
    preferences = _load_preferences()
    preferences["preferred_location_id"] = location_id
    _save_preferences(preferences)

Kroger MCP Server