mcp_parse_record_url

Summary

Field	Value
Tool name	parse_record_url
MCP title	Parse a Dynamics 365 URL to entity and record ID
Category	basic
Implementation	DynamicsCrm.DevKit.Cli/Mcp/Tools/ParseRecordUrlTool.cs
Estimated token count	~194 tokens (tools/list tool JSON, o200k_base, measured 2026-06-18)
Last verified	2026-06-18

MCP Tool Description (Exact)

Extract entity logical name + record ID from a D365/Power Platform URL/GUID. Supports main.aspx (etn/etc), Web API, maker portal, rundialog, workflow/report/solution editor URLs, raw GUIDs. Returns EntityName, RecordId, Source, EnvironmentId (maker only). Auto-resolves etc → entitySetName via Dataverse.

WHEN TO USE:
- User pastes a record URL — extract entity + GUID before calling other tools
- Convert raw GUID to typed reference when context is unknown
- If EntityName='(unknown)', ask user for entity name or fuller URL

Parameters

Name	Type	Required	Default	Description
input	string	Yes	-	URL, GUID, or text (record URL, Web API URL, maker portal URL, raw GUID).

Input Schema

{
  "type": "object",
  "properties": {
    "input": {
      "type": "string",
      "description": "URL, GUID, or text (record URL, Web API URL, maker portal URL, raw GUID)."
    }
  },
  "required": [
    "input"
  ]
}

Related MCP Resources

This tool does not require any MCP resources.

When To Use

• User pastes a record URL — extract entity + GUID before calling other tools
• Convert raw GUID to typed reference when context is unknown
• If EntityName='(unknown)', ask user for entity name or fuller URL

Notes

• Use the exact MCP description and parameter schema above as the authoritative contract.

Example

{
  "input": "string"
}

Output

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

Prompt Examples

• "Parse this model-driven app record URL and return the entity logical name and GUID."
• "Extract the record ID from this Web API URL and resolve the table name."
• "Identify what Dataverse record this pasted maker portal URL refers to."