create-mcp-md

Generate registry-ready mcp.md documentation from mcp.json server configuration.

Updated May 19, 2026
One-click install
npx skills add https://github.com/blouargant/yoke-registry --skill create-mcp-md
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: create-mcp-md
Source: https://github.com/blouargant/yoke-registry/tree/main/.agents/skills/create-mcp-md
Command: npx skills add https://github.com/blouargant/yoke-registry --skill create-mcp-md

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Creating consistent registry documentation for MCP servers is slow and error-prone when users manually translate settings from mcp.json into mcp.md.

Core Features & Use Cases

  • Automatic mcp.md generation: Converts server name, command/args or type/url, env, headers, and inputs directly from an existing mcp.json into the registry’s mcp.md format.
  • Documentation gathering with fallbacks: Pulls tool/function details from an existing README, upstream documentation (or prompts for missing URL info), or the tool’s --help output.
  • Registry-safe linking: Only adds a skills: entry when a matching skill name already exists, avoiding invented or incorrect references.

Quick Start

Tell the assistant: "Read mcp/<Category>/<name>/mcp.json, gather any available documentation, and generate the correct mcp.md using the registry convention."

Frequently Asked Questions about create-mcp-md

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate mcp.md documentation from mcp.json automatically?

You can generate mcp.md documentation by parsing an existing mcp.json to extract server configurations, command/args, and headers, then writing the output with accurate frontmatter to match registry conventions.

What is the best way to create registry-ready MCP server documentation?

Creating registry-ready MCP server documentation involves extracting server settings and optional inputs from mcp.json and translating them into a standardized mcp.md format with correct frontmatter and headers.

How does documentation gathering work for MCP tools with missing information?

Documentation gathering works by pulling tool descriptions from existing README files, upstream documentation, or --help command output, and prompting for missing URL information when necessary.

Can I use mcp.json settings to add new MCP server entries to a registry?

Yes, you can use mcp.json settings to add new MCP server entries by converting server names, type/url, environment variables, and inputs directly into the registry's required mcp.md format.

When do I need to generate mcp.md files for MCP servers?

You need to generate mcp.md files when adding new MCP server entries to the yoke-registry, ensuring the resulting documentation matches the expected convention and includes accurate configuration details.

Why does mcp.md generation only add skills entries for existing skill names?

Mcp.md generation only adds skills entries when a matching skill name already exists to prevent invented or incorrect references, ensuring registry-safe linking within the documentation.