How do I install the aap mcp server?

This profile does not contain a verified copy-paste launch configuration. Follow the current project documentation to confirm the runtime, entry point, transport and authentication before registering it in your client.

What credentials does it need?

It reads `AAP_BASE_URL`, `AAP_TOKEN`, `AAP_CONFIG_DIR` from the environment. Store these in your client's env block or a secrets manager — never commit them to a repository — and grant the narrowest scope that still covers your use case.

SSyncDev

Start a project

Aap MCP Server

MCP server for Ansible Automation Platform

Local serverstdio

What is the Aap MCP Server?

MCP server for Ansible Automation Platform

The short version

A Model Context Protocol (MCP) server for Ansible Automation Platform (AAP) 2.4. Provides tools for managing jobs, templates, workflows, inventory, and infrastructure through Claude or other MCP clients.

What it needs from you

Node.js ≥ 18.0.0 - npm or yarn - Access to an AAP instance

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.

Tool	What it does
get_system_info	Retrieve AAP system information
get_platform_metrics	Get platform capacity and job statistics
list_jobs	List automation jobs with filtering
get_job	Get job details
run_job	Launch a job template
get_job_output	Retrieve job execution logs
list_job_templates	List available job templates
list_workflow_templates	List workflow job templates
list_workflow_jobs	List workflow executions
get_workflow_job	Get workflow execution details
list_hosts	List inventory hosts
list_groups	List inventory groups
list_projects	List projects
get_project	Get project details

Configuration

Node.js ≥ 18.0.0 - npm or yarn - Access to an AAP instance

Variable	Description	Required
AAP_BASE_URL	Endpoint or connection string the server talks to.	Yes
AAP_TOKEN	Credential the server authenticates with.	Yes
AAP_CONFIG_DIR	Filesystem location the server is allowed to use.	Optional

Example prompts to try

“Use Aap MCP to get system info.”
“Use Aap MCP to get platform metrics.”
“Use Aap MCP to list jobs.”

Frequently asked questions

MCP server for Ansible Automation Platform Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.