Work IQ User reference (preview)

Overview

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)

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)

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)

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 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 signed-in user, not mcp_graph_getUserProfile with me.
• Use mcp_graph_getMyManager for signed-in user's manager.
• userIdentifier must be object ID (GUID) or userPrincipalName (UPN), don't use display name.
• If only display name 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

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

Find a user

• Usesmcp_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.