Which integrations are available for this server?

Provides tools for discovering and documenting Ansible modules, generating skill packages, and searching documentation, enabling AI agents to learn and work with Ansible.

How do I use ansible-know-mcp?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@ansible-know-mcp search for modules related to package management" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

ansible-know-mcp

by leogallego

Overview Schema Related Servers Score Discussions

Python

Local

Ansible Know MCP Server

Module discovery, documentation search, and skill generation for AI agents via the Model Context Protocol.

What It Does

Ansible Know is the foundational "learn" layer for AI agents working with Ansible. It provides:

Galaxy collection discovery — search 2000+ collections on Ansible Galaxy by keyword, ranked by download count
Module discovery — search and explore Ansible modules across installed collections
Module documentation — get structured parameter specs, examples, and metadata (falls back to Galaxy if not installed locally)
Documentation search — find conceptual guides from Ansible's AI-friendly docs
Skill generation — create ready-to-use skill packages that teach agents how to use specific modules
Collection bootstrapping — auto-install collections from Galaxy for the current session
Collection manifests — get collection-level overviews with per-module summaries
Resources — browse skills and doc sources as MCP resources
Prompts — pre-built templates for playbook review, module explanation, and role generation

Together with Ansible Devtools MCP (build) and AAP MCP (deploy), this enables the full autonomous cycle: learn -> build -> deploy.

 Agent's MCP servers:

 +-----------------------+  +-------------------+  +---------------+
 | Ansible Know          |  | Ansible Devtools  |  |   AAP MCP     |
 | (this project)        |  |                   |  |               |
 |                       |  |                   |  |               |
 | search_collections    |  | ansible_lint      |  | controller.*  |
 | search_modules        |  | ansible_navigator |  | eda.*         |
 | get_module_doc        |  | ansible_create_*  |  | gateway.*     |
 | get_collection_       |  | build_ee          |  | galaxy.*      |
 |   manifest            |  | zen_of_ansible    |  |               |
 | search_docs           |  | setup_environment |  |               |
 | ensure_collection     |  | environment_info  |  |               |
 | generate_skill        |  |                   |  |               |
 | generate_collection   |  |                   |  |               |
 | list_skills           |  |                   |  |               |
 | get_skill             |  |                   |  |               |
 |                       |  |                   |  |               |
 | LEARN                 |  | BUILD             |  | DEPLOY        |
 +-----------------------+  +-------------------+  +---------------+

Related MCP server: read-docs-mcp

Installation

Using uvx (recommended):

uvx ansible-know-mcp

Using pip:

pip install ansible-know-mcp

Runtime requirement: ansible-core must be installed in the same environment (for ansible-doc).

Usage

With Claude Code

claude mcp add ansible-know -- uvx ansible-know-mcp

To make it available in all projects:

claude mcp add --scope user ansible-know -- uvx ansible-know-mcp

With VS Code / Cursor

Add to .vscode/mcp.json in your workspace:

{
  "servers": {
    "ansible-know": {
      "command": "uvx",
      "args": ["ansible-know-mcp"],
      "type": "stdio"
    }
  }
}

With any MCP client

The server runs over stdio by default:

uvx ansible-know-mcp

Full stack configuration

{
  "mcpServers": {
    "ansible-know":     { "command": "uvx", "args": ["ansible-know-mcp"] },
    "ansible-devtools": { "command": "ade", "args": ["mcp"] },
    "aap":              { "command": "aap-mcp-server" }
  }
}

Tools

Discovery (read-only)

Tool	Description
`search_collections(query, tags?)`	Search Ansible Galaxy for collections by keyword. Returns results ranked by download count.
`search_modules(keyword, namespace?)`	Find modules by keyword in name or description. Returns up to 50 matches.
`get_module_doc(module_name)`	Get full structured docs: params, examples, API detection. Falls back to Galaxy if not installed locally.
`search_docs(query, source?, topic?, audience?, core_only?)`	Search documentation manifests for conceptual guides. Returns up to 20 matches.
`get_collection_manifest(collection_namespace)`	Get collection-level manifest with per-module summaries.

Collection management

Tool	Description
`ensure_collection(collection_namespace, version?)`	Install a collection to a temporary directory for this session.

Skill management

Tool	Description
`list_skills()`	List all generated skills (read-only).
`get_skill(skill_name)`	Read a skill's SKILL.md content (read-only).
`generate_skill(module_name, install_to?)`	Generate a skill package for one module. Returns SKILL.md inline.
`generate_collection_skills(collection_namespace, install_to?)`	Batch generate skills for an entire collection.

Resources

URI	Description
`skills://list`	List all generated skill packages
`skills://{skill_name}`	Read a skill's SKILL.md content by FQCN
`galaxy://installed`	List collections installed in this session
`docs://sources`	List configured documentation manifest sources

Prompts

Prompt	Description
`review_playbook(playbook_yaml)`	Review a playbook against module docs and best practices
`explain_module(module_name)`	Get a detailed module explanation with usage examples
`generate_role(role_purpose, modules)`	Generate a role skeleton using specified modules
`find_collection(platform_or_use_case)`	Guide through search, install, and explore workflow

Development

git clone https://github.com/leogallego/ansible-know-mcp.git
cd ansible-know-mcp
uv venv && source .venv/bin/activate
uv pip install -e ".[dev]"
pytest

Configuration

Environment Variable	Description	Default
`ANSIBLE_KNOWLEDGE_SKILLS_DIR`	Where to write generated skills	`./skills/`
`ANSIBLE_KNOWLEDGE_DOC_SOURCES`	JSON dict of doc manifest sources	Built-in ansible-core source
`ANSIBLE_KNOWLEDGE_GALAXY_URL`	Galaxy API base URL	`https://galaxy.ansible.com`

License

GPL-3.0-or-later

This server cannot be installed

license - permissive license

quality - not tested

maintenance

How are these scores calculated?

Maintenance

–Maintainers

29dResponse time

–Release cycle

–Releases (12mo)

Commit activity

Issues opened vs closed

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

Lightport: Open-Sourcing Glama's AI Gateway
By punkpeye on April 27, 2026.
open source
OpenAI
Tool Definition Quality Score (TDQS)
By punkpeye on April 3, 2026.
mcp
The Hackers Who Tracked My Sleep Cycle
By punkpeye on March 26, 2026.
security

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/leogallego/ansible-know-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server