cipp-mcp
Summary: cipp-mcp is an MCP server that gives AI assistants structured, multi-tenant access to CIPP's Microsoft 365 management, reporting, security, and automation capabilities across ~45 tools.
Tenants & users — list tenants, get tenant details, list/search/create/edit users, disable accounts, reset passwords and MFA, revoke sessions, run BEC checks, and inspect MFA status, devices, groups, and sign-in behaviour.
Offboarding — queue CIPP's opt-in offboarding job (forwarding, OOO, license/group/device removal, mailbox conversion, OneDrive sharing revocation, etc.); returns on queue, not completion.
Groups & mailboxes — list/create groups; list mailboxes and their permissions by type; measure mailbox and online-archive sizes per tenant (
list_mailbox_usage, cache-backed, with tenant totals) or per mailbox (get_mailbox_usage, live); set out-of-office replies and email forwarding.Security — list Conditional Access policies and named locations; enumerate enterprise apps/service principals (third-party only by default), including cross-tenant fan-out.
Standards & compliance — list standards and templates, run standards checks, report tenant drift and alignment, create/upsert or delete standard templates, and pull Best Practice Analyser results and domain health (DMARC/DKIM/SPF).
Licensing — report per-tenant license assignments/usage and CSP-wide license inventory.
Monitoring & ops — read audit logs and the alert queue, list and create scheduled tasks, and check API connectivity, version, and application logs.
Read-only actions are safe to call freely; destructive or high-impact tools (create/edit/disable users, offboarding, password/MFA resets, forwarding, OOO, template changes) are flagged and should be confirmed first.
CIPP MCP Server
MCP (Model Context Protocol) server for CIPP — the CyberDrain Improved Partner Portal. Provides AI assistants with structured access to CIPP's M365 multi-tenant management capabilities.
Features
49 tools across 12 categories
Tenant, user, group, and mailbox management
Mailbox and online-archive size reporting, per tenant or per user
Per-user Entra ID sign-in logs (status, location, Conditional Access, MFA)
Security: Conditional Access policies, named locations, Microsoft Secure Score
Standards & compliance: BPA, domain health, drift detection
License reporting (per-tenant and CSP-wide)
Alerts, audit logs, and scheduled tasks
GDAP role and invite management
Stdio and HTTP transport modes
MCP Gateway compatible
Related MCP server: action1-mcp
Prerequisites
Node.js 18+
A running CIPP deployment
CIPP API Key (generated from CIPP Settings → API Client Management)
Installation
Via npm (once published)
npx cipp-mcpFrom source
git clone https://github.com/WYRE-AI/cipp-mcp
cd cipp-mcp
npm install
npm run buildConfiguration
Set these environment variables (or copy .env.example to .env):
Variable | Required | Description |
| Yes | Your CIPP Azure Function App URL (e.g. |
| One of | Static Bearer token. Use this or the OAuth trio below. |
| One of | Entra tenant ID that owns the CIPP API-client app registration. |
| One of | OAuth client ID issued by CIPP's API Client Management page. |
| One of | OAuth client secret paired with |
| No | Override OAuth scope. Default: |
| No | When no explicit scope is set, retry a CIPP HTTP 401 once with the legacy |
| No | Override OAuth token endpoint (sovereign clouds only). |
| No |
|
| No |
|
| Yes for HTTP | Service-to-service secret shared with the gateway. HTTP logs an error and exits non-zero when this is empty, whitespace, or a known placeholder ( |
| No | Set to exactly |
| No | Bind address when |
| No | Port for HTTP mode (default: 8080) |
| No |
|
CIPP_BASE_URL must be the Azure Function App URL — the CIPP-API backend,
https://<function-app-name>.azurewebsites.net — not the Static Web App /
custom-domain UI URL (e.g. https://cipp.yourdomain.com). The SWA's built-in
auth intercepts bearer tokens and redirects them to its interactive login page,
so every API call fails. Find the Function App (named like cippXXXXX) in your
CIPP resource group in the Azure Portal.
/health stays unauthenticated and does not read credentials. The stdio transport does not use CONDUIT_S2S_SECRET.
HTTP authentication
With MCP_TRANSPORT=http and CONDUIT_S2S_SECRET set, every /mcp request must include X-Gateway-S2S. The header value is t=<unix seconds>,v1=<hex>, where v1 is the hex-encoded HMAC-SHA256 of the ASCII string t=<unix seconds> keyed with CONDUIT_S2S_SECRET. The timestamp must be within 300 seconds of the server clock. A missing or invalid header is HTTP 401, before CIPP credentials are read. The secret is never written to logs.
X-Gateway-S2S: t=1710000000,v1=<64 lowercase hex chars>In AUTH_MODE=gateway, /mcp also requires x-base-url plus either x-api-key or all of x-tenant-id, x-client-id, and x-client-secret (x-token-scope, x-token-url, and x-token-scope-fallback are optional). Those headers are the only CIPP credential source for that request. A request missing them is HTTP 401 and does not use CIPP_* from the process environment.
AUTH_MODE=env still requires a valid X-Gateway-S2S header, then uses CIPP_* from the environment.
Local HTTP without a secret is development-only. It binds 127.0.0.1 even when MCP_HTTP_HOST is 0.0.0.0 or another non-loopback address:
MCP_TRANSPORT=http MCP_ALLOW_INSECURE_DEV=1 npm run devDocker
The image listens on 0.0.0.0 inside the container (MCP_HTTP_HOST) and defaults to AUTH_MODE=gateway. Publish the port on loopback and pass the same S2S secret the gateway uses. In gateway mode, CIPP credentials arrive on each request as headers; they are not read from the environment.
docker build -t cipp-mcp .
docker run --rm \
-e CONDUIT_S2S_SECRET="$CONDUIT_S2S_SECRET" \
-p 127.0.0.1:8080:8080 \
cipp-mcpCompose refuses to start when CONDUIT_S2S_SECRET is unset. The cipp-mcp service is gateway mode: it sets AUTH_MODE=gateway, publishes 127.0.0.1:8080:8080, and does not set CIPP_API_KEY, CIPP_CLIENT_ID, CIPP_CLIENT_SECRET, CIPP_TENANT_ID, CIPP_BASE_URL, or env_file.
CONDUIT_S2S_SECRET="$CONDUIT_S2S_SECRET" docker compose upSingle-tenant HTTP (AUTH_MODE=env) still requires the S2S secret, then uses CIPP_*:
docker run --rm \
-e CONDUIT_S2S_SECRET="$CONDUIT_S2S_SECRET" \
-e AUTH_MODE=env \
-e CIPP_BASE_URL=https://cippXXXXX.azurewebsites.net \
-e CIPP_TENANT_ID=your-entra-tenant-id \
-e CIPP_CLIENT_ID=your-client-id \
-e CIPP_CLIENT_SECRET=your-client-secret \
-p 127.0.0.1:8080:8080 \
cipp-mcpUsage with Claude Desktop
Add to your claude_desktop_config.json:
{
"mcpServers": {
"cipp": {
"command": "node",
"args": ["/path/to/cipp-mcp/dist/entry.js"],
"env": {
"CIPP_BASE_URL": "https://cippXXXXX.azurewebsites.net",
"CIPP_TENANT_ID": "your-entra-tenant-id",
"CIPP_CLIENT_ID": "your-client-id",
"CIPP_CLIENT_SECRET": "your-client-secret"
}
}
}
}Note:
CIPP_BASE_URLmust be the Azure Function App URL (.azurewebsites.net), not the frontend SWA URL (.azurestaticapps.netor your custom domain). The SWA enforces browser-based auth and will redirect all API requests to a Microsoft login page.
Tools
Category | Tools |
Tenants | list_tenants, get_tenant_details |
Users | list_users, create_user, edit_user, disable_user, reset_password, reset_mfa, revoke_sessions, offboard_user, bec_check, list_mfa_users, list_user_devices, list_user_groups, list_user_signin_logs |
Groups | list_groups, create_group |
Mailboxes | list_mailboxes, list_mailbox_permissions, list_trusted_blocked_senders, list_mailbox_usage, get_mailbox_usage, set_out_of_office, set_email_forwarding |
Security | list_conditional_access_policies, list_named_locations, get_secure_score, list_secure_score_controls |
Applications | list_enterprise_apps |
Standards | list_standards, run_standards_check, list_standard_templates, get_tenant_drift, get_tenant_alignment, create_standard_template, delete_standard_template, list_bpa, list_domain_health |
Licenses | list_licenses, list_csp_licenses |
Alerts | list_audit_logs, list_alert_queue |
GDAP | list_gdap_roles, list_gdap_invites |
Scheduler | list_scheduled_items, add_scheduled_item |
Core | ping, get_version, list_logs |
Editing a user right after creating it
edit_user first resolves the account's current UPN, because CIPP's
Invoke-EditUser rebuilds the UPN from username + Domain on every call and
editing without it would rename the account. Graph can lag a few seconds behind
a just-created account, so when that lookup finds nothing, answers HTTP 404, or
fails with a 5xx whose body is Graph's not-found (the Request_ResourceNotFound
code, or Graph's "Resource '' does not exist or one of its queried
reference-property objects are not present" message), it is retried up to 4 attempts in total, waiting 1s, 3s and
6s (~10s). The decision uses the HTTP status, not message text; any other 4xx
(400, 401, 403) and other 5xx are not retried. If the user still isn't visible
the error says "Tried N times" and, when the last attempt got an HTTP error,
its status; wait a moment and retry.
Mailbox and archive sizes
list_mailbox_usage reports every mailbox in a tenant — primary size, item
count, quota, percent of quota, and the same four figures for the online
archive — sorted largest first, with tenant-wide totals that cover every
mailbox even when only the top rows are returned.
It requires CIPP's reporting database to have been synced for that tenant.
This is not a design choice: Invoke-ListMailboxes' live Exchange query selects
no size fields at all, so the cache is the only tenant-wide source of sizes.
Sync it from CIPP under Reports → Report Settings. If it has not been synced the
tool says so and names the remedy rather than returning an empty result.
get_mailbox_usage reports the same figures for a single mailbox and reads
live, so it needs no cache. Prefer it when the cache is unavailable or stale.
Two caveats worth knowing:
Concealed report names blank the tenant-wide sizes. With Reports: conceal user, group, and site names enabled in the Microsoft 365 admin centre, Graph's usage report returns 32-character hashes instead of UPNs, so CIPP's join against the mailbox list matches nothing and every mailbox caches a size of
0— a tenant that reads as empty rather than as failed.list_mailbox_usagedetects this and returns a warning alongside the totals.get_mailbox_usageis unaffected: it reads the Exchange admin API directly.Sizes are gigabyte-rounded on the per-user path. CIPP rounds to two decimal places of a gigabyte before returning, so
get_mailbox_usagebyte counts are accurate to roughly 10 MB. Quotas are exact — they are recovered from the rawGet-Mailboxstring, which carries the true byte count.
User sign-in logs
list_user_signin_logs returns one user's most recent interactive sign-ins,
newest first: time, app, IP, location, success or failure with error code and
reason, client app, Conditional Access status and the policies that evaluated,
the authentication methods Graph recorded (first factor included — whether
MFA was required is authenticationRequirement), device, and risk when
flagged — plus a summary of failures, distinct IPs and countries.
Accepts a UPN or an object id, and always resolves it first. CIPP filters Graph on
userId, which is the Entra object id; a UPN there matches nothing and returns an empty page that reads as "this user never signs in". An unresolvable user is an error, not an empty result.One tenant, one user, one page.
topdefaults to 50 and caps at 1000; a full page carries a warning that older sign-ins may exist.allTenantsis rejected — the endpoint has no all-tenants branch. Tenant-wide sign-ins are CIPP's Sign-Ins report (ListSignIns), which this server does not expose.Needs Entra ID P1/P2 in the tenant. Graph refuses sign-in log API access otherwise; the tool names the licence gap instead of relaying a generic "Failed to retrieve Sign In report".
Microsoft Secure Score
get_secure_score returns one tenant's latest Secure Score and its recent
daily history. list_secure_score_controls returns the recommendation
catalog: titles, rank, max points, cost, remediation, threats, and any
decision to mark a control resolved by a third party or ignored.
CIPP has no dedicated Secure Score read endpoint. The only Secure Score HTTP
function is ExecUpdateSecureScore, which updates a control and is not
exposed here. Both tools call ListGraphRequest, which is what CIPP's own
Secure Score page does, with Endpoint set to security/secureScores or
security/secureScoreControlProfiles.
One tenant.
allTenantsis rejected. CIPP's estate view is the nightly score cache, not a live Graph call, and these tools do not read that cache.toplimits history only when pagination is turned off.ListGraphRequesttreats$topas Graph's page size and follows every next link unlessNoPaginationis set.get_secure_scorealways sends both, sotop(default 7, maximum 90) is the number of daily readings returned. The control catalog leaves pagination on, with a page size of 999, so the full list comes back.An empty result is not a score of zero. A tenant that has not been scored yet, or whose CIPP app is missing
SecurityEvents.Read.All, comes back as no reading with a warning. A permission denial names that Graph permission instead of a generic CIPP HTTP 400.Comparisons are matched by
basis. "All tenants" isAllTenantsand "similar tenants" isTotalSeats. Those figures are already percentages. The percentage of the tenant's own score iscurrentScore / maxScore, and it is omitted when the maximum is missing rather than reported as 0%.
CIPP version compatibility
Request bodies are shaped against CIPP's own Invoke-*.ps1 handlers and are
written to satisfy both current and older CIPP builds — where the two differ,
the server sends the form both accept. Three behaviours are worth knowing:
offboard_userreports queued, not completed. CIPP'sExecOffboardUserreturns HTTP 200 the instant the job is created; it never waits for or reports the offboarding result. Confirm the outcome in CIPP's Offboarding view before treating an account as offboarded. The tool refuses a call with no actions selected, since that would otherwise queue a job that succeeds while doing nothing.Some endpoints report failure under HTTP 200.
EditUser,AddScheduledItemandExecOffboardUserreturn error text inResultsrather than an error status. These tools parseResultsand returnstatus: "failed"; do not treat a 200 as success.Two parameters need a recent CIPP.
offboard_user'sDisableOneDriveSharingandset_out_of_office'stimezoneare ignored by older builds rather than erroring — so an offboarding that selects onlyDisableOneDriveSharingwill run no actions on an older CIPP.
Authentication Setup
CIPP's API Client Management page provisions an Entra ID app registration and returns an OAuth client ID + client secret (not a long-lived Bearer token). The server exchanges these for a short-lived access token on each request using the OAuth 2.0 client-credentials flow, and caches the token until just before its expiry.
In CIPP, go to Settings → CIPP Settings → Integrations → CIPP-API
Create a new API client
Copy the Client ID and Client Secret — you will not be able to retrieve the secret later
Configure the server with the Function App URL (see below):
CIPP_BASE_URL=https://cippXXXXX.azurewebsites.net CIPP_TENANT_ID=<your-entra-tenant-id> CIPP_CLIENT_ID=<client-id-from-cipp> CIPP_CLIENT_SECRET=<client-secret-from-cipp>
If you already have a static Bearer token (older CIPP deployments), set
CIPP_API_KEY instead and leave the OAuth variables unset. When both are
provided, CIPP_API_KEY wins.
The access token is requested for api://<clientId>/.default. That is the
Application ID URI CIPP's App Service authentication allows. A token requested
for the bare <clientId>/.default scope has its aud set to the client id
GUID, and App Service auth rejects it with HTTP 401 and an empty body.
Deployments that still expect that legacy audience are handled automatically:
when no explicit scope is configured, a 401 is retried once with the other
automatic audience (api://<clientId>/.default or <clientId>/.default).
The audience that succeeds is reused for later calls from the same client.
If that audience later starts failing with 401, the pin is dropped and the
other audience is tried once, then whichever succeeds is remembered again.
The retry does not run for any other status (403, 500, and so on), and a
single request never tries more than once. Set CIPP_TOKEN_SCOPE to force
a scope, or CIPP_TOKEN_SCOPE_FALLBACK=false (alias TOKEN_SCOPE_FALLBACK,
gateway header x-token-scope-fallback) to skip the retry.
Finding your Function App URL
CIPP runs as an Azure Static Web App (SWA) backed by an Azure Function App.
The SWA URL (your custom domain or *.azurestaticapps.net) enforces browser-only
auth and cannot be used as CIPP_BASE_URL. Use the Function App URL instead.
Self-hosted CIPP: Find the Function App in the Azure portal (look for an App Service
with Kind: functionapp in the same resource group as your SWA), or run:
az staticwebapp show --name <your-swa-name> --resource-group <rg> \
--query "linkedBackends[0].backendResourceId" -o tsvCIPP-sponsored hosting: Contact the CIPP team for your instance's Function App URL — it is not the same as the URL shown in your browser.
IP Allowlist
CIPP validates each API client against an IPRange field stored in Azure Table Storage.
If your server's public IP is not in this list, you will receive:
Access to this CIPP API endpoint is not allowed, the API Client does not have the required permission
Self-hosted: Add your IP via the CIPP UI (Settings → API Client Management) or
directly in the ApiClients table of your CIPP storage account.
CIPP-sponsored hosting: Ask the CIPP team to add your server's public IP to your API client's allowed range.
License
Apache-2.0 — see LICENSE
Contributing
Issues and PRs welcome. This server is tracked against wyre-technology/msp-claude-plugins#24.
Available Tools
49 toolscipp_add_scheduled_itemC
Create a new scheduled task
Inputs: command (required), taskName (required), scheduledTime (required), parameters, +2 more.
cipp_bec_checkB
Run a Business Email Compromise check on a user
Inputs: userId (required), tenantFilter (required).
cipp_create_groupADestructiveIdempotent
⚠ HIGH-IMPACT. Creates a new group in the tenant, which can be used for security policy assignments (RBAC, Conditional Access) or mail distribution. Reversible by deleting the group. Confirm with the user before invoking.
Inputs: displayName (required), tenantFilter (required), description, mailEnabled, +2 more.
cipp_create_standard_templateAIdempotent
⚠ HIGH-IMPACT. Creates or updates a CIPP Standards Template (upsert by GUID). A template assigned to tenants with any Remediate-action standard WILL modify those tenants on the next standards run. Confirm with the user before invoking.
Inputs: template (required).
cipp_create_userADestructiveIdempotent
⚠ HIGH-IMPACT. Creates a new user account in the tenant, which grants directory presence and may include initial credentials and license/role eligibility. Reversible by deleting or disabling the user. Confirm with the user before invoking.
Inputs: password (required), displayName (required), tenantFilter (required), userPrincipalName (required), +5 more.
cipp_delete_standard_templateADestructive
⚠ HIGH-IMPACT. Permanently deletes a CIPP Standards Template by ID. Tenants assigned to it lose the standards it enforced. Confirm with the user before invoking.
Inputs: templateId (required).
cipp_disable_userADestructiveIdempotent
⚠ HIGH-IMPACT. Disables a user account, blocking sign-in. Reversible by re-enabling the account. Confirm with the user before invoking.
Inputs: userId (required), tenantFilter (required).
cipp_edit_userADestructiveIdempotent
⚠ HIGH-IMPACT. Edits an existing user's properties, which can include directory attributes, usage location, and may grant or revoke roles or license eligibility. Reversible by editing again. Confirm with the user before invoking. CIPP rebuilds the UPN from the account's current username + domain on every edit, so the current UPN is always resolved first (editing without it would rename the account). That lookup is retried for ~10s when the user is not found yet, because a just-created account can lag in Microsoft Graph.
Inputs: userId (required), tenantFilter (required), jobTitle, licenses, +4 more.
cipp_get_mailbox_usageA
Report the primary mailbox size and online-archive size for a single mailbox, with item counts, quotas and percent-of-quota. Reads live from Exchange, so unlike cipp_list_mailbox_usage it needs no CIPP report-cache sync and still returns real sizes for a tenant that conceals names in its Microsoft 365 usage reports.
Inputs: upn (required), tenantFilter (required).
cipp_get_secure_scoreARead-only
Read a tenant's Microsoft Secure Score live: latest points, percentage of the maximum, comparison with all tenants (basis AllTenants) and similarly sized tenants (basis TotalSeats), the control-by-control achievement on that latest reading (lowest completion first), and the recent daily history newest-first. There is no dedicated CIPP list endpoint — this calls ListGraphRequest with Endpoint security/secureScores. top defaults to 7 and caps at 90; it is sent with NoPagination so it limits the series instead of only setting Graph's page size. allTenants is rejected (CIPP's estate view is the nightly cache, not this call). An empty collection is reported as no reading, never as a score of zero. Changing a control's state is not this tool.
Inputs: tenantFilter (required), top.
cipp_get_tenant_alignmentARead-only
Report each tenant's alignment percentage against its assigned Standards Templates — the key signal for deciding which standards are safe to promote to Remediate. Omit tenantFilter to report on all tenants.
Inputs: tenantFilter.
cipp_get_tenant_detailsC
Get detailed information about a specific tenant
Inputs: tenantFilter (required).
cipp_get_tenant_driftARead-only
Report standards drift — settings that deviate from a tenant's assigned Standards Template. Omit tenantFilter to report drift across all tenants.
Inputs: tenantFilter.
cipp_get_versionA
Get CIPP version information
Inputs: no named parameters.
cipp_list_alert_queueA
List queued alerts across all tenants
Inputs: no named parameters.
cipp_list_audit_logsC
List audit log entries for a tenant
Inputs: tenantFilter (required), days, type.
cipp_list_bpaC
Get Best Practice Analyser results for a tenant
Inputs: tenantFilter (required).
cipp_list_conditional_access_policiesB
List Conditional Access policies for a tenant
Inputs: tenantFilter (required).
cipp_list_csp_licensesB
List all CSP licenses across tenants
Inputs: no named parameters.
cipp_list_domain_healthB
Check domain health (DMARC, DKIM, SPF) for a tenant
Inputs: tenantFilter (required).
cipp_list_enterprise_appsA
List enterprise applications (service principals) in a tenant — including third-party SaaS apps that customers have integrated via OAuth (Slack, Salesforce, Zoom, etc.). Returns appId, displayName, publisher, owner-org, signInAudience, tags, and creation date. Use tenantFilter='allTenants' for cross-tenant fan-out — CIPP handles per-tenant errors inline, so a 403 from one opt-out tenant returns as an error row rather than failing the call. Excludes Microsoft-built-in apps by default (owner org f8cdef31-…); pass includeBuiltIn=true to include them.
Inputs: tenantFilter (required), includeBuiltIn.
cipp_list_gdap_invitesA
List pending GDAP relationship invites
Inputs: no named parameters.
cipp_list_gdap_rolesB
List available GDAP (Granular Delegated Admin Privileges) roles
Inputs: no named parameters.
cipp_list_groupsC
List groups in a tenant
Inputs: tenantFilter (required), search.
cipp_list_licensesB
List license assignments and usage for a tenant
Inputs: tenantFilter (required).
cipp_list_logsC
List CIPP application logs
Inputs: dateFilter.
cipp_list_mailboxesC
List mailboxes in a tenant
Inputs: tenantFilter (required), type.
cipp_list_mailbox_permissionsB
List permissions on a specific mailbox
Inputs: upn (required), tenantFilter (required).
cipp_list_mailbox_usageA
Report mailbox and online-archive sizes across a tenant, largest first, with tenant-wide totals. Each mailbox reports bytes used, a human-readable size, item count, quota and percent-of-quota, for both the primary store and the archive. Answers 'who is near quota', 'which mailboxes need archiving', and 'how much Exchange storage does this tenant use'. Sizes come from CIPP's reporting database, which must have been synced — the live Exchange query carries no size data at all. For one mailbox, or when the cache is unavailable, use cipp_get_mailbox_usage.
Inputs: tenantFilter (required), limit, sortBy, minSizeGB.
cipp_list_mfa_usersB
List users and their MFA status in a tenant
Inputs: tenantFilter (required).
cipp_list_named_locationsA
List named locations (trusted IPs) for a tenant
Inputs: tenantFilter (required).
cipp_list_scheduled_itemsC
List scheduled tasks in CIPP
Inputs: no named parameters.
cipp_list_secure_score_controlsARead-only
List a tenant's Microsoft Secure Score control profiles — the recommendation catalog, not the achievement. Each profile includes title, category, rank, max points, implementation cost, user impact, remediation, threats, compliance mappings, and any non-default state updates (resolved by a third party, or ignored / risk accepted). Calls ListGraphRequest with Endpoint security/secureScoreControlProfiles. Use cipp_get_secure_score for the current score and which controls are complete. allTenants is rejected. Read-only; CIPP's ExecUpdateSecureScore write is not exposed.
Inputs: tenantFilter (required).
cipp_list_standardsB
List compliance standards configured for a tenant
Inputs: tenantFilter (required).
cipp_list_standard_templatesARead-only
List the CIPP Standards Templates configured across the partner tenant.
Inputs: no named parameters.
cipp_list_tenantsB
List all tenants managed in CIPP
Inputs: allTenants.
cipp_list_trusted_blocked_sendersA
List a mailbox's safe-sender (trusted) and blocked-sender entries from its Exchange Online junk email settings. Read-only; returns an empty list when the mailbox has none configured, which is normal, not an error.
Inputs: upn (required), tenantFilter (required).
cipp_list_user_devicesB
List devices enrolled by a user
Inputs: userId (required), tenantFilter (required).
cipp_list_user_groupsC
List groups a user is a member of
Inputs: userId (required), tenantFilter (required).
cipp_list_usersC
List users in a tenant
Inputs: tenantFilter (required), searchField, searchValue.
cipp_list_user_signin_logsARead-only
List one user's most recent interactive Entra ID sign-ins, newest first. Each row gives the time, app and resource, IP address, location, success/failure with the error code and failure reason, client app, Conditional Access status and the policies that evaluated, authentication requirement (whether MFA was required) and the authentication methods/steps Graph recorded, first factor included, device, and risk when flagged — plus a summary of failures, distinct IPs and countries. Answers "why can't this user sign in", "was this account used from somewhere unexpected", and "did MFA/CA apply". Accepts a UPN or Entra object id; a UPN is resolved to the object id first, because the upstream filter matches object ids only. One tenant and one user per call. Requires Entra ID P1/P2 in the tenant. For tenant-wide sign-ins this is the wrong tool — use CIPP's Sign-Ins report (ListSignIns).
Inputs: userId (required), tenantFilter (required), top.
cipp_offboard_userADestructive
⚠ DESTRUCTIVE — IRREVERSIBLE. Queues CIPP's offboarding job for a user. Every action is opt-in: at least one must be enabled or the call is rejected. Returns once the job is QUEUED — CIPP reports success on task creation, not completion, so confirm the outcome in CIPP's Offboarding view before reporting the account as offboarded. Confirm with the user before invoking.
Inputs: userId (required), tenantFilter (required), OOO, forward, +22 more.
cipp_pingA
Check CIPP API connectivity
Inputs: no named parameters.
cipp_reset_mfaADestructiveIdempotent
⚠ HIGH-IMPACT. Resets all MFA methods for a user, requiring them to re-register their authentication methods. Reversible by re-enabling MFA. Confirm with the user before invoking.
Inputs: userId (required), tenantFilter (required).
cipp_reset_passwordADestructiveIdempotent
⚠ HIGH-IMPACT. Resets a user's password, invalidating their current password. CIPP always generates the new password itself (a caller cannot choose one) and returns it in the response, or a PWPush link if PWPush is enabled in CIPP, so treat the response as a secret. Optional mustChange (default false) sets forceChangePasswordNextSignIn so the user must change the password at next sign-in. The previous password cannot be restored; resetting again issues another new one. Confirm with the user before invoking.
Inputs: userId (required), tenantFilter (required), mustChange.
cipp_revoke_sessionsADestructiveIdempotent
⚠ HIGH-IMPACT. Revokes all active sessions for a user, forcing them to re-authenticate. Reversible by the user signing in again. Confirm with the user before invoking.
Inputs: userId (required), tenantFilter (required).
cipp_run_standards_checkC
Trigger a standards compliance check for a tenant
Inputs: tenantFilter (required).
cipp_set_email_forwardingADestructiveIdempotent
⚠ HIGH-IMPACT. Configures email forwarding on a mailbox, silently redirecting the user's incoming mail to another address. This is a common data-exfiltration vector. Reversible by removing the forwarding rule. Confirm with the user before invoking.
Inputs: upn (required), tenantFilter (required), keepCopy, forwardTo.
cipp_set_out_of_officeADestructiveIdempotent
⚠ HIGH-IMPACT. Configures the out-of-office / auto-reply for a mailbox, which causes automated messages to be sent to internal and/or external senders. Reversible by disabling the auto-reply. Confirm with the user before invoking.
Inputs: upn (required), state (required), tenantFilter (required), endTime, +9 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 49 tools
Most tools target distinct resource+action pairs, and the long descriptions actively disambiguate close pairs (cipp_list_mailbox_usage vs cipp_get_mailbox_usage, cipp_get_secure_score vs cipp_list_secure_score_controls, cipp_get_tenant_drift vs cipp_get_tenant_alignment). The remaining friction is in the user-signal cluster (cipp_list_users, cipp_list_mfa_users, cipp_list_user_signin_logs) and the log family (cipp_list_logs vs cipp_list_audit_logs), which an agent could still mis-pick without reading carefully.
Nearly everything follows a uniform cipp_<verb>_<noun> snake_case pattern with no case mixing. Minor deviations exist: cipp_bec_check inverts to noun_verb, and cipp_ping / cipp_get_version lack a resource noun, but these are few and still readable.
49 tools is heavy for a single server, sitting just under the point where the surface becomes unmanageable. The breadth is partly earned — tenant admin, user lifecycle, mailbox, groups, GDAP, standards, secure score, scheduling, and logging are genuinely distinct domains — but it is still well past a comfortable scope.
Read coverage is broad and the write surface covers most high-risk user actions (create, edit, disable, reset password/MFA, revoke sessions, offboard). However, there are notable dead ends: disable_user has no matching enable/re-enable tool, groups can be created but not deleted or modified, and scheduled items can be added but not edited or removed.
Maintenance
Related MCP Connectors
Hosted MCP servers for MSP tools: ConnectWise, NinjaOne, Microsoft 365, SentinelOne, Pax8 and more.
MCP Server for agents to onboard, pay, and provision services autonomously with InFlow
An MCP server that provides an API to LLMs to manage their JumpCloud resources.
MCP server for Appcircle mobile CI/CD platform.
Related MCP Servers
- AlicenseNot gradedqualityBmaintenanceAn MCP server for Datto BCDR (Business Continuity and Disaster Recovery), enabling management of backup jobs, restore points, and disaster recovery operations through Datto's API.Apache 2.0
- AlicenseAqualityBmaintenanceAn MCP server for Action1, a cloud-native RMM platform, enabling remote monitoring, patch management, and endpoint management through Action1's API.65Apache 2.0
- AlicenseAqualityBmaintenanceAn MCP server for SuperOps PSA/RMM, enabling MSPs to manage tickets, assets, clients, and field technician operations through SuperOps's API.223Apache 2.0
- AlicenseNot gradedqualityBmaintenanceAn MCP server for Blackpoint Cyber MDR platform, enabling management of security monitoring, threat detection, and incident response through Blackpoint's API.Apache 2.0