set_preferred_location

Set your preferred Kroger store location to streamline grocery shopping operations like product searches and cart management.

Instructions

    Set a preferred store location for future operations.
    
    Args:
        location_id: The unique identifier for the store location
    
    Returns:
        Dictionary confirming the preferred location has been set

Input Schema

TableJSON Schema

Name	Required	Description	Default
`location_id`	Yes

Implementation Reference

src/kroger_mcp/tools/location_tools.py:219-270 (handler)

The primary handler function for the set_preferred_location MCP tool. Decorated with @mcp.tool() for automatic registration. Validates location existence via Kroger API, fetches details, persists via helper function, and returns formatted response.

@mcp.tool()
async def set_preferred_location(
    location_id: str,
    ctx: Context = None
) -> Dict[str, Any]:
    """
    Set a preferred store location for future operations.
    
    Args:
        location_id: The unique identifier for the store location
    
    Returns:
        Dictionary confirming the preferred location has been set
    """
    if ctx:
        await ctx.info(f"Setting preferred location to {location_id}")
    
    # Verify the location exists
    client = get_client_credentials_client()
    
    try:
        exists = client.location.location_exists(location_id)
        if not exists:
            return {
                "success": False,
                "error": f"Location {location_id} does not exist"
            }
        
        # Get location details for confirmation
        location_details = client.location.get_location(location_id)
        loc_data = location_details.get("data", {})
        
        set_preferred_location_id(location_id)
        
        if ctx:
            await ctx.info(f"Preferred location set to {loc_data.get('name', location_id)}")
        
        return {
            "success": True,
            "preferred_location_id": location_id,
            "location_name": loc_data.get("name"),
            "message": f"Preferred location set to {loc_data.get('name', location_id)}"
        }
        
    except Exception as e:
        if ctx:
            await ctx.error(f"Error setting preferred location: {str(e)}")
        return {
            "success": False,
            "error": str(e)
        }

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

Supporting utility function that persists the preferred location ID to kroger_preferences.json file by loading, updating, and saving the preferences dictionary.

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)

src/kroger_mcp/server.py:72-72 (registration)
Invocation of the register_tools function from location_tools module, which defines and registers the set_preferred_location tool (along with other location tools) to the FastMCP server instance.
```
location_tools.register_tools(mcp)
```

Kroger MCP Server