Aap MCP Server

MCP server for Ansible Automation Platform

Local serverstdio

What is the Aap MCP MCP server?

Most monitoring and observability work still happens through a UI a human drives. Aap MCP MCP server moves it into the conversation instead. 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.

Getting it running

Setup follows the usual MCP pattern — install or clone the server, register it in your client's configuration file, restart the client.

The tools it exposes

The server publishes 14 tools. What each one is for:

  • 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

What it needs from you

Configuration is passed through the environment: AAP_BASE_URL, AAP_TOKEN, AAP_CONFIG_DIR. Treat anything key-shaped as a real credential — scope it to the minimum the server needs, and rotate it if it ever lands in a shared config.

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

Things to watch

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • With 14 tools registered it takes up a noticeable share of the context window; turn it off in projects that never touch Aap MCP.
  • Missing credentials fail quietly in some clients — if no tools show up, check the environment block first.
  • Keep per-call confirmation enabled while you learn its behaviour; it is the cheapest safeguard you have.

How it compares

Among the monitoring and observability options, the useful question is rarely "what can it do" but "what does it cost you to run" — permissions, credentials, and how much of your context its toolset consumes. Aap MCP's toolset — get_system_info, get_platform_metrics, list_jobs and 11 more — is a fair guide to whether it matches your workflow. It is maintained by jd1306; worth a glance at recent repository activity before you build anything load-bearing on it.

This entry was verified against Aap MCP's own documentation before publication; SyncDev keeps the directory reviewed rather than auto-generated.

Available tools

ToolWhat it does
get_system_infoRetrieve AAP system information
get_platform_metricsGet platform capacity and job statistics
list_jobsList automation jobs with filtering
get_jobGet job details
run_jobLaunch a job template
get_job_outputRetrieve job execution logs
list_job_templatesList available job templates
list_workflow_templatesList workflow job templates
list_workflow_jobsList workflow executions
get_workflow_jobGet workflow execution details
list_hostsList inventory hosts
list_groupsList inventory groups
list_projectsList projects
get_projectGet project details

Configuration

  • Node.js ≥ 18.0.0 - npm or yarn - Access to an AAP instance
VariableDescriptionRequired
AAP_BASE_URLEndpoint or connection string the server talks to.Yes
AAP_TOKENCredential the server authenticates with.Yes
AAP_CONFIG_DIRFilesystem 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

It connects Aap MCP to MCP-compatible AI assistants such as Claude and Cursor, exposing 14 tools (get_system_info, get_platform_metrics, list_jobs, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Aap MCP directly.