AAP Enterprise MCP Server

A comprehensive Model Context Protocol (MCP) server suite for Red Hat's automation and infrastructure ecosystem, enabling AI assistants to interact

Local serverstdioPython

What is the AAP Enterprise MCP Server?

AAP Enterprise becomes available to MCP clients through the aap enterprise mcp server. A comprehensive Model Context Protocol (MCP) server suite for Red Hat's automation and infrastructure ecosystem, enabling AI assistants to interact with Ansible Automation Platform (AAP), Event-Driven Ansible (EDA), ansible-lint code quality tools, and Red Hat's official documentation with secure.

What AAP Enterprise does

A comprehensive Model Context Protocol (MCP) server suite for Red Hat's automation and infrastructure ecosystem, enabling AI assistants to interact with Ansible Automation Platform (AAP), Event-Driven Ansible (EDA), ansible-lint code quality tools, and Red Hat's official documentation with secure domain validation.

Requirements

  • Python 3.11 or higher - UV package manager (recommended) or pip - Access to an Ansible Automation Platform instance - Valid AAP API token

Practical notes

  • Maintained by sibilleb, written in Python.

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
list_inventoriesList all inventories
get_inventoryGet inventory details by ID
create_inventoryCreate a new inventory
list_hostsList hosts in an inventory
add_host_to_inventoryAdd a host to inventory
run_jobExecute a job template
job_statusCheck job execution status
job_logsRetrieve job execution logs
list_job_templatesList available job templates
create_job_templateCreate a new job template
create_projectCreate a new project
run_adhoc_commandExecute ad-hoc ansible commands
list_projectsList all projects
get_projectGet project details by ID
list_project_updatesList project update jobs (SCM sync)
get_project_updateGet project update job status
get_project_update_logsGet project update job logs
update_projectTrigger project update (SCM sync)
search_galaxy_collectionsSearch Ansible Galaxy collections by query, tags, or namespace
search_galaxy_rolesSearch Ansible Galaxy roles by keyword, name, or author
get_collection_detailsGet detailed information about a specific collection
get_role_detailsGet detailed information about a specific role
suggest_ansible_contentIntelligently suggest collections and roles based on use case description
lint_playbookLint Ansible playbook content with configurable profiles and rules
lint_fileLint specific Ansible files on disk
lint_roleComprehensive validation of Ansible role directories
validate_syntaxQuick syntax-only validation for immediate feedback
check_best_practicesContext-aware best practice checking (dev/staging/production)
analyze_projectAnalyze entire Ansible project structure with comprehensive reporting
list_rulesList available ansible-lint rules, optionally filtered by tags
list_tagsList all available tags for ansible-lint rules
get_ansible_lint_versionGet version information for installed ansible-lint
list_activationsList EDA activations
get_activationGet activation details
create_activationCreate new activation
enable_activationEnable an activation
disable_activationDisable an activation
restart_activationRestart an activation
list_rulebooksList available rulebooks
get_rulebookGet rulebook details
list_decision_environmentsList decision environments
read_documentationRead Red Hat documentation with domain validation and PDF-first access
list_productsList all available Red Hat products and versions
search_documentationSearch Red Hat documentation with version prioritization
search_documentation_enhancedNEW: Hybrid search combining sitemap + web search discovery
search_with_web_guidanceNEW: Get direct results + optimized Red Hat domain-restricted web search queries
smart_documentation_finderNEW: Intelligent multi-source documentation discovery
get_product_guidesGet product guides with semantic version sorting (13 guides for OpenShift 4.18)
recommend_contentIntelligent recommendations with telco/edge/CNF specialization

How to install the AAP Enterprise MCP Server

{
  "mcpServers": {
    "ansible": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/AAP-Enterprise-MCP-Server",
        "run",
        "ansible.py"
      ],
      "env": {
        "AAP_TOKEN": "YOUR_AAP_TOKEN",
        "AAP_URL": "https://your-aap-server.com/api/controller/v2"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

  • Python 3.11 or higher - UV package manager (recommended) or pip - Access to an Ansible Automation Platform instance - Valid AAP API token
VariableDescriptionRequired
AAP_TOKENDeclared in the maintainer’s client configuration.Check documentation
AAP_URLDeclared in the maintainer’s client configuration.Check documentation

Example prompts to try

  • “Use AAP Enterprise to list inventories.”
  • “Use AAP Enterprise to get inventory.”
  • “Use AAP Enterprise to create inventory.”

Frequently asked questions

A comprehensive Model Context Protocol (MCP) server suite for Red Hat's automation and infrastructure ecosystem, enabling AI assistants to interact with Ansible Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.