Skip to main content
Glama
idoyudha

mcp-keycloak

by idoyudha

update_realm_settings

Update Keycloak realm settings to configure display, themes, authentication, and security options like brute force protection.

Instructions

Update realm settings.

Args:
    display_name: Display name for the realm
    display_name_html: HTML display name
    login_theme: Login theme name
    account_theme: Account management theme
    admin_theme: Admin console theme
    email_theme: Email theme
    enabled: Whether realm is enabled
    registration_allowed: Allow user registration
    registration_email_as_username: Use email as username
    reset_password_allowed: Allow password reset
    remember_me: Enable remember me
    verify_email: Require email verification
    login_with_email_allowed: Allow login with email
    duplicate_emails_allowed: Allow duplicate emails
    ssl_required: SSL requirement (none, external, all)
    brute_force_protected: Enable brute force protection
    permanent_lockout: Permanent lockout on max failures
    max_failure_wait_seconds: Max wait after failures
    minimum_quick_login_wait_seconds: Min wait between quick logins
    wait_increment_seconds: Wait increment
    quick_login_check_milli_seconds: Quick login check interval
    max_delta_time_seconds: Max time between failures
    failure_factor: Failure factor
    default_locale: Default locale
    realm: Target realm (uses default if not specified)

Returns:
    Status message

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
display_nameNo
display_name_htmlNo
login_themeNo
account_themeNo
admin_themeNo
email_themeNo
enabledNo
registration_allowedNo
registration_email_as_usernameNo
reset_password_allowedNo
remember_meNo
verify_emailNo
login_with_email_allowedNo
duplicate_emails_allowedNo
ssl_requiredNo
brute_force_protectedNo
permanent_lockoutNo
max_failure_wait_secondsNo
minimum_quick_login_wait_secondsNo
wait_increment_secondsNo
quick_login_check_milli_secondsNo
max_delta_time_secondsNo
failure_factorNo
default_localeNo
realmNo

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
resultYes
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations provided; description only defines parameters and says 'Update realm settings'. Does not disclose whether update is partial or full, side effects, authentication needs, or idempotency.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Front-loaded with purpose, then clean parameter list. Appropriate length given parameter count; no wasted words. Could group similar parameters but not necessary.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Despite many parameters, description omits key context: update semantics (patch vs replace), return value details (vague 'Status message'), and relationships between parameters. Incomplete for a tool of this complexity with no annotations.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Adds brief but useful meaning for each of the 25 parameters (e.g., 'Whether realm is enabled'), compensating for 0% schema description coverage. Could provide more detail on constraints or defaults, but sufficient for basic understanding.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

Starts with 'Update realm settings', clearly indicating verb and resource. Parameter list makes scope evident. Does not explicitly distinguish from sibling tools like update_realm_events_config, but name and parameters imply focus on general settings.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance on when to use this tool versus alternatives (e.g., update_realm_events_config for events config). Lacks context on prerequisities or when not to use.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Install Server

Other Tools

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/idoyudha/mcp-keycloak'

If you have feedback or need assistance with the MCP directory API, please join our Discord server