move specs under a specification header

Author: dsp-ant

docs/_index.md

@@ -1,58 +1,10 @@
 ---
-title: Model Context Protocol Specification
+title: Specification
 cascade:
   type: docs
+weight: 1
 ---
+The following is the formal specification of the Model Context Protocol, and aims
+to be a resource for implementors.
 
-{{< callout type="info" >}}
-**Protocol Revision**: 2024-11-05 (Final)
-{{< /callout >}}
-
-The Model Context Protocol (MCP) is an open protocol that enables seamless integration between LLM applications and external data sources and tools. Whether you're building an AI-powered IDE, enhancing a chat interface, or creating custom AI workflows, MCP provides a standardized way to connect LLMs with the context they need. This specification defines the authoritative protocol requirements based on the TypeScript schema in [schema.ts](https://github.com/modelcontextprotocol/specification/blob/main/schema/schema.ts). For implementation guides and examples, visit [modelcontextprotocol.io](https://modelcontextprotocol.io).
-
-## Overview
-
-MCP provides a standardized way for applications to:
-
-- Share contextual information with language models
-- Expose tools and capabilities to AI systems
-- Build composable integrations and workflows
-
-The protocol uses JSON-RPC 2.0 messages to establish communication between:
-
-- **Clients**: Applications that integrate with language models
-- **Servers**: Services that provide context and capabilities
-- **Hosts**: Processes that manage client connections
-
-## Core Protocol Features
-
-MCP defines several key components:
-
-### Base Protocol
-- JSON-RPC message format
-- Capability negotiation
-- Session lifecycle management
-
-### Context Primitives
-- **Resources**: Data exposed via URIs
-- **Prompts**: Template-based interactions
-- **Tools**: Executable functions
-- **Sampling**: LLM generation control
-
-### Cross-Cutting Concerns
-- Progress tracking
-- Error handling
-- Security boundaries
-- Backwards compatibility
-
-## Learn More
-
-Explore the detailed specification for each protocol component:
-
-{{< cards >}}
-  {{< card link="architecture" title="Architecture" icon="template" >}}
-  {{< card link="basic" title="Base Protocol" icon="code" >}}
-  {{< card link="server" title="Server Features" icon="server" >}}
-  {{< card link="client" title="Client Features" icon="user" >}}
-  {{< card link="contributing" title="Contributing" icon="pencil" >}}
-{{< /cards >}}
+For a user guides and SDK configuration, plesae visit https://modelcontextprotocol.io.

docs/documentation/_index.md

@@ -0,0 +1,13 @@
+---
+title: "User Documentation"
+weight: 20
+---
+
+The Model Context Protocol (MCP) provides multiple resources for documentation and implementation:
+
+- **User Documentation**: Visit [modelcontextprotocol.io](https://modelcontextprotocol.io) for comprehensive user-facing documentation
+- **Python SDK**: The Python implementation is available at [github.com/modelcontextprotocol/python-sdk](https://github.com/modelcontextprotocol/python-sdk) - [Discussions](https://github.com/modelcontextprotocol/python-sdk/discussions)
+- **Specification**: The core specification is available at [github.com/modelcontextprotocol/specification](https://github.com/modelcontextprotocol/specification) - [Discussions](https://github.com/modelcontextprotocol/specification/discussions)
+- **TypeScript SDK**: The TypeScript implementation can be found at [github.com/modelcontextprotocol/typescript-sdk](https://github.com/modelcontextprotocol/typescript-sdk) - [Discussions](https://github.com/modelcontextprotocol/typescript-sdk/discussions)
+
+For questions or discussions, please open a discussion in the appropriate GitHub repository based on your implementation or use case. You can also visit the [Model Context Protocol organization on GitHub](https://github.com/modelcontextprotocol) to see all repositories and ongoing development.

docs/specification/_index.md

@@ -0,0 +1,59 @@
+---
+title: Specification
+cascade:
+  type: docs
+weight: 10
+---
+
+{{< callout type="info" >}}
+**Protocol Revision**: 2024-11-05 (Final)
+{{< /callout >}}
+
+The Model Context Protocol (MCP) is an open protocol that enables seamless integration between LLM applications and external data sources and tools. Whether you're building an AI-powered IDE, enhancing a chat interface, or creating custom AI workflows, MCP provides a standardized way to connect LLMs with the context they need. This specification defines the authoritative protocol requirements based on the TypeScript schema in [schema.ts](https://github.com/modelcontextprotocol/specification/blob/main/schema/schema.ts). For implementation guides and examples, visit [modelcontextprotocol.io](https://modelcontextprotocol.io).
+
+## Overview
+
+MCP provides a standardized way for applications to:
+
+- Share contextual information with language models
+- Expose tools and capabilities to AI systems
+- Build composable integrations and workflows
+
+The protocol uses JSON-RPC 2.0 messages to establish communication between:
+
+- **Clients**: Applications that integrate with language models
+- **Servers**: Services that provide context and capabilities
+- **Hosts**: Processes that manage client connections
+
+## Core Protocol Features
+
+MCP defines several key components:
+
+### Base Protocol
+- JSON-RPC message format
+- Capability negotiation
+- Session lifecycle management
+
+### Context Primitives
+- **Resources**: Data exposed via URIs
+- **Prompts**: Template-based interactions
+- **Tools**: Executable functions
+- **Sampling**: LLM generation control
+
+### Cross-Cutting Concerns
+- Progress tracking
+- Error handling
+- Security boundaries
+- Backwards compatibility
+
+## Learn More
+
+Explore the detailed specification for each protocol component:
+
+{{< cards >}}
+  {{< card link="architecture" title="Architecture" icon="template" >}}
+  {{< card link="basic" title="Base Protocol" icon="code" >}}
+  {{< card link="server" title="Server Features" icon="server" >}}
+  {{< card link="client" title="Client Features" icon="user" >}}
+  {{< card link="contributing" title="Contributing" icon="pencil" >}}
+{{< /cards >}}