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} - 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": [], }, - 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}")