Authentication & Connection Tools ​

These two tools answer questions you ask before doing real work: who am I authenticated as, and which Entra tenants are configured. They never modify anything and are always safe to call.

auth_whoami ​

Returns the authenticated caller's identity as carried in the JWT — tenant ID, user ID, role, and group memberships. Use it to confirm Claude is connected to the right InfraScout tenant and operating with the role you expect.

Use cases. Verify connectivity right after configuring an MCP client. Confirm you are operating against the intended tenant when you have access to multiple. Check whether you have the Operator or Admin role required for a session-scoped action.

Parameters. None.

Example prompt.

"Use the auth_whoami tool to show me my InfraScout identity."

entra_connection_list ​

Lists every Entra ID tenant connection configured for your InfraScout tenant — connection ID, friendly name, type, target Entra tenant ID, and whether the connection is enabled. Credentials are never returned.

You rarely need to call this directly. Every mscloud_* tool resolves the default connection automatically when connection_id is omitted. Reach for entra_connection_list only when the user explicitly asks which tenants are configured, or when you need to target a specific non-default tenant — typically a multi-tenant or GDAP scenario.

Use cases. Show which customer tenants an MSP has connected. Pick a non-default connection_id for a tool call that should run against a specific tenant. Confirm a newly added connection is live before running an assessment against it.

Parameters. None.

Example prompt.

"Which Entra tenants are connected to InfraScout right now?"

Each entry returns the connection_id, friendly name, target entra_tenant_id, an enabled flag, and a type — default for the tenant's primary connection and gdap for delegated admin connections to customer tenants.

TIP

For setup of a new Entra connection, see Connecting Entra ID. For the high-level capability map across the connected tenant, see Microsoft Cloud Tools.