app_configuration_kv_read

Retrieve key-value pairs from Azure App Configuration to access application settings and feature flags for dynamic configuration management.

Instructions

Read key-values from Azure App Configuration

Input Schema

TableJSON Schema

Name	Required	Description	Default
`key`	No	The key to read (optional, use * for wildcards, e.g. 'app1/*')
`label`	No	The label filter (optional, use '\0' for no label, '*' for any label)

Implementation Reference

mcp_server_azure/azure_server.py:335-363 (handler)

Core execution logic for the app_configuration_kv_read tool: retrieves Azure App Configuration key-values with optional key/label filters, formats them into a list of dicts, and sets response.

if name == "app_configuration_kv_read":
    # Get key and label from arguments, both optional
    key = arguments.get("key", None)
    label = arguments.get("label", None)
    
    # List key-values with optional filtering by key and label
    if key:
        settings = list(app_config_client.list_configuration_settings(
            key_filter=key,
            label_filter=label
        ))
    else:
        settings = list(app_config_client.list_configuration_settings(
            label_filter=label
        ))
    
    # Format results for display
    result = []
    for setting in settings:
        result.append({
            "key": setting.key,
            "value": setting.value,
            "content_type": setting.content_type,
            "label": setting.label,
            "last_modified": setting.last_modified.isoformat() if setting.last_modified else None,
            "read_only": setting.read_only
        })
    response = {"settings": result}

mcp_server_azure/azure_tools.py:332-348 (schema)

Input schema definition for the app_configuration_kv_read tool, defining optional 'key' and 'label' parameters.

Tool(
    name="app_configuration_kv_read",
    description="Read key-values from Azure App Configuration",
    inputSchema={
        "type": "object",
        "properties": {
            "key": {
                "type": "string",
                "description": "The key to read (optional, use * for wildcards, e.g. 'app1/*')",
            },
            "label": {
                "type": "string",
                "description": "The label filter (optional, use '\\0' for no label, '*' for any label)",
            },
        },
        "required": [],
    },

mcp_server_azure/azure_tools.py:332-348 (registration)

Tool registration in get_app_configuration_tools(), which is included in the server's list_tools() response.

Tool(
    name="app_configuration_kv_read",
    description="Read key-values from Azure App Configuration",
    inputSchema={
        "type": "object",
        "properties": {
            "key": {
                "type": "string",
                "description": "The key to read (optional, use * for wildcards, e.g. 'app1/*')",
            },
            "label": {
                "type": "string",
                "description": "The label filter (optional, use '\\0' for no label, '*' for any label)",
            },
        },
        "required": [],
    },

mcp_server_azure/azure_server.py:91-107 (helper)

Helper method in AzureResourceManager to obtain the AzureAppConfigurationClient instance used by the tool handler.

def get_app_configuration_client(
    self, endpoint: str | None = None
) -> AzureAppConfigurationClient:
    """Get an Azure App Configuration client using AzureCliCredential."""
    try:
        logger.info(f"Creating AzureAppConfigurationClient")
        endpoint = endpoint or os.getenv("AZURE_APP_CONFIGURATION_ENDPOINT")
        if not endpoint:
            raise ValueError(
                "Azure App Configuration endpoint is not specified and not set in the environment."
            )

        return AzureAppConfigurationClient(base_url=endpoint, credential=self.credential)
    except Exception as e:
        logger.error(f"Failed to create AzureAppConfigurationClient: {e}")
        raise RuntimeError(f"Failed to create AzureAppConfigurationClient: {e}")

Azure MCP Server