mcp_manage_environment_variable

Summary

Field	Value
Tool name	manage_environment_variable
MCP title	Manage environment variables
Category	standard
Implementation	DynamicsCrm.DevKit.Cli/Mcp/Tools/ManageEnvironmentVariableTool.cs
Estimated token count	~536 tokens (tools/list tool JSON, o200k_base, measured 2026-06-18)
Last verified	2026-06-18

MCP Tool Description (Exact)

Dataverse environment variables — list/detail/create/update/delete/clear.
- list: optional solution_name, max_records
- detail: variable_name (Display Name or schema name)
- create: solution_name (REQUIRED) + display_name + type. Optional: default_value, value, description
- update: variable_name (Display Name or schema name). Optional: display_name, default_value, value, description
- delete: variable_name (Display Name or schema name; definition + value, irreversible)
- clear: variable_name (Display Name or schema name; current value only → reverts to default)

CREATE uses the publisher prefix from solution_name directly. confirmed_prefix is optional and only validates the resolved prefix when supplied.
solution_name is REQUIRED for create — if not provided by the user, ask; never search or guess.

Current value overrides default. Type immutable after creation. Usually no publish needed.

WHEN TO USE:
- Inspect / list env vars in a solution (config secrets, feature flags, etc.)
- Create or update a definition + current value
- Clear current value to revert to default; delete to remove definition entirely

SAFETY:
- delete removes definition + current value (irreversible); clear removes current value only

Parameters

Name	Type	Required	Default	Description
action	string	Yes	-	list, detail, create, update, delete, clear.
variable_name	string	No	""	Display Name or schema name with prefix (e.g. 'devkit_ApiEndpoint'). Required: detail/update/delete/clear. For create: omit — derived from solution_name publisher prefix.
solution_name	string	No	""	list: filter. create: REQUIRED — used to resolve publisher prefix.
max_records	integer	No	50	list only.
display_name	string	No	""	Required: create.
type	string	No	""	string/number/boolean/json/datasource/secret. Required: create. Ignored: update.
default_value	string	No	""	-
value	string	No	""	Current value (creates/updates value record).
description	string	No	""	-
confirmed_prefix	string	No	""	Optional prefix validation for create. If supplied, it must match the solution publisher prefix.

Input Schema

{
  "type": "object",
  "properties": {
    "action": {
      "type": "string",
      "description": "list, detail, create, update, delete, clear."
    },
    "variable_name": {
      "type": "string",
      "description": "Display Name or schema name with prefix (e.g. 'devkit_ApiEndpoint'). Required: detail/update/delete/clear. For create: omit — derived from solution_name publisher prefix.",
      "default": ""
    },
    "solution_name": {
      "type": "string",
      "description": "list: filter. create: REQUIRED — used to resolve publisher prefix.",
      "default": ""
    },
    "max_records": {
      "type": "integer",
      "description": "list only.",
      "default": 50
    },
    "display_name": {
      "type": "string",
      "description": "Required: create.",
      "default": ""
    },
    "type": {
      "type": "string",
      "description": "string/number/boolean/json/datasource/secret. Required: create. Ignored: update.",
      "default": ""
    },
    "default_value": {
      "type": "string",
      "description": "",
      "default": ""
    },
    "value": {
      "type": "string",
      "description": "Current value (creates/updates value record).",
      "default": ""
    },
    "description": {
      "type": "string",
      "description": "",
      "default": ""
    },
    "confirmed_prefix": {
      "type": "string",
      "description": "Optional prefix validation for create. If supplied, it must match the solution publisher prefix.",
      "default": ""
    }
  },
  "required": [
    "action"
  ]
}

Related MCP Resources

This tool does not require any MCP resources.

When To Use

• Inspect / list env vars in a solution (config secrets, feature flags, etc.)
• Create or update a definition + current value
• Clear current value to revert to default; delete to remove definition entirely

Notes

• SAFETY: delete removes definition + current value (irreversible); clear removes current value only

Example

{
  "action": "string"
}

Output

Returns CallToolResult from the MCP server. The response content and structured fields follow the tool implementation and model returned by ManageEnvironmentVariableTool.manage_environment_variable.

Prompt Examples

• "List environment variables in this solution and show their current values safely."
• "Create a string environment variable for an API endpoint with this default value."
• "Clear the current value for this variable so it falls back to the default."