What is the primary purpose of the MCP Tools Catalog skill?

It scans your active Model Context Protocol (MCP) environment to create a detailed markdown catalog of all available tool functions and servers for your project.

How does it know which tools are currently active?

It uses the `codex mcp list --json` command combined with a specialized runtime prompt to identify functions currently available in your specific session.

Can I use a custom template for the tool catalog?

Yes, the skill is designed to use `assets/mcp-tools-template.md` to ensure the generated documentation matches your project's styling.

Does this skill automatically overwrite my project files?

No. The skill drafts the documentation in the chat first and requires you to type 'CONFIRM' before it writes any files to your directory.

Which files does this skill manage?

It creates or updates `docs/mcp-tools.md` and can optionally update `AGENTS.md` if it is missing a reference to the tool catalog.

MCP Tools Catalog Generator

Name: MCP Tools Catalog Generator
Author: bnufw

bybnufw

0•

Learning & Documentation

Automatically generates and maintains a comprehensive documentation catalog of active Model Context Protocol (MCP) tools and servers.

The MCP Tools Catalog skill automates the tedious task of documenting available Model Context Protocol capabilities within your project. By inspecting the runtime MCP tool list and active servers, it generates a standardized `docs/mcp-tools.md` file that provides a clear overview of every function available to your AI agent. This skill ensures your project documentation stays in sync with your environment, automatically maps tool functions to their respective servers, and even updates your `AGENTS.md` file to ensure all references are correctly linked for better agent discoverability.

Key Features

01Safety-first confirmation workflow before making file changes

02Automatic synchronization with AGENTS.md references

030 GitHub stars

04Automated generation of project-local markdown documentation

05Template-based cataloging for consistent formatting

06Real-time discovery of active MCP servers and tool functions

Use Cases

01Maintaining up-to-date documentation of AI capabilities for large development teams

02Auditing active MCP tools to ensure only necessary servers are enabled

03Providing AI agents with a structured reference map of available functions within a repository

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add bnufw/lear_by_ai mcp-tools-catalog

For use in Claude.ai and ChatGPT

Download Skill