docs(mcp): make complete reference the primary entrypoint

Author: juanklagos

README.es.md

@@ -55,10 +55,10 @@ npm run build
 - Ejemplo para Cursor: [`packages/sdd-mcp/examples/.cursor/mcp.json`](./packages/sdd-mcp/examples/.cursor/mcp.json)
 - Ejemplo para Codex: [`packages/sdd-mcp/examples/codex.config.toml`](./packages/sdd-mcp/examples/codex.config.toml)
 
-3. Lee la guía de instalación:
+3. Lee en este orden:
+- [docs/es/41-referencia-completa-mcp.md](./docs/es/41-referencia-completa-mcp.md)
 - [docs/es/33-guia-servidor-mcp.md](./docs/es/33-guia-servidor-mcp.md)
 - [docs/es/40-referencia-resultados-comandos.md](./docs/es/40-referencia-resultados-comandos.md)
-- [docs/es/41-referencia-completa-mcp.md](./docs/es/41-referencia-completa-mcp.md)
 
 ## 🎬 Flujo rápido de adopción
 
@@ -174,9 +174,9 @@ Paquete obligatorio por feature:
 
 - Esenciales: [Estructura](./docs/es/01-estructura.md) · [Flujo](./docs/es/02-flujo-de-trabajo.md)
 - IA: [Agentes soportados](./docs/es/10-agentes-ia-soportados-y-prompts.md) · [Guía Lovable](./docs/es/17-trabajar-con-lovable.md)
-- MCP: [Guía del servidor MCP](./docs/es/33-guia-servidor-mcp.md)
+- MCP: [Referencia completa](./docs/es/41-referencia-completa-mcp.md)
+- Setup MCP: [Guía del servidor](./docs/es/33-guia-servidor-mcp.md)
 - Resultado por comando: [Referencia](./docs/es/40-referencia-resultados-comandos.md)
-- Tools MCP: [Referencia completa](./docs/es/41-referencia-completa-mcp.md)
 - Setup clientes: [Recetas](./docs/es/36-recetas-setup-clientes.md)
 - Versionado: [Estrategia](./docs/es/37-estrategia-versionado.md)
 - Roadmap: [Roadmap público](./docs/es/35-roadmap-publico.md)

README.md

@@ -55,10 +55,10 @@ npm run build
 - Cursor example: [`packages/sdd-mcp/examples/.cursor/mcp.json`](./packages/sdd-mcp/examples/.cursor/mcp.json)
 - Codex example: [`packages/sdd-mcp/examples/codex.config.toml`](./packages/sdd-mcp/examples/codex.config.toml)
 
-3. Read the setup guide:
+3. Read in this order:
+- [docs/en/41-complete-mcp-reference.md](./docs/en/41-complete-mcp-reference.md)
 - [docs/en/33-mcp-server-guide.md](./docs/en/33-mcp-server-guide.md)
 - [docs/en/40-command-results-reference.md](./docs/en/40-command-results-reference.md)
-- [docs/en/41-complete-mcp-reference.md](./docs/en/41-complete-mcp-reference.md)
 
 ## 🎬 Fast Adoption Flow
 
@@ -174,9 +174,9 @@ Mandatory spec bundle (for each feature):
 
 - Essentials: [Structure](./docs/en/01-structure.md) · [Workflow](./docs/en/02-workflow.md)
 - AI: [Supported Agents](./docs/en/10-supported-ai-agents-and-prompts.md) · [Lovable Guide](./docs/en/17-working-with-lovable.md)
-- MCP: [MCP Server Guide](./docs/en/33-mcp-server-guide.md)
-- Command Results: [Reference](./docs/en/40-command-results-reference.md)
-- MCP Tools: [Complete Reference](./docs/en/41-complete-mcp-reference.md)
+- MCP: [Complete Reference](./docs/en/41-complete-mcp-reference.md)
+- MCP Setup: [Server Guide](./docs/en/33-mcp-server-guide.md)
+- MCP Results: [Command Reference](./docs/en/40-command-results-reference.md)
 - Client Setup: [Recipes](./docs/en/36-client-setup-recipes.md)
 - Versioning: [Strategy](./docs/en/37-versioning-strategy.md)
 - Roadmap: [Public Roadmap](./docs/en/35-public-roadmap.md)

docs/README.md

@@ -45,6 +45,7 @@ flowchart LR
 ## Core SDD references / Referencias SDD base
 - Workflow: [EN](./en/02-workflow.md) | [ES](./es/02-flujo-de-trabajo.md)
 - Spec Kit integration: [EN](./en/08-github-spec-kit-integration.md) | [ES](./es/08-integracion-github-spec-kit.md)
+- MCP complete reference: [EN](./en/41-complete-mcp-reference.md) | [ES](./es/41-referencia-completa-mcp.md)
 - MCP server guide: [EN](./en/33-mcp-server-guide.md) | [ES](./es/33-guia-servidor-mcp.md)
 - Launch kit: [EN](./en/34-launch-kit.md) | [ES](./es/34-kit-lanzamiento.md)
 - Public roadmap: [EN](./en/35-public-roadmap.md) | [ES](./es/35-roadmap-publico.md)

docs/en/33-mcp-server-guide.md

@@ -2,7 +2,10 @@
 
 ## Purpose
 
-This guide explains how to run, connect, and use the local `sdd-mcp` server as the operational MCP layer of this framework.
+This guide is only for MCP setup and connectivity.
+
+If you want the full functional reference, start here:
+- [Complete MCP Reference](./41-complete-mcp-reference.md)
 
 Product split:
 - repository root: canonical SDD framework
@@ -11,6 +14,8 @@ Product split:
 
 ## What is already implemented
 
+High-level summary only:
+
 Transports:
 - `stdio`
 - `Streamable HTTP`
@@ -81,9 +86,9 @@ Entrypoints:
 - do not implement code before approved spec and consistent plan
 - request explicit user consent only when implementation is about to start
 
-See also:
-- [Command Results Reference](./40-command-results-reference.md)
+Related references:
 - [Complete MCP Reference](./41-complete-mcp-reference.md)
+- [Command Results Reference](./40-command-results-reference.md)
 
 ## Copy-paste config examples
 

docs/en/40-command-results-reference.md

@@ -4,6 +4,9 @@
 
 This guide documents what each core script and MCP tool creates, modifies, and returns.
 
+For the complete MCP overview, tool intent, resources, and prompts, start here:
+- [Complete MCP Reference](./41-complete-mcp-reference.md)
+
 ## Workspace and bootstrap scripts
 
 ### `./scripts/create-www-project.sh <project-name> <assistant> [flags]`

docs/es/33-guia-servidor-mcp.md

@@ -2,7 +2,10 @@
 
 ## Propósito
 
-Esta guía explica cómo ejecutar, conectar y usar el servidor local `sdd-mcp` como la capa MCP operativa de este framework.
+Esta guía es solo para setup y conectividad MCP.
+
+Si quieres la referencia funcional completa, empieza aquí:
+- [Referencia completa de MCP](./41-referencia-completa-mcp.md)
 
 Separación del producto:
 - raíz del repositorio: framework SDD canónico
@@ -11,6 +14,8 @@ Separación del producto:
 
 ## Lo que ya está implementado
 
+Resumen de alto nivel solamente:
+
 Transportes:
 - `stdio`
 - `Streamable HTTP`
@@ -81,9 +86,9 @@ Entrypoints:
 - no implementes código antes de tener spec aprobada y plan consistente
 - solicita consentimiento explícito solo cuando la implementación vaya a comenzar
 
-Ver también:
-- [Referencia de resultados por comando](./40-referencia-resultados-comandos.md)
+Referencias relacionadas:
 - [Referencia completa de MCP](./41-referencia-completa-mcp.md)
+- [Referencia de resultados por comando](./40-referencia-resultados-comandos.md)
 
 ## Ejemplos listos para copiar
 

docs/es/40-referencia-resultados-comandos.md

@@ -4,6 +4,9 @@
 
 Esta guía documenta qué crea, qué modifica y qué devuelve cada script principal y cada tool MCP.
 
+Para la visión completa de MCP, intención de tools, resources y prompts, empieza aquí:
+- [Referencia completa de MCP](./41-referencia-completa-mcp.md)
+
 ## Scripts de workspace e inicialización
 
 ### `./scripts/create-www-project.sh <nombre-proyecto> <assistant> [flags]`