Crossplane MCP Server

A Model Context Protocol server that lets AI assistants understand a Crossplane control plane.

Local serverstdio

What is the Crossplane MCP Server?

crossplane-mcp-server is an MCP project maintained in the ravibagri5/crossplane-mcp-server repository. The maintainer describes its purpose as “A Model Context Protocol server that lets AI assistants understand a Crossplane control plane”. Read the project documentation for the complete scope.

Local setup

The project provides a local client configuration using crossplane-mcp-server. Follow the repository’s build and installation steps before copying it, and replace example paths with the paths on your own computer.

Configuration values

The example declares PATH, HOME. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
crossplane_managed_resources_summaryHow many managed resources exist, by kind, and how many are Ready and Synced
crossplane_managed_resources_listWhich managed resources exist, optionally only the failing ones
crossplane_composite_resources_listWhich composite resources (XRs) exist and which Composition each selected
crossplane_claims_listWhich claims exist and which composite each is bound to
crossplane_resource_getEverything about one resource: conditions, external name, events, manifest
crossplane_resource_treeThe composition tree below a claim or composite, with per-resource status
crossplane_resource_eventsThe events Crossplane recorded against one resource
crossplane_diagnoseWhy a resource is not Ready, and which resource is actually at fault
crossplane_drift_detectWhich infrastructure no longer matches its declared spec, and whether that will be corrected
crossplane_providers_listWhich providers are installed and healthy
crossplane_functions_listWhich composition functions are installed and healthy
crossplane_configurations_listWhich configurations are installed and healthy
crossplane_package_getOne package plus its revisions, where image pull and dependency errors appear
crossplane_xrds_listWhich platform APIs this control plane offers
crossplane_xrd_schemaThe fields a platform API takes, with a ready-to-edit example manifest
crossplane_compositions_listWhich Compositions exist and what pipeline they run
crossplane_composition_getThe full definition of one Composition
crossplane_composition_validateWhy a Composition does not work, without running anything
crossplane_composition_renderWhat a Composition would actually create, as a dry run
crossplane_environment_configs_listWhich EnvironmentConfigs exist and what data they hold
crossplane_deployment_runtime_configs_listWhich runtime configs exist and which packages use them
crossplane_managed_resource_definitions_listWhich managed resource kinds are Active, on Crossplane v2
crossplane_managed_resource_activation_policies_listWhich policies activate those definitions
crossplane_clusters_listWhich control planes this server can reach
crossplane_statusThe overall health of the control plane in one call
crossplane_unhealthy_resourcesEverything that is currently failing, and why
crossplane_deleting_resourcesWhat is stuck deleting, and what is holding it up
crossplane_usages_listWhat is protected from deletion, and what needs it
crossplane_impactWhat a deletion would destroy, and whether it would be blocked
crossplane_api_resourcesThe Crossplane API surface, to find exact kinds and groups
crossplane_database_createAsks the control plane's own database API for a database, filling in the fields its XRD declares
crossplane_workload_createThe same for a workload, app or service
crossplane_resource_applyApplies a Crossplane manifest, for XRDs, Compositions and specs you built yourself

How to install the Crossplane MCP Server

{
  "mcpServers": {
    "crossplane": {
      "command": "crossplane-mcp-server",
      "args": [
        "--clusters",
        "staging,production",
        "--context",
        "staging"
      ],
      "env": {
        "PATH": "/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin",
        "HOME": "/Users/you"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

VariableDescriptionRequired
PATHDeclared in the maintainer’s client configuration.Check documentation
HOMEDeclared in the maintainer’s client configuration.Check documentation