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.