Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx agentmods add commands/fabriciofs/mcp-sql-server/mcp-docsgit clone --depth 1 https://github.com/fabriciofs/mcp-sql-serverWhat it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5 | $0.00000 | $0.00718 |
| Opus 5 | $0.00000 | $0.00359 |
| Sonnet 5 | $0.00000 | $0.00144 |
| Haiku 4.5 | $0.00000 | $0.00072 |
Grade A, and why
mcp-docs scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
This is a copy
100% identical to mcp-docs — 0 lines differ, which has more behind it and is treated as the original. This page carries a canonical link to it rather than competing with it.
How it starts
The opening of the file, as written. The whole thing — 150 lines — stays where its author put it; the contents beside it link to each section on GitHub.
MCP Documentation Generator
Você é um especialista em criar documentação clara e completa para servidores MCP.
Estrutura de Documentação
README.md Template
# MCP Server Name
Descrição curta do que o servidor faz.
## Features
- Feature 1
- Feature 2
## Installation
\`\`\`bash
npm install
npm run build
\`\`\`
## Configuration
### Environment Variables
| Variable | Required | Description | Example |
|----------|----------|-------------|---------|
| VAR_NAME | Yes/No | O que faz | valor |
### Claude Desktop Config
\`\`\`json
{
"mcpServers": {
"server-name": {
"command": "node",
"args": ["/path/to/build/index.js"],
"env": {
"VAR": "value"
}
}
}
}
\`\`\`
## Available Tools
### tool_name
**Description**: O que a tool faz
**Parameters**:
| Name | Type | Required | Description |
|------|------|----------|-------------|
| param | string | Yes | Descrição |
**Example**:
\`\`\`json
{
"param": "value"
}
\`\`\`
**Response**:
\`\`\`json
{
"result": "value"
}
\`\`\`
## Development
\`\`\`bash
npm run dev # Watch mode
npm run build # Compile
npm run inspector # Test with MCP Inspector
\`\`\`
## License
MIT
Documentação de Tools
Para cada tool, documente:
- Nome: Identificador único
- Descrição: O que faz e quando usar
- Parâmetros: Tabela com tipo, obrigatoriedade e descrição
- Exemplos: Inputs e outputs reais
- Erros: Possíveis erros e como resolver
- Limitações: Limites, restrições, casos não suportados
Boas Práticas de Documentação
Para Desenvolvedores
- Como configurar ambiente de dev
- Arquitetura do código
- Como adicionar novas tools
- Como rodar testes
Para Usuários
- Instalação passo a passo
- Configuração no Claude
- Exemplos de uso comuns
- Troubleshooting
Para o LLM (nas descrições das tools)
- Seja específico sobre o propósito
- Liste limitações importantes
- Explique o formato esperado de input/output
- Dê exemplos no .describe() do Zod
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 2d ago First seen · 150 lines · 0 tokens per session scan A f95deda7c041
mcp-docs is a command published in the GitHub repository fabriciofs/mcp-sql-server (1 stars, last pushed 1mo ago), licensed MIT. It costs nothing until one of its globs matches a file; then it loads 718 tokens. A static security scan graded it A with 0 findings. It is 100% identical to mcp-docs, differing in 0 lines, and is treated as a copy.
Other commands, from other repositories
claude-flow-swarm
Coordinate multi-agent swarms for complex tasks.
bootstrap
PACT session-start ritual — identify the session team (platform-provisioned), secretary spawn, paused-state surface, bootstrap marker.
ox-session-review
Command "ox-session-review" from sageox/ox, covering failure-mode watch-list (read first), from the ledger root. should print 0, phase 1 — scan & score (read-only), quality buckets (first match wins) and removal candidates.
add-agent
引导新增一个 Agent 适配器。用法 /add-agent.
handoff
Package current state for the next agent.
xdo
Direct development by the Main Agent.