How do I use CIPP MCP Server?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@CIPP MCP Server list all tenants and their default domains" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

CIPP MCP Server

by MSPbotsAIFramework

Overview Schema Source Related Servers Discussions Admin

Python

Remote

CIPP MCP Server

An MCP server for the CIPP API (CyberDrain Improved Partner Portal), the console MSPs use to manage many Microsoft 365 tenants through GDAP. It lets an AI agent read tenants, users, groups, mailboxes, conditional access, standards, licences and GDAP data from a CIPP instance and, on explicit request, make changes such as creating or editing users, resetting passwords, offboarding leavers, setting auto-replies or forwarding, and running standards.

Transport: MCP Streamable HTTP at POST /mcp, health probe at GET /health
Stateless and multi-tenant: credentials arrive on every request as HTTP headers and are never stored; OAuth tokens live only for the duration of one request
Python 3.12, uv, FastMCP, httpx
License: Apache-2.0, Copyright 2026 MSPbots.ai

MSPbots Connector

The MCP Gateway built for MSPs: visible, controlled, and your data stays where it belongs.

Get started at connect.mspbots.ai →

MSPbots Connector gives your AI clients one MCP URL to reach your entire MSP stack (RMM, PSA, documentation, security, finance), and gives you control over who can call which tool and a record of everything that was called.

Hosted service: connect.mspbots.ai · Free to use.

Why Connector

MSPbots Connector


Visible	Every tool call is logged: who, which vendor, when. Usage dashboard, CSV export, SIEM streaming.
Controlled	Role-based, per-tool allowlist. Deny by default.
Protected	Credentials encrypted per record. AI clients never see your vendor passwords or tokens.
MSP-native	Built for the MSP stack only: RMM, PSA, documentation, security, finance.

Quick start

Sign up at connect.mspbots.ai.
Connect your vendors. Pick from 150+ connectors and authorize each one on the vendor's own page, or bring your own API keys. No extra vendor accounts needed.
Set access. Create roles and decide which tools each role may call. Nothing is allowed until you allow it.
Add your MCP URL to your AI client. Copy the URL from your Connector dashboard into Claude, ChatGPT, Cursor, VS Code, Gemini, Codex, or any MCP-capable client.
Ask your AI to do real work, and watch every call appear in the audit log.

Features

Unified gateway

One MCP URL for all your AI clients
150+ connectors across the MSP stack
Custom MCP servers supported, free
Authorization happens on each vendor's own page; the AI never sees passwords or tokens
Bring your own credentials: use the vendor API keys you already have
Multiple accounts per app; connect once, reuse across AI clients
Tool search: finds the right action for the task
One sign-in; vendor credentials are injected behind the scenes and OAuth tokens refresh automatically

Visibility

Audit log for every tool call (who, which vendor, when)
Usage dashboard: call volume, top vendors, error rate, per-user activity
Export audit logs to CSV, or stream to Loki, Graylog, or LogScale (SIEM)
Optional recording of tool arguments and result summaries (off by default, enabled per organization)

Control

Per-role, per-tool allowlist, deny by default
owner / admin / member roles
SCIM provisioning with Entra ID, Okta, JumpCloud, and Google Workspace

Security

Credentials encrypted one record at a time (AES-256-GCM, per-record key)
AI clients authenticate with OAuth 2.1 + PKCE
Vendor responses are scanned for prompt-injection patterns and returned as structured data. This is one layer of defense, not a guarantee against every attack.
Static egress IP for customer firewall and API allowlisting

Pricing

Free.

Links: connect.mspbots.ai · mspbots.ai

Related MCP server: proofpoint-essentials-mcp

Authentication headers

X-Base-Url is always required. Then send either X-Api-Key or the three OAuth headers X-Tenant-Id + X-Client-Id + X-Client-Secret.

Header	Required	Type	Default	Allowed values	Description	Example
`X-Base-Url`	Yes	string	none	https URL	URL of the CIPP API backend (Azure Function App)	`https://cipp.example.com`
`X-Api-Key`	One of	string	none	-	A pre-issued bearer token for the CIPP API	`your-cipp-token`
`X-Tenant-Id`	One of	string	none	-	Partner (MSP) Entra tenant id that hosts the CIPP API client	`00000000-0000-0000-0000-000000000000`
`X-Client-Id`	One of	string	none	-	Application (client) id of the CIPP API client	`00000000-0000-0000-0000-000000000000`
`X-Client-Secret`	One of	string	none	-	Client secret of the CIPP API client	`your-client-secret`
`X-Token-Scope`	No	string	`api://{clientId}/.default`	-	Override the OAuth scope (disables the fallback)	`api://00000000-0000-0000-0000-000000000000/.default`
`X-Token-Url`	No	string	`https://login.microsoftonline.com/{tenantId}/oauth2/v2.0/token`	https URL	Override the token endpoint	-
`X-Token-Scope-Fallback`	No	string	on	`0`, `false`, `off`, `no` to disable	Retry once with scope `{clientId}/.default` when the first scope is rejected	`false`

Where to get them:

In CIPP open Settings -> Integrations -> CIPP-API (API client management) and create a new API client. CIPP shows the application (client) id and secret once; copy them together with your partner tenant id. Assign the client a role that covers the tools you want (read-only roles are enough for the list tools).
The base URL must be the CIPP API backend (the Azure Function App URL), not the address of the CIPP web front end.
CIPP checks each API client against its allowed IP range; allow the public egress IP of the environment that runs this server.

How credentials are sent to CIPP: every call is Authorization: Bearer <token> to {X-Base-Url}/api/{Function}. With the OAuth headers the server runs the client-credentials flow against Entra ID first; values that look like unresolved templates (${...}) are treated as missing.

A request to /mcp without the required headers gets HTTP 401 listing them. A non-https URL does not block tools/list; tool calls then return an invalid_argument error and the URL is never called.

Tools

All tools return a JSON string. tenantFilter is a tenant's default domain (for example example.onmicrosoft.com) or tenant id from cipp_list_tenants; tools that say so accept AllTenants. userId accepts an object id or a UPN.

Paging: CIPP returns a whole list at once, so the cipp_list_* tools (except cipp_list_user_signin_logs and cipp_list_mailbox_usage, which keep top / limit) page it here. They take optional offset (from 0) and limit (default: as many records as fit the response size limit) and return {items, count, total, offset, has_more, next_offset}. When CIPP wraps the list (Results, or controls for Secure Score controls) that key is kept instead of items. Pass next_offset as offset for the next page; when a result is cut to fit the size limit, next_offset starts right after the last record returned, so nothing is skipped. Empty values (null, "", [], {}) are left out of each record. cipp_list_users, cipp_list_mfa_users and cipp_list_mailboxes also take fields (comma-separated) to return only those fields.

Tool	Purpose	Parameters (required in bold)
`cipp_ping`	Check the CIPP instance is reachable (no auth check; use cipp_get_version for that)	-
`cipp_get_version`	Get the CIPP frontend/API versions and whether an update is available (also validates credentials)	-
`cipp_list_logs`	List CIPP's own activity log (actions run, standards applied, errors) for one day	dateFilter
`cipp_list_tenants`	List the customer tenants managed through CIPP: name, default domain and tenant id	allTenants
`cipp_get_tenant_details`	Get a tenant's organisation details: verified domains, address, technical contacts, sync settings	tenantFilter
`cipp_list_users`	List users of a tenant, optionally searched by display name (prefix), UPN or mail (exact)	tenantFilter, searchField (`displayName`, `userPrincipalName`, `mail`), searchValue
`cipp_create_user`	Create a Microsoft 365 user in a tenant (write)	tenantFilter, displayName, userPrincipalName, password, givenName, surname, jobTitle, department, country
`cipp_edit_user`	Edit a user's name, job, department, usage location or licences (write)	tenantFilter, userId, displayName, jobTitle, department, usageLocation, licenses, removeLicenses
`cipp_disable_user`	Block sign-in for a user (write)	tenantFilter, userId
`cipp_reset_password`	Reset a user's password; CIPP generates the new one and returns it (write)	tenantFilter, userId, newPassword
`cipp_reset_mfa`	Remove a user's registered MFA methods so they must register again (write)	tenantFilter, userId
`cipp_revoke_sessions`	Sign a user out everywhere by revoking all refresh tokens (write)	tenantFilter, userId
`cipp_offboard_user`	Queue an offboarding job for a leaver with the chosen steps (disable, licences, mailbox, ...) (write)	tenantFilter, userId, DisableSignIn, RevokeSessions, ResetPass, RemoveLicenses, RemoveGroups, RemoveMFADevices, RemoveMobile, RemoveRules, RemoveTeamsPhoneDID, removeCalendarInvites, removePermissions, removeCalendarPermissions, ConvertToShared, HideFromGAL, disableForwarding, DisableOneDriveSharing, ClearImmutableId, DeleteUser, forward, KeepCopy, OOO, AccessAutomap, AccessNoAutomap, OnedriveAccess
`cipp_bec_check`	Run a business-email-compromise check for a user (rules, sign-ins, MFA changes, ...)	tenantFilter, userId, guid
`cipp_list_mfa_users`	List users with their MFA registration and enforcement state (per-user MFA, CA, defaults)	tenantFilter
`cipp_list_user_devices`	List the devices registered to or owned by a user	tenantFilter, userId
`cipp_list_user_groups`	List the groups a user belongs to	tenantFilter, userId
`cipp_list_user_signin_logs`	Get a user's recent interactive sign-ins: time, app, IP, location, result, MFA and CA outcome	tenantFilter, userId, top
`cipp_list_groups`	List groups of a tenant: name, type (security, M365, distribution), mail, membership rule	tenantFilter, search
`cipp_create_group`	Create a group in a tenant (write)	tenantFilter, displayName, description, securityEnabled, mailEnabled, mailNickname
`cipp_list_mailboxes`	List Exchange mailboxes of a tenant: UPN, display name, type, aliases	tenantFilter, type (`UserMailbox`, `SharedMailbox`, `RoomMailbox`, `EquipmentMailbox`)
`cipp_list_mailbox_permissions`	List who has full access, send-as or send-on-behalf permission on a mailbox	tenantFilter, upn
`cipp_list_trusted_blocked_senders`	List a mailbox's personal trusted (safe) and blocked senders and domains. Empty means none set	tenantFilter, upn
`cipp_list_mailbox_usage`	Rank mailboxes by size, archive size or quota use, with tenant totals, from CIPP's daily cache	tenantFilter, sortBy (`mailboxSize`, `archiveSize`, `totalSize`, `percentOfQuota`), limit, minSizeGB
`cipp_get_mailbox_usage`	Get one mailbox's live size, item count, quota use and archive status	tenantFilter, upn
`cipp_set_out_of_office`	Turn a mailbox's automatic replies on, off or on a schedule (write)	tenantFilter, upn, state (`Enabled`, `Disabled`, `Scheduled`), internalMessage, externalMessage, startTime, endTime, timezone, createOOFEvent, oofEventSubject, autoDeclineFutureRequestsWhenOOF, declineEventsForScheduledOOF, declineMeetingMessage
`cipp_set_email_forwarding`	Set or remove mailbox forwarding (internal or external address) (write)	tenantFilter, upn, forwardTo, keepCopy
`cipp_list_conditional_access_policies`	List a tenant's conditional access policies with state, conditions and grant controls	tenantFilter
`cipp_list_named_locations`	List conditional access named locations (trusted IP ranges and countries)	tenantFilter
`cipp_list_enterprise_apps`	List enterprise applications (service principals) consented in a tenant: name, publisher, created	tenantFilter, includeBuiltIn
`cipp_list_domain_health`	Check SPF, DMARC and DKIM records for each custom domain of a tenant	tenantFilter
`cipp_get_secure_score`	Get a tenant's Microsoft Secure Score: latest score and percent, peer averages, daily history (newest first)	tenantFilter (one tenant, not AllTenants), top (1-90, default 7)
`cipp_list_secure_score_controls`	List a tenant's Secure Score improvement actions by rank: category, max points, user impact, cost, tier, short remediation	tenantFilter (one tenant, not AllTenants)
`cipp_list_audit_logs`	List audit-log alert entries CIPP collected for a tenant (sign-in, mailbox rule, admin changes)	tenantFilter, days, type
`cipp_list_alert_queue`	List the alert rules and scheduled alert jobs configured in CIPP	-
`cipp_list_standards`	List the standards applied to a tenant and their settings	tenantFilter
`cipp_run_standards_check`	Run the standards assigned to a tenant now; remediating standards change the tenant (write)	tenantFilter
`cipp_list_standard_templates`	List the standards templates (id, name, assigned tenants, standards)	-
`cipp_get_tenant_drift`	Show where tenants have drifted from their drift-standard templates (accepted / denied deviations)	tenantFilter
`cipp_get_tenant_alignment`	Show how well tenants align with their standards templates (percentage compliant per template)	tenantFilter
`cipp_create_standard_template`	Create a standards template; standards apply to its tenants on the next run (write)	template
`cipp_delete_standard_template`	Delete a standards template (write)	templateId
`cipp_list_bpa`	Get the Best Practice Analyser report for a tenant (older CIPP versions only)	tenantFilter
`cipp_list_licenses`	List a tenant's licence SKUs with purchased, assigned and available counts	tenantFilter
`cipp_list_csp_licenses`	List CSP licence subscriptions bought through the CSP integration for tenants	tenantFilter
`cipp_list_gdap_roles`	List the GDAP role mappings (Entra roles to partner security groups) set up in CIPP	-
`cipp_list_gdap_invites`	List GDAP relationship invites created in CIPP and their status	-
`cipp_list_scheduled_items`	List tasks in CIPP's scheduler: name, command, tenant, next run, state and results	-
`cipp_add_scheduled_item`	Schedule a CIPP command to run once or on a recurrence (write)	taskName, command, scheduledTime, recurrence, tenantFilter, parameters

Errors come back as a JSON envelope instead of an exception:

{"error": {"code": "unauthorized", "message": "CIPP returned HTTP 401 for ListTenants", "retryable": false}}

code is one of not_configured, unauthorized, not_found, invalid_argument, rate_limited, upstream_error. Reads are retried with backoff on 429, 5xx and network errors; writes are retried only on 429, so a write never runs twice.

Run locally

uv sync
uv run python -m cipp_mcp          # listens on 0.0.0.0:8080

or with Docker:

docker build --platform linux/amd64 -t cipp-mcp:dev .
docker run --rm -p 8080:8080 cipp-mcp:dev

Configuration (environment variables, all optional): MCP_HTTP_HOST (default 0.0.0.0), MCP_HTTP_PORT (default 8080), LOG_LEVEL (default INFO). Credentials are never read from the environment.

Testing example

# list tools
curl -s http://localhost:8080/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "X-Base-Url: https://cipp.example.com" \
  -H "X-Tenant-Id: your-partner-tenant-id" \
  -H "X-Client-Id: your-client-id" \
  -H "X-Client-Secret: your-client-secret" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

# managed tenants
curl -s http://localhost:8080/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "X-Base-Url: https://cipp.example.com" \
  -H "X-Api-Key: your-cipp-token" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"cipp_list_tenants","arguments":{}}}'

Unit tests (no network access needed):

uv run pytest

Delivery notes

Tool count (47). Kept as is because the tool names are an existing contract.
Write tools. The 14 tools marked write change live Microsoft 365 tenants; their descriptions tell the agent to use them only on explicit request. cipp_disable_user, cipp_reset_password, cipp_reset_mfa, cipp_revoke_sessions, cipp_offboard_user and cipp_delete_standard_template are annotated destructive.
Queued jobs. cipp_offboard_user and cipp_add_scheduled_item report whether CIPP accepted the job, not whether it finished; CIPP failures returned with HTTP 200 are detected and reported as failed.
Passwords. cipp_reset_password lets CIPP generate the new password; a caller-chosen newPassword is rejected rather than silently ignored.
Cached vs live sizes. cipp_list_mailbox_usage reads CIPP's daily report cache (fast, whole tenant, up to 24 h old); cipp_get_mailbox_usage reads one mailbox live.
Result size exception (SOP 2.5). cipp_list_user_signin_logs (top) and cipp_list_mailbox_usage (limit) have no paging in the API, so they keep a maximum of 1000 (default 50); results are still cut to 20,000 characters with a truncation notice.
Version differences. cipp_list_bpa exists only on older CIPP versions and returns a clear not_found pointing to cipp_get_tenant_alignment otherwise.

License

Apache License 2.0 - see LICENSE and NOTICE.

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityMaintained

ResponsivenessNo issues

Resources

Related MCP Connectors

Airbyte AgentsOAuth
io.github.airbytehq
Let AI agents query data and act across all your business apps via MCP.
Data Platforms AI & Machine Learning RAG Systems
2
https://mcp.airbyte.ai/mcp
mcp-serverOAuth
com.make
Give your AI agents the tools to build, manage, and run automation workflows.
App Automation Developer Tools Workplace & Productivity
2
https://mcp.make.com
ZapierOAuth
com.zapier.mcp
Zapier MCP connects AI tools like Claude, ChatGPT, and Cursor to over 8,000 apps and 30,000+ actions, enabling AI to perform real-world tasks such as sending messages, searching data, scheduling events, and updating records. It acts as a translator between AI tools and apps, handling authentication, rate limits, and retries automatically, transforming AI from a conversational tool into a functional extension of your business stack.
App Automation Workplace & Productivity Communication
2
https://mcp.zapier.com/api/mcp/mcp
ChippOAuth
ai.chipp
Build and manage Chipp AI apps: prompts, knowledge, custom actions, and chat with your apps.
AI & Machine Learning RAG Systems
1
https://build.chipp.ai/mcp

Related MCP Servers

mcp-m365-mgmt
Cloud Platforms Workplace & Productivity Monitoring
thiagogbeier
A
license
Not graded
quality
C
maintenance
Enables AI assistants and automation tools to manage Microsoft 365, Entra ID, and Intune resources through 32 tools for user/device/file management and infrastructure monitoring.
Updated a year ago (2025-11-04 15:31 UTC)
7
MIT
proofpoint-essentials-mcp
Security Monitoring
WYRE-AI
A
license
Not graded
quality
B
maintenance
Enables AI assistants to manage MSP-multi-tenant email security: organizations, domains, users, licensing, features, subscription packages, and email flow reporting.
Updated 12 days ago (2026-10-14 16:08 UTC)
Apache 2.0
Enterprise Microsoft 365 MCP
Email Workplace & Productivity Security
ManoAlee
A
license
C
quality
A
maintenance
Connects LLMs and AI agents to enterprise Microsoft 365 environments, enabling administration across Exchange Online, Microsoft Graph, Entra ID, compliance, security, mailbox operations, and mail-flow diagnostics through 34 tools.
Updated 7 days ago (2026-10-19 17:31 UTC)
34
MIT
Inforcer MCP Server
Security Cloud Platforms
MSPbotsAIFramework
A
license
Not graded
quality
B
maintenance
Enables AI agents to read managed Microsoft 365 client tenants, baselines, alignment scores, policies, Secure Score, Entra users/groups/roles, and audit activity, and on explicit request run assessments and queue reports. Access is read-only apart from those two run tools, which never modify tenant policies.
Updated 4 days ago (2026-10-23 10:24 UTC)
Apache 2.0

CIPP MCP Server

MSPbots Connector

Why Connector

Quick start

Features

Pricing

Authentication headers

Tools

Run locally

Testing example

Delivery notes

License

Maintenance

Resources

Related MCP Connectors

Related MCP Servers

mcp-m365-mgmt

proofpoint-essentials-mcp

Enterprise Microsoft 365 MCP

Inforcer MCP Server