mcp_manage_webresource

Summary

Field	Value
Tool name	manage_webresource
MCP title	Manage web resources
Category	standard
Implementation	DynamicsCrm.DevKit.Cli/Mcp/Tools/ManageWebResourceTool.cs
Estimated token count	~579 tokens (tools/list tool JSON, o200k_base, measured 2026-06-18)
Last verified	2026-06-18

MCP Tool Description (Exact)

Web resources Dataverse — list/detail/create/update/delete. Required:
- list: optional name, type_filter, solution_name, max_records
- detail: web_resource_id (GUID, Display Name, or unique name)
- create: name + file_path + type + solution_name (REQUIRED). Optional: display_name, description
- update: web_resource_id (GUID, Display Name, or unique name). Optional: file_path, display_name, description
- delete: web_resource_id (GUID, Display Name, or unique name; irreversible)

Types: js, html, css, xml, png, jpg, gif, svg, ico, resx, xsl, xap.
Naming convention: {prefix}_/path/filename.ext (e.g. 'devkit_/entities/Account.form.js').

PREFIX VALIDATION on CREATE: solution_name is required and used to resolve the publisher prefix. The prefix in name must match the solution's publisher prefix (case-insensitive). If they differ, the tool returns [PrefixMismatch] and stops — re-call with the correct prefix.

WHEN TO USE:
- Find library_name for build_form_xml add_event/add_library (run list first)
- Inspect, upload, update, or delete a single web resource
- Combine with build_form_xml + manage_form to wire JS into a form

SAFETY: delete is irreversible; file_path is converted to base64 internally for create/update.

Parameters

Name	Type	Required	Default	Description
action	string	Yes	-	list / detail / create / update / delete.
web_resource_id	string	No	""	GUID, Display Name, or unique name. Required: detail/update/delete.
name	string	No	""	Unique name (e.g. 'devkit_/entities/Account.form.js'). Required: create. list: contains filter across Display Name and unique name.
display_name	string	No	""	-
description	string	No	""	-
file_path	string	No	""	Absolute or relative file path. Required: create. Tool reads file and converts to base64 internally.
type	string	No	""	Required: create. See description for values. Ignored on other actions.
solution_name	string	No	""	list: filter. create: REQUIRED — used to resolve publisher prefix and add WR to solution.
type_filter	string	No	""	list only. See type values.
max_records	integer	No	50	1–500.

Input Schema

{
  "type": "object",
  "properties": {
    "action": {
      "type": "string",
      "description": "list / detail / create / update / delete."
    },
    "web_resource_id": {
      "type": "string",
      "description": "GUID, Display Name, or unique name. Required: detail/update/delete.",
      "default": ""
    },
    "name": {
      "type": "string",
      "description": "Unique name (e.g. 'devkit_/entities/Account.form.js'). Required: create. list: contains filter across Display Name and unique name.",
      "default": ""
    },
    "display_name": {
      "type": "string",
      "description": "",
      "default": ""
    },
    "description": {
      "type": "string",
      "description": "",
      "default": ""
    },
    "file_path": {
      "type": "string",
      "description": "Absolute or relative file path. Required: create. Tool reads file and converts to base64 internally.",
      "default": ""
    },
    "type": {
      "type": "string",
      "description": "Required: create. See description for values. Ignored on other actions.",
      "default": ""
    },
    "solution_name": {
      "type": "string",
      "description": "list: filter. create: REQUIRED — used to resolve publisher prefix and add WR to solution.",
      "default": ""
    },
    "type_filter": {
      "type": "string",
      "description": "list only. See type values.",
      "default": ""
    },
    "max_records": {
      "type": "integer",
      "description": "1–500.",
      "default": 50
    }
  },
  "required": [
    "action"
  ]
}

Related MCP Resources

This tool does not require any MCP resources.

When To Use

• Find library_name for build_form_xml add_event/add_library (run list first)
• Inspect, upload, update, or delete a single web resource
• Combine with build_form_xml + manage_form to wire JS into a form

Notes

• SAFETY: delete is irreversible; file_path is converted to base64 internally for create/update.

Example

{
  "action": "string"
}

Output

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

Prompt Examples

• "List JavaScript web resources in this solution that contain account in the name."
• "Create a new JavaScript web resource from this local file and add it to the solution."
• "Update this web resource content and keep its display name unchanged."