Inforcer Tenant Management

Inforcer Tenant Management

Tenants are the top-level scope in Inforcer. Alignment, secure score, identity inventory, audit, and assessment calls are all scoped to a single managed tenant. Knowing how to enumerate tenants and resolve a friendly name to its integer Client Tenant ID is the first step in almost every Inforcer workflow.

Read api-patterns first for the gateway headers, the region requirement, the envelope, and pagination.

Anti-triggers

• CIPP's tenant list — CIPP manages the same M365 tenants but keys them by domain or GUID in tenantFilter. An identifier from one will not work in the other, and the two portfolios can legitimately differ. Use cipp-tenants.
• Onboarding, offboarding, or changing a tenant — Inforcer's tenant surface is read-only; there is no tenant CRUD here.
• A "tenant" in an MDR or SIEM product — Blackpoint and Blumira use the same word for a customer scope that has nothing to do with M365 baselines. Use blackpoint-multi-tenant-operations or blumira-msp.

Tools

inforcer_tenants_list

List every Microsoft 365 tenant Inforcer manages. Returns tenant objects including the integer Client Tenant ID, display name, the default/primary domain, and (where present) the Azure AD tenant GUID.

inforcer_tenants_list()

Use this whenever a user refers to a client by name — the response is how you resolve that name to the integer Client Tenant ID needed by every tenant-scoped tool. Page through continuationToken until it is absent so the list is complete.

The Client Tenant ID gotcha (reinforced)

Inforcer's tenant-scoped paths take an integer Client Tenant ID — not the Azure AD GUID and not the domain.

The MCP server resolves friendly names, DNS domains, and Azure AD GUIDs to the integer Client Tenant ID for you. You can therefore say "scope to Contoso" — but under the hood the path is the integer id. When a tenant-scoped call returns nothing, the usual cause is a GUID or domain that never got mapped to the integer id. Re-run inforcer_tenants_list and confirm the resolution. Never guess the tenant identifier.

Region is required

Every Inforcer call depends on INFORCER_REGION (us, uk, eu, or anz) because the upstream host is region-specific. If inforcer_tenants_list returns empty or 401/403, confirm the region matches the region your API key belongs to before assuming the tenant list is genuinely empty.

Common patterns

Resolve a friendly name → Client Tenant ID

tenants = inforcer_tenants_list()
acme = next(t for t in tenants if 'acme' in t['displayName'].lower())
client_tenant_id = acme['clientTenantId']   # integer

Pass client_tenant_id to alignment, secure score, identity, audit, and assessment tools.

Build a portfolio loop

List once, then iterate every tenant's integer Client Tenant ID for fleet-wide reports (drift roll-ups, posture scorecards). Always page continuationToken to completion first — a partial tenant list silently drops clients from the report.

Failure modes

• Empty tenant list — most often a region mismatch (INFORCER_REGION points at the wrong host) or a key with no tenant scope. Confirm region and key scope before concluding there are no managed tenants.
• Tenant-scoped call returns nothing for a known client — a GUID or domain reached the path instead of the integer Client Tenant ID. Re-resolve via inforcer_tenants_list.
• GUID looks "close enough" — it is not. The path needs the integer id; the GUID and domain are only inputs to resolution.

Caveats

• Inforcer's API is community-sourced (no official public docs); field names like clientTenantId are illustrative and credited to royklo/InforcerCommunity. Verify the exact field on first use.
• There is no tenant create/edit/delete via this API — tenant management here is read-only enumeration and resolution.

Related Skills

• api-patterns - headers, region, envelope, pagination, and the id gotcha in depth
• baseline-alignment - read a tenant's alignment and per-policy drift once scoped
• compliance-reporting - roll a tenant's posture into a portfolio view
• assessments - trigger an assessment for a scoped tenant