MCP Lifecycle Operator

Kubernetes operator for managed Model Context Protocol server workloads.

Agentic Friendly

Component Category

AI tools / MCP Server lifecycle

Component Description

MCP Lifecycle Operator reconciles managed Model Context Protocol server workloads from declarative Kubernetes resources. It creates and updates the server deployment, service, and reported runtime status used by the BSQAI API and portal.

Why It Is Used

In BullSequana AI, MCP Lifecycle Operator gives managed MCP Servers a dedicated controller and lifecycle API. This separates workload reconciliation from the BSQAI API while keeping server creation, updates, health, and deletion observable.

Learn More

Deployment notes

The operator runs in mcp-lifecycle-operator-system. Managed MCP Server workloads run in the isolated mcp-servers namespace behind a default NetworkPolicy. The platform mirrors the operator image into its private registry and installs the upstream CRD and controller with the required image-pull configuration.

Remote MCP Servers do not create operator-managed workloads. The BSQAI API stores their HTTPS address and reaches them through the MCP Gateway.

Interacts With

  • BSQAI API, which creates managed server resources and reports their status.
  • MCP Gateway, which authenticates callers and injects linked upstream credentials.
  • AI Web Portal, which manages server definitions, credentials, and tool allowlists.
  • Keycloak, which authenticates users and identifies the active tenant.

On this page