User reference (preview)

Note

Features in this article are powered by the standard harness, which uses the billing options described in Licensing for agents powered by the standard harness. Learn how to access standard features in Access standard agents and agent flows.

Important

This is a preview feature.

• Microsoft releases preview features before an official release so that customers can get early access and provide feedback.
• Preview features have restricted functionality and aren't meant for production use.
• Microsoft might change preview MCP tool names and parameters. Avoid hard-coded dependencies. Microsoft maintains scenario support.
• Preview features are subject to Microsoft supplemental terms of use.

Overview

Server ID	Tenant-level URL	Display name	Description
mcp_MeServer	https://agent365.svc.cloud.microsoft/agents/ tenants/{tenantId}/servers/mcp_MeServer	User	Tools for self-knowledge and organizational awareness. Use this tool to access user profiles in your organization and perform various actions such as getting your profile, a user's profile, a user's manager, or direct reports.

Available tools

mcp_graph_getDirectReports

Lists the direct reports of a specified user in the directory. You must provide either the user's object ID (GUID) or their userPrincipalName (email-like UPN). Don't use me as the userIdentifier.

Required parameters:

• userIdentifier: User's object ID (GUID) or userPrincipalName (UPN)

Note

Don't send me as userIdentifier. If only display name is available, first look up the user to obtain userPrincipalName or object ID.

Optional parameters:

• select: Comma-separated list of properties to return (for example, id, displayName, mail, jobTitle, userPrincipalName)
• top: Number of items to return per page

mcp_graph_getMyManager

Retrieves the manager of the signed-in user (the caller). This endpoint always returns the manager of the current user context.

Optional parameters:

• select: Comma-separated list of manager properties to return

mcp_graph_getMyProfile

Retrieves the profile details of the signed-in user (the caller). This endpoint always returns the profile of the current user context.

Optional parameters:

• select: Comma-separated list of user profile properties
• expand: Expand related tables (for example, manager, directReports)

mcp_graph_getUserProfile

Retrieves a specified user's profile in the directory. You must provide either the user's object ID (GUID) or their userPrincipalName (email-like UPN). Don't use me as the userIdentifier. For the signed-in user, use mcp_graph_getMyProfile.

Required parameters:

• userIdentifier: User's object ID (GUID) or userPrincipalName (UPN)

Note

Don't send me. If only the display name is available, first look up the user.

Optional parameters:

• select: Comma-separated list of user properties to return
• expand: Expand a related table (manager OR directReports). You can expand only one property per request.

mcp_graph_getUsersManager

Retrieves the manager of a specified user in the directory. Provide either the user's object ID (GUID) or their userPrincipalName (email-like UPN). Don't use me as the userIdentifier. For the signed-in user, use mcp_graph_getMyManager.

Required parameters:

• userIdentifier: User's object ID (GUID) or userPrincipalName (UPN)

Note

Don't send me. If only the display name is available, first look up the user.

Optional parameters:

• select: Comma-separated list of properties to return for the manager, such as id, displayName, mail, jobTitle, userPrincipalName

mcp_graph_listUsers

Retrieves a list of users in the organization. Supports query options like $select, $filter, $top, $orderby. The default ConsistencyLevel is eventual.

Optional parameters:

• top: Show only the first n users
• select: Comma-separated list of user properties to return
• filter: Filter users by property, such as startswith(displayName,'A')
• orderby: Order results by given property, such as displayName
• search: Free-text search for users. Format: "property:value", such as displayName:Neha to search display names containing Neha. Supports multiple properties with spaces. Fallback rule: If $search fails or returns no results, automatically retry with $filter.
• count: Include count of items (true or false)
• ConsistencyLevel: Required header for advanced queries (default: eventual)

Key features

Self-knowledge

• Get the signed-in user's profile.
• Get the signed-in user's manager.
• Access current user context information.
• No need for user identifiers.

User profiles

• Retrieve any user's profile by ID or UPN.
• Access user properties like displayName, mail, jobTitle, and more.
• Expand related tables such as manager and directReports.
• Select properties by using $select.

Organizational hierarchy

• Get a user's manager.
• Get a user's direct reports.
• Navigate the reporting structure.
• Manager and direct report relationships.

User discovery

• List users in the organization.
• Free-text search with automatic fallback.
• OData filtering and ordering.
• Pagination support.
• Count users in results.

Query capabilities

• OData $select for property selection.
• OData $filter for user filtering.
• OData $expand for related entities.
• OData $orderby for sorting.
• Free-text $search with fallback.
• Eventual consistency support.

Notes

• Use mcp_graph_getMyProfile for the signed-in user, not mcp_graph_getUserProfile with me.
• Use mcp_graph_getMyManager for the signed-in user's manager.
• userIdentifier must be object ID (GUID) or userPrincipalName (UPN), don't use display name.
• If only display name is available, use mcp_graph_listUsers to look up the user first.
• $expand can only expand one property per request (manager or directReports).
• $search has automatic fallback to $filter if search fails.
• ConsistencyLevel eventual required for advanced queries.
• Search format: "property:value" with quotes.

Common use cases

Get my information

• Use mcp_graph_getMyProfile to get the current user's profile.
• Use mcp_graph_getMyManager to get the current user's manager.

Find a user

• Use mcp_graph_listUsers with the search parameter.

  Example: search='"displayName:John"' to find users named John.

• Get userPrincipalName or object ID from results.

Get user details

• Use mcp_graph_getUserProfile with userIdentifier.
• Use select to get specific properties.
• Use expand to include manager or directReports.

Get organizational structure

• Use mcp_graph_getUsersManager to get a user's manager.
• Use mcp_graph_getDirectReports to get a user's direct reports.
• Chain calls to navigate reporting hierarchy.