{"name":"io.github.SurgeX-Labs/awx-mcp-server","slug":"surgex-labs-awx-mcp-server","title":null,"description":"Control AWX/Ansible Tower through natural language - 49 tools for automation","url":"https://mcp.market/server/surgex-labs-awx-mcp-server","rating":null,"grade":"C","score":66,"certified":false,"status":"active","category":"other","tags":[],"presence":{"score":14,"stars":12,"forks":13,"downloads_week":null,"last_push_at":"2026-02-23T03:35:10.000Z","license":"MIT"},"uptime":null,"claimed":false,"transport":"pypi","callable_via_gateway":false,"default_price_micros":0,"repository":"https://github.com/SurgeX-Labs/awx-mcp-server","website":null,"version":"1.1.2","remotes":[],"packages":[{"registryType":"pypi","identifier":"awx-mcp-server","version":"1.1.2","transport":{"type":"stdio"},"environmentVariables":[{"description":"The base URL of your AWX/Ansible Tower instance","isRequired":true,"format":"string","name":"AWX_BASE_URL"},{"description":"AWX API token for authentication","format":"string","isSecret":true,"name":"AWX_TOKEN"},{"description":"AWX username (alternative to token)","format":"string","name":"AWX_USERNAME"},{"description":"AWX password (alternative to token)","format":"string","isSecret":true,"name":"AWX_PASSWORD"},{"description":"Whether to verify SSL certificates (set to false for self-signed)","format":"boolean","name":"AWX_VERIFY_SSL"}]}],"tools":[{"name":"ansible_inventory","description":"List/show Ansible inventory hosts and groups using ansible-inventory. Use this when user asks to 'list inventory hosts', 'show inventory groups', 'display local inventory', 'what hosts are in my inventory file'.","write_action":false,"price_micros":0,"input_schema":null},{"name":"ansible_playbook","description":"Execute/run an Ansible playbook locally for development and testing. Use this when user asks to 'run playbook locally', 'execute playbook', 'test playbook', 'dry-run playbook', or wants to run a playbook in their dev environment before pushing to AWX. Supports check mode (dry-run), extra vars, tags, and host limits.","write_action":true,"price_micros":0,"input_schema":null},{"name":"ansible_role","description":"Execute/run an Ansible role locally by generating a temporary playbook. Use this when user asks to 'run a role', 'execute role', 'test role locally', or wants to apply a specific role from their project without writing a full playbook.","write_action":true,"price_micros":0,"input_schema":null},{"name":"ansible_task","description":"Run an ad-hoc Ansible task/module locally. Use this when user asks to 'run ansible module', 'execute ad-hoc task', 'ping hosts', 'run shell command with ansible', 'test ansible module', or wants to run a single Ansible module without a playbook. Defaults to connection=local for localhost.","write_action":true,"price_micros":0,"input_schema":null},{"name":"awx_credential_create","description":"Create AWX credential","write_action":true,"price_micros":0,"input_schema":null},{"name":"awx_credential_delete","description":"Delete AWX credential","write_action":true,"price_micros":0,"input_schema":null},{"name":"awx_credential_types_list","description":"List AWX credential types","write_action":false,"price_micros":0,"input_schema":null},{"name":"awx_credentials_list","description":"List AWX credentials","write_action":false,"price_micros":0,"input_schema":null},{"name":"awx_inventories_list","description":"List AWX inventories","write_action":false,"price_micros":0,"input_schema":null},{"name":"awx_inventory_create","description":"Create AWX inventory","write_action":true,"price_micros":0,"input_schema":null},{"name":"awx_inventory_delete","description":"Delete AWX inventory","write_action":true,"price_micros":0,"input_schema":null},{"name":"awx_inventory_group_create","description":"Create group in AWX inventory","write_action":true,"price_micros":0,"input_schema":null},{"name":"awx_inventory_group_delete","description":"Delete group from AWX inventory","write_action":true,"price_micros":0,"input_schema":null},{"name":"awx_inventory_groups_list","description":"List groups in AWX inventory","write_action":false,"price_micros":0,"input_schema":null},{"name":"awx_inventory_host_create","description":"Create host in AWX inventory","write_action":true,"price_micros":0,"input_schema":null},{"name":"awx_inventory_host_delete","description":"Delete host from AWX inventory","write_action":true,"price_micros":0,"input_schema":null},{"name":"awx_inventory_hosts_list","description":"List hosts in AWX inventory","write_action":false,"price_micros":0,"input_schema":null},{"name":"awx_job_cancel","description":"Cancel/stop/abort a currently running AWX job execution. Use this when user asks to 'cancel job', 'stop job', 'abort job', 'kill job', or any request to halt a running job.","write_action":true,"price_micros":0,"input_schema":null},{"name":"awx_job_delete","description":"Delete/remove an AWX job record from history. Use this when user asks to 'delete job', 'remove job', 'clean up job', or any request to permanently remove a job record.","write_action":true,"price_micros":0,"input_schema":null},{"name":"awx_job_events","description":"Show/list/view/get detailed events, tasks, plays, and execution steps of an AWX job. Use this when user asks to 'show job events', 'view job tasks', 'list execution steps', 'see what tasks ran', 'show detailed job activity', 'view play-by-play execution', or any request about the individual task/play events within a job run. Can filter to show only failed events.","write_action":false,"price_micros":0,"input_schema":null},{"name":"awx_job_failure_summary","description":"Analyze/diagnose/debug/troubleshoot why an AWX job failed and get actionable fix suggestions. Use this when user asks 'why did job fail', 'analyze failure', 'debug job error', 'show failure summary', 'what went wrong with job', 'diagnose job problem', 'troubleshoot job', or any request to understand and fix a failed job execution.","write_action":false,"price_micros":0,"input_schema":null},{"name":"awx_job_get","description":"Get specific AWX job metadata and summary details including status, timing, template info, and playbook name. Use this to check a single job's current state, whether it succeeded or failed, and its start/finish times. Does NOT return console output or logs — use awx_job_stdout for that.","write_action":false,"price_micros":0,"input_schema":null},{"name":"awx_job_launch","description":"Launch/execute/run/start a new AWX job from a template. Creates a new job execution instance.","write_action":false,"price_micros":0,"input_schema":null},{"name":"awx_job_stdout","description":"Show/display/view/get the console output, stdout, logs, or terminal output of an AWX job execution. Use this when user asks to 'show job output', 'view job logs', 'display console output', 'get job stdout', 'show what the job printed', 'see the playbook output', 'show execution log', or any request to see the text/log output produced by a job run.","write_action":false,"price_micros":0,"input_schema":null},{"name":"awx_jobs_list","description":"Show/list/display/view recent AWX jobs, job execution history, completed jobs, running jobs, failed jobs, job status, job runs, playbook executions. Use this when user asks to 'show recent jobs', 'list jobs', 'view jobs', 'get jobs', 'display job history', 'see recent activity', 'check job status', or any query about AWX job executions with timestamps and results.","write_action":false,"price_micros":0,"input_schema":null},{"name":"awx_organization_get","description":"Get AWX organization by ID","write_action":false,"price_micros":0,"input_schema":null},{"name":"awx_organizations_list","description":"List AWX organizations","write_action":false,"price_micros":0,"input_schema":null},{"name":"awx_project_create","description":"Create AWX project","write_action":true,"price_micros":0,"input_schema":null},{"name":"awx_project_delete","description":"Delete AWX project","write_action":true,"price_micros":0,"input_schema":null},{"name":"awx_project_update","description":"Update AWX project from SCM","write_action":true,"price_micros":0,"input_schema":null},{"name":"awx_projects_list","description":"List AWX projects","write_action":false,"price_micros":0,"input_schema":null},{"name":"awx_system_info","description":"Get AWX system information (config, dashboard, settings)","write_action":false,"price_micros":0,"input_schema":null},{"name":"awx_template_create","description":"Create AWX job template","write_action":true,"price_micros":0,"input_schema":null},{"name":"awx_template_delete","description":"Delete AWX job template","write_action":true,"price_micros":0,"input_schema":null},{"name":"awx_templates_list","description":"List AWX job templates (NOT for recent jobs or job history). Templates are playbook definitions, configurations, settings. This shows available templates to run, not execution history or recent activity. For recent jobs/runs/executions, use awx_jobs_list instead.","write_action":false,"price_micros":0,"input_schema":null},{"name":"create_playbook","description":"Create/write/generate an Ansible playbook YAML file locally. Use this when user asks to 'create a playbook', 'write a playbook', 'generate a playbook', 'make a new playbook', or wants to author Ansible YAML content before running it on AWX.","write_action":true,"price_micros":0,"input_schema":null},{"name":"create_role_structure","description":"Scaffold/generate/create an Ansible role directory structure with standard subdirectories (tasks, handlers, templates, files, vars, defaults, meta). Use this when user asks to 'create a role', 'scaffold a role', 'generate role skeleton', 'init role structure', or wants to set up a new role from scratch.","write_action":true,"price_micros":0,"input_schema":null},{"name":"env_get_active","description":"Get the currently active AWX environment","write_action":false,"price_micros":0,"input_schema":null},{"name":"env_list","description":"List all configured AWX environments","write_action":false,"price_micros":0,"input_schema":null},{"name":"env_set_active","description":"Set the active AWX environment","write_action":false,"price_micros":0,"input_schema":null},{"name":"env_test_connection","description":"Test connection to an AWX environment","write_action":false,"price_micros":0,"input_schema":null},{"name":"git_push_project","description":"Stage, commit, and push project changes to git remote (GitHub/GitLab). Use this when user asks to 'push to git', 'commit and push', 'push playbook changes', 'push project to github', 'publish changes'. After pushing, use awx_project_update to sync AWX.","write_action":false,"price_micros":0,"input_schema":null},{"name":"list_playbooks","description":"List/show/display all Ansible playbooks in the workspace or project directory. Use this when user asks to 'list playbooks', 'show my playbooks', 'what playbooks exist', 'find playbooks'.","write_action":false,"price_micros":0,"input_schema":null},{"name":"list_registered_projects","description":"List/show all registered local Ansible projects and the default. Use this when user asks to 'list my projects', 'show registered projects', 'what projects are configured'.","write_action":false,"price_micros":0,"input_schema":null},{"name":"list_roles","description":"List/show/display all Ansible roles in the workspace. Use this when user asks to 'list roles', 'show my roles', 'what roles exist'.","write_action":false,"price_micros":0,"input_schema":null},{"name":"project_playbooks","description":"Discover/find/list playbooks and roles under a registered project root. Use this when user asks to 'show project playbooks', 'find playbooks in project', 'discover playbooks', 'what playbooks does project have', 'list project roles'.","write_action":false,"price_micros":0,"input_schema":null},{"name":"project_run_playbook","description":"Run a playbook using a registered project's inventory and environment. Use this when user asks to 'run project playbook', 'execute playbook from project', 'test project playbook locally'. Automatically uses the project's configured inventory.","write_action":true,"price_micros":0,"input_schema":null},{"name":"register_project","description":"Register/add a local Ansible project directory for easy reuse. Use this when user asks to 'register project', 'add project', 'set up project', 'configure my ansible project'. Auto-detects git remote URL, inventory, and default playbook.","write_action":false,"price_micros":0,"input_schema":null},{"name":"unregister_project","description":"Remove/unregister a local Ansible project from the registry. Use when user asks to 'remove project', 'unregister project', 'delete project registration'.","write_action":true,"price_micros":0,"input_schema":null},{"name":"validate_playbook","description":"Validate/check/lint Ansible playbook syntax using ansible-playbook --syntax-check. Use this when user asks to 'validate playbook', 'check playbook syntax', 'lint playbook', 'verify playbook', or wants to ensure a playbook is syntactically correct before running it.","write_action":false,"price_micros":0,"input_schema":null}],"scan":{"score":66,"grade":"C","scanned_at":"2026-09-28T14:28:17.517Z","report":{"scannerVersion":"0.1.10","scannedAt":"2026-09-28T14:28:17.476Z","components":{"code":{"score":25,"max":25,"notes":["25 source files scanned"]},"reliability":{"score":-1,"max":20,"notes":["no gateway calls yet and no remote to probe"]},"poisoning":{"score":-1,"max":15,"notes":["tools not inspected (local package is not executed); not counted"]},"auth":{"score":6,"max":15,"notes":["static API keys via environment variables"]},"maintenance":{"score":4,"max":15,"notes":["last push 217 days ago"]},"identity":{"score":8,"max":10,"notes":["registry namespace matches repository owner","GitHub account older than a year"]}},"findings":[],"inputs":{"packages":[{"registryType":"pypi","identifier":"awx-mcp-server","version":"1.1.2","found":true,"license":"MIT","dependencyCount":19,"publishedAt":"2026-02-13T21:21:57.108176Z","repositoryUrl":"https://github.com/SurgeX-Labs/awx-mcp-server.git"}],"repo":{"found":true,"owner":"SurgeX-Labs","repo":"awx-mcp-server","archived":false,"pushedAt":"2026-02-23T03:35:10Z","stars":12,"forks":13,"openIssues":7,"ownerType":"User","ownerAvatarUrl":"https://avatars.githubusercontent.com/u/163076751?v=4","ownerCreatedAt":"2024-03-12T01:10:06Z"},"icon":{"url":null,"source":"none"},"presence":{"stars":12,"forks":13,"downloadsWeek":null,"license":"MIT","lastPushAt":"2026-02-23T03:35:10.000Z","score":14}}}},"grade_history":[],"reviews":[]}