# Skycloak

Skycloak controls managed Keycloak clusters, realms, apps and SSO from an MCP client. Spins up a new realm with sign-in providers without opening the Keycloak console.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 1 repo stars
- Author: sky-cloak
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/sky-cloak/skycloak-mcp
- Updated: 2026-10-23
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/skycloak

## What it does

Skycloak exposes 137 tools covering clusters, edge security, realms, applications, identity providers, users with roles and groups, custom domains, and theme branding. 60 tools are read-only and always on; 77 are write tools that can provision a realm with login providers or rotate an application secret.

The hosted endpoint at `https://mcp.skycloak.io` needs no stored key: the client connects over HTTP, a browser prompt handles sign-in, and the resulting token becomes an hour-long workspace-scoped key that renews itself. An API key from the Skycloak dashboard works too, registering the full tool list upfront while each call is checked against that key's scopes. The local `skycloak-mcp` binary flips the default: write tools stay hidden until you start it with `--allow-writes`, and `skycloak-mcp init` stores the key in your OS keychain.

Deleting a realm or any other destructive call needs an explicit `confirm=true` argument. Cluster admin credentials stay out of reach through `get_cluster_credentials` unless the key was issued with that scope or you signed in via `skycloak-mcp init --allow-credentials`.

## Requirements
- Remote server: `https://mcp.skycloak.io`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http skycloak-mcp https://mcp.skycloak.io
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add skycloak --url https://mcp.skycloak.io
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "skycloak": {
            "url": "https://mcp.skycloak.io"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "skycloak": {
            "type": "http",
            "url": "https://mcp.skycloak.io"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http skycloak https://mcp.skycloak.io
```

## When to use it
- provision a realm with Google and GitHub sign-in
- check which Keycloak clusters are behind on version upgrades
- assign roles and groups to realm users
- set up a custom domain and routes for an application
- rotate an application secret or disable a stale identity provider

## Example prompts
- List which Keycloak clusters are behind on upgrades
- Spin up a staging realm with Google and GitHub login enabled
- Show who was added to the production realm this week

## Similar
- [keycloak-administration](https://affpapa.org/en/nevibecode/skills/keycloak-administration.md) — skill · 336 installs
- [Phase Two Keycloak](https://affpapa.org/en/nevibecode/mcp/phase-two-keycloak.md) — MCP server · ★ 5 repo stars
- [keycloak-model-context-protocol](https://affpapa.org/en/nevibecode/mcp/keycloak-model-context-protocol.md) — MCP server · ★ 47 repo stars
- [infisical-sso](https://affpapa.org/en/nevibecode/skills/infisical-sso.md) — skill · 237 installs
- [saas-security-posture](https://affpapa.org/en/nevibecode/skills/saas-security-posture.md) — skill · 350 installs
- [oauth-implementation](https://affpapa.org/en/nevibecode/skills/aj-geddes-oauth-implementation.md) — skill · 560 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
