irq-freeipa-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@irq-freeipa-mcp add user jsmith to group developers"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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 buildConfigure 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 |
| Search, create, inspect users |
Group Management |
| Manage group membership |
Sudo Rules |
| Create and configure sudo policies |
HBAC Rules |
| Host-based access control |
Certificates |
| Service principals and TLS certs |
Hosts |
| Manage FreeIPA hosts |
SSSD Cache |
| Remote cache management via SSH |
Utility |
| 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-passwordEnvironment variables override config.yaml. See config.yaml.example and .env.example for all options.
License
MIT
Available Tools
36 toolsfreeipa_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
Scored across 36 tools
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.
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.
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).
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
MCP server for mandates, delegation, policy-gated execution, credential grants, and audit.
One MCP server for all your MCP servers: code mode, per-tool permissions, approvals and audit.
Related MCP Servers
- AlicenseNot gradedqualityNot gradedmaintenanceEnables 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
- AlicenseBqualityBmaintenanceA 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.4554MIT
- FlicenseNot gradedqualityDmaintenanceMCP server for managing Pocket ID instances, providing 57 tools for user management, OIDC client configuration, group management, audit logs, and more.2-
- FlicenseAqualityCmaintenanceMCP server for FreeIPA / Red Hat IdM — user, group, host, DNS, HBAC, and sudo management via the Model Context Protocol.202-