Skip to main content
Glama
irq-freeipa-mcp

irq-freeipa-mcp

irq-freeipa-mcp

MCP server for FreeIPA identity management. Provides 36 tools for managing users, groups, sudo rules, HBAC rules, certificates, hosts, and SSSD cache.

Setup

npm install
npm run build

Configure credentials:

cp config.yaml.example config.yaml   # non-sensitive settings
cp .env.example .env                  # passwords (required)

Passwords must be set via environment variables in .env — they are ignored if placed in config.yaml.

Related MCP server: ActiveDirectoryMCP

MCP Configuration

{
  "mcpServers": {
    "irq-freeipa": {
      "command": "node",
      "args": ["/path/to/irq-freeipa-mcp/build/index.js"]
    }
  }
}

Tools

Category

Tools

Examples

User Management

freeipa_user_find, freeipa_user_show, freeipa_user_add, freeipa_check_user_groups

Search, create, inspect users

Group Management

freeipa_group_find, freeipa_group_add_member, freeipa_group_remove_member

Manage group membership

Sudo Rules

freeipa_sudorule_find, _show, _add, _enable, _disable, _add_user, _add_host, _add_command, freeipa_sudocmdgroup_add, _add_member

Create and configure sudo policies

HBAC Rules

freeipa_hbacrule_find, _show, _add, _enable, _disable, _add_user, _add_host, _add_service

Host-based access control

Certificates

freeipa_service_add, freeipa_cert_request

Service principals and TLS certs

Hosts

freeipa_host_find, freeipa_host_add

Manage FreeIPA hosts

SSSD Cache

freeipa_clear_sssd_cache, _update_sssd_timeout, _check_sssd_status, _invalidate_user_cache, _test_ssh_connectivity

Remote cache management via SSH

Utility

freeipa_ping, freeipa_get_server_info

Connection testing

All tools include descriptive inputSchema definitions — your MCP client will display parameter docs automatically.

Configuration Reference

config.yaml — non-sensitive settings (server hostnames, timeouts, SSSD domain/timeouts).

.env — credentials only:

FREEIPA_PASSWORD=your-freeipa-password
SSH_PASSWORD=your-ssh-password

Environment variables override config.yaml. See config.yaml.example and .env.example for all options.

License

MIT

Available Tools

36 tools
freeipa_cert_requestB

Request a certificate from FreeIPA CA

Inputs: csr (required), principal (required), profile.

freeipa_check_sssd_statusC

Check SSSD service status on hosts

Inputs: hosts (required).

freeipa_check_user_groupsB

Check which groups a user belongs to

Inputs: uid (required).

freeipa_clear_sssd_cacheA

Clear SSSD cache on one or more hosts to force policy refresh

Inputs: hosts (required), force.

freeipa_get_server_infoA

Get FreeIPA server information and environment details

Inputs: no named parameters.

freeipa_group_add_memberC

Add users to a group

Inputs: group (required), users (required).

freeipa_group_findC

Search for groups in FreeIPA

Inputs: pattern.

freeipa_group_remove_memberB

Remove users from a group

Inputs: group (required), users (required).

freeipa_hbacrule_addB

Create a new HBAC rule

Inputs: rule (required), description.

freeipa_hbacrule_add_hostB

Add hosts or hostgroups to an HBAC rule

Inputs: rule (required), hosts, hostgroups.

freeipa_hbacrule_add_serviceB

Add services to an HBAC rule

Inputs: rule (required), services (required).

freeipa_hbacrule_add_userB

Add users or groups to an HBAC rule

Inputs: rule (required), users, groups.

freeipa_hbacrule_disableB

Disable an HBAC rule

Inputs: rule (required).

freeipa_hbacrule_enableB

Enable an HBAC rule

Inputs: rule (required).

freeipa_hbacrule_findB

List all HBAC (Host-Based Access Control) rules

Inputs: pattern.

freeipa_hbacrule_showA

Get detailed information about a specific HBAC rule

Inputs: rule (required).

freeipa_host_addC

Add a new host to FreeIPA

Inputs: fqdn (required), force, description.

freeipa_host_findC

Search for hosts in FreeIPA

Inputs: pattern.

freeipa_invalidate_user_cacheB

Invalidate cache for a specific user on hosts

Inputs: hosts (required), username (required).

freeipa_pingB

Test connection to FreeIPA server

Inputs: no named parameters.

freeipa_service_addB

Create a service principal for certificate management

Inputs: principal (required), force.

freeipa_sudocmdgroup_addB

Create a new sudo command group

Inputs: group (required), description.

freeipa_sudocmdgroup_add_memberB

Add commands to a sudo command group

Inputs: group (required), commands (required).

freeipa_sudorule_addB

Create a new sudo rule

Inputs: rule (required), description.

freeipa_sudorule_add_commandB

Add allowed commands to a sudo rule

Inputs: rule (required), commands, commandgroups.

freeipa_sudorule_add_hostB

Add hosts or hostgroups to a sudo rule

Inputs: rule (required), hosts, hostgroups.

freeipa_sudorule_add_userC

Add users or groups to a sudo rule

Inputs: rule (required), users, groups.

freeipa_sudorule_disableC

Disable a sudo rule

Inputs: rule (required).

freeipa_sudorule_enableB

Enable a sudo rule

Inputs: rule (required).

freeipa_sudorule_findA

List all sudo rules in FreeIPA

Inputs: pattern.

freeipa_sudorule_showB

Get detailed information about a specific sudo rule

Inputs: rule (required).

freeipa_test_ssh_connectivityB

Test SSH connectivity to hosts

Inputs: hosts (required).

freeipa_update_sssd_timeoutB

Update SSSD cache timeout settings on hosts

Inputs: mode (required), hosts (required).

freeipa_user_addB

Create a new user in FreeIPA

Inputs: sn (required), uid (required), givenname (required), mail, +1 more.

freeipa_user_findB

Search for users in FreeIPA. Returns list of users matching the search pattern.

Inputs: all, pattern.

freeipa_user_showB

Get detailed information about a specific user

Inputs: uid (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.4/5.0

    Scored across 36 tools

    Disambiguation5/5

    Each tool targets a distinct area (users, groups, sudo rules, HBAC rules, hosts, etc.) with clear action verbs. There is minimal overlap; e.g., freeipa_sudorule_enable and freeipa_hbacrule_enable operate on different resource types.

    Naming Consistency5/5

    All tools follow a consistent 'freeipa_<domain>_<action>' pattern using snake_case. The naming is predictable and makes it easy to infer the purpose of each tool from its name.

    Tool Count4/5

    With 36 tools, the count is slightly high for the typical range, but it is justified by the comprehensive coverage of FreeIPA's various subdomains (users, groups, sudo rules, HBAC rules, hosts, services, certificates, SSSD cache).

    Completeness3/5

    The tool set covers many operations but lacks update and delete actions for key resources such as users, groups, sudo rules, HBAC rules, and hosts. This leaves noticeable gaps for full lifecycle management.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      Not graded
      maintenance
      Enables management of FreeIPA resources including user groups, host groups, HBAC, and sudo rules via the FreeIPA JSON-RPC API. It provides comprehensive tools for automating access control and infrastructure provisioning in FreeIPA-managed environments.
      Apache 2.0
    • A
      license
      B
      quality
      B
      maintenance
      A comprehensive MCP server for managing Active Directory environments through LDAP, enabling user, group, computer, and OU management, as well as security auditing and policy compliance checks.
      45
      54
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      MCP server for managing Pocket ID instances, providing 57 tools for user management, OIDC client configuration, group management, audit logs, and more.
      2
      -