mcp_whoami

Summary

Field	Value
Tool name	whoami
MCP title	Get current user and environment info
Category	basic
Implementation	DynamicsCrm.DevKit.Cli/Mcp/Tools/WhoAmITool.cs
Estimated token count	~129 tokens (tools/list tool JSON, o200k_base, measured 2026-06-18)
Last verified	2026-06-18

MCP Tool Description (Exact)

Current user + environment: user (ID, name, email, roles), org (URL, version, friendly/unique name), tenant/env IDs, language, currency, fiscal/audit settings.

WHEN TO USE:
- Confirm connected user/environment.
- Troubleshoot security roles.
- Get user ID for FetchXML owner filters.

Parameters

Name	Type	Required	Default	Description
include_token	boolean	No	false	Include OAuth access token (~400 tokens extra). For direct Web API calls only.

Input Schema

{
  "type": "object",
  "properties": {
    "include_token": {
      "type": "boolean",
      "description": "Include OAuth access token (~400 tokens extra). For direct Web API calls only.",
      "default": false
    }
  },
  "required": []
}

Related MCP Resources

This tool does not require any MCP resources.

When To Use

• Confirm connected user/environment.
• Troubleshoot security roles.
• Get user ID for FetchXML owner filters.

Notes

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

Example

{
  "include_token": true
}

Output

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

Prompt Examples

• "Show the connected Dataverse user, organization, environment ID, and roles."
• "Confirm which environment this MCP server is connected to before I make changes."
• "Check my current user ID and security roles for troubleshooting access."