Open the interactive Identity Polyarchy — a live relationship graph over Microsoft Entra ID (org hierarchy, groups, shared attributes, roles and app assignments). Call when the user asks to visualize, explore or map identity relationships, or says "open the polyarchy" / "show me the polyarchy around ". With no arguments it opens focused on the signed-in user (delegated modes only — in app-only mode pass search or userId). If search matches several people the tool returns the candidates instead of opening — ask the user which one they mean and call again with that userId (or use polyarchy-search first for names you suspect are common). Once opened the UI is interactive; no further action is needed unless the user asks for something new.

Fetch one node's relationships from Microsoft Graph as a nodes/edges delta. Dimensions for a user node: org (manager chain + direct reports), groups (memberships), access (directory roles + app assignments), attributes (pivot hub for attr). For nodeType group/role, returns members. For nodeType attribute pass attr+value to load the whole cohort. The delta is returned to the caller only — it does not update an open polyarchy canvas (the UI fetches its own data when the user interacts with it).

Search Entra ID users by name or UPN (top 15 matches with core attributes).

Structured JSON report of one user's identity relationships — no UI needed, works headless. Dimensions: org (full manager chain to the root + direct reports), groups (direct memberships with group type — Security / Microsoft 365 / Distribution list / Mail-enabled security — and assigned vs dynamic membership), roles (directory roles), applications (app assignments), attributes (core profile values), or all (default). Use when the user wants analysis, a summary or the underlying data — after exploring the polyarchy visually, or instead of opening it. With no person argument it reports on the signed-in user (delegated modes only). Ambiguous names return candidates — re-call with userId.

Photo for a user as a data: URI (48x48), or null.

A user's manager (core attributes), or null at the top of the chain.

Provide/refresh a Microsoft Graph bearer token when the server runs with USE_CLIENT_TOKEN=true (e.g. EntraPulse passing its own token for seamless SSO). expiresOn is ISO 8601; defaults to the token's exp claim or 1 hour.

Current auth mode, signed-in account, client app id, decoded token scopes/roles, and token expiry (expiresOn + tokenExpiresInMinutes; renewal is silent) — use to diagnose 401/403s and missing consent.