ansible-galaxy-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| LOG_LEVEL | No | Log verbosity: debug, info, warn, error | info |
| MCP_HTTP_HOST | No | HTTP bind address | :: |
| MCP_HTTP_PORT | No | HTTP listen port | 8080 |
| MCP_TRANSPORT | No | Transport: stdio or http | stdio |
| ANSIBLE_HUB_URL | No | Private Automation Hub URL (used with chain source) | |
| ANSIBLE_GALAXY_URL | No | Galaxy API base URL | https://galaxy.ansible.com |
| ANSIBLE_ROLES_PATH | No | Local roles directory | ./roles |
| ANSIBLE_SOURCE_TYPE | No | Data source: galaxy, local, or chain | galaxy |
| ANSIBLE_GALAXY_TOKEN | No | Bearer token for authenticated Galaxy/Hub API access | |
| ANSIBLE_OUTPUT_SPECS | No | Enable proposed output_specs features | false |
| ANSIBLE_GALAXY_TIMEOUT | No | HTTP request timeout in milliseconds | 30000 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| search_collectionsA | Search for Ansible collections by keyword. Returns collection names, descriptions, and versions. |
| get_collection_modulesB | List all modules in a collection with their descriptions. |
| get_collection_rolesA | List all roles in a collection with their descriptions. |
| get_module_specA | Get the full input/output contract for a module. Returns argument_spec (inputs) and RETURN docstring (outputs) with a documentation quality grade. |
| get_role_specA | Get the full input/output contract for a role. Returns argument_specs.yml (inputs) and output_specs.yml (outputs) with a documentation quality grade. Call this for EACH role before generating a playbook to discover the exact fact names the role sets. |
| grade_collectionA | Grade a collection on documentation quality. Returns A-F grade based on module RETURN documentation. With ANSIBLE_OUTPUT_SPECS=true, also checks whether roles have output_specs.yml. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 6 tools
Each tool has a clearly distinct purpose: search collections, list modules or roles in a collection, retrieve detailed specs for a specific module or role, and grade collection documentation. No overlap or ambiguity.
All tool names follow a consistent verb_noun pattern in snake_case (e.g., get_collection_modules, get_module_spec). The naming is predictable and easy to understand.
Six tools is an appropriate count for an Ansible Galaxy collection explorer—covering search, listing, specs, and grading without being excessive or insufficient.
The tool set provides comprehensive coverage for exploring and preparing to use Ansible collections: search, list modules/roles, get detailed specs, and grade documentation quality. No obvious gaps.