name: mcp-docs-skill
description: Create documentation for MCP servers, tools, endpoints, and agent integrations.
category: documentation
version: 1.0.0
author: Codex Hermes
--------------------

# MCP Docs Skill

Use this skill when the user wants to document an MCP server, MCP tools, agent gateway, or backend integration.

## Required Inputs

* Project name
* MCP server URL
* Available tools
* REST endpoints, if any
* Environment variables
* Deployment platform
* Agent runtime target
* Example use cases

## Process

1. Explain what the MCP server does.
2. Document each tool clearly.
3. Include input and output examples.
4. Include setup instructions.
5. Add deployment notes.
6. Add security notes for environment variables.
7. Keep everything copy-ready for README or docs pages.

## Output Format

Return:

1. Overview
2. Architecture
3. MCP server URL
4. Tool list
5. Tool input schemas
6. Example calls
7. Environment variables
8. Deployment guide
9. Agent integration guide
10. Security notes

## Rules

* Do not expose real API keys.
* Use placeholders for secrets.
* Be clear about local vs remote MCP.
* Mention that backend secrets must stay server-side.