Merge pull request modelcontextprotocol#283 from modelcontextprotocol/justin/merge-docs

Merge user & specification documentation

Author: jspahrsummers

.github/workflows/site.yml

@@ -10,8 +10,7 @@ The following software is required to work on the spec:
 - Node.js 20 or above
 - TypeScript
 - TypeScript JSON Schema (for generating JSON schema)
-- [Hugo](https://gohugo.io/) (optional, for docs)
-- Go (optional, for docs)
+- [Mintlify](https://mintlify.com/) (optional, for docs)
 - nvm (optional, for managing Node versions)
 
 ## Getting Started
@@ -56,6 +55,21 @@ npm run generate:json     # generate JSON schema
 npm run serve:docs
 ```
 
+### Documentation Guidelines
+
+When contributing to the documentation:
+
+- Keep content clear, concise, and technically accurate
+- Follow the existing file structure and naming conventions
+- Include code examples where appropriate
+- Use proper MDX formatting and components
+- Test all links and code samples
+- Use appropriate headings: "When to use", "Steps", and "Tips" for tutorials
+- Place new pages in appropriate sections (concepts, tutorials, etc.)
+- Update docs.json when adding new pages
+- Follow existing file naming conventions (kebab-case.mdx)
+- Include proper frontmatter in MDX files
+
 ## Submitting Changes
 
 1. Push your changes to your fork

CNAME

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2024 Anthropic, PBC
+Copyright (c) 2024–2025 Anthropic, PBC and contributors
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

CONTRIBUTING.md

@@ -6,6 +6,9 @@ The schema is [defined in TypeScript](schema/2025-03-26/schema.ts) first, but
 [made available as JSON Schema](schema/2025-03-26/schema.json) as well, for wider
 compatibility.
 
+The official MCP documentation is built using Mintlify and available at
+[modelcontextprotocol.io](https://modelcontextprotocol.io).
+
 ## Contributing
 
 Please see [CONTRIBUTING.md](CONTRIBUTING.md) for details on how to contribute to this

LICENSE

@@ -0,0 +1,10 @@
+---
+title: Contributing
+description: How to participate in Model Context Protocol development
+---
+
+We welcome contributions from the community! Please review our [contributing guidelines](https://github.com/modelcontextprotocol/.github/blob/main/CONTRIBUTING.md) for details on how to submit changes.
+
+All contributors must adhere to our [Code of Conduct](https://github.com/modelcontextprotocol/.github/blob/main/CODE_OF_CONDUCT.md).
+
+For questions and discussions, please use [GitHub Discussions](https://github.com/orgs/modelcontextprotocol/discussions).

README.md

@@ -0,0 +1,54 @@
+---
+title: Roadmap
+description: Our plans for evolving Model Context Protocol
+---
+
+<Info>Last updated: **2025-03-27**</Info>
+
+The Model Context Protocol is rapidly evolving. This page outlines our current thinking on key priorities and direction for approximately **the next six months**, though these may change significantly as the project develops. To see what's changed recently, check out the **[specification changelog](/specification/2025-03-26/changelog/)**.
+
+<Note>The ideas presented here are not commitments—we may solve these challenges differently than described, or some may not materialize at all. This is also not an _exhaustive_ list; we may incorporate work that isn't mentioned here.</Note>
+
+We value community participation! Each section links to relevant discussions where you can learn more and contribute your thoughts.
+
+For a technical view of our standardization process, visit the [Standards Track](https://github.com/orgs/modelcontextprotocol/projects/2/views/2) on GitHub, which tracks how proposals progress toward inclusion in the official [MCP specification](https://spec.modelcontextprotocol.io).
+
+## Validation
+
+To foster a robust developer ecosystem, we plan to invest in:
+
+- **Reference Client Implementations**: demonstrating protocol features with high-quality AI applications
+- **Compliance Test Suites**: automated verification that clients, servers, and SDKs properly implement the specification
+
+These tools will help developers confidently implement MCP while ensuring consistent behavior across the ecosystem.
+
+## Registry
+
+For MCP to reach its full potential, we need streamlined ways to distribute and discover MCP servers.
+
+We plan to develop an [**MCP Registry**](https://github.com/orgs/modelcontextprotocol/discussions/159) that will enable centralized server discovery and metadata. This registry will primarily function as an API layer that third-party marketplaces and discovery services can build upon.
+
+## Agents
+
+As MCP increasingly becomes part of agentic workflows, we're exploring [improvements](https://github.com/modelcontextprotocol/specification/discussions/111) such as:
+
+- **[Agent Graphs](https://github.com/modelcontextprotocol/specification/discussions/94)**: enabling complex agent topologies through namespacing and graph-aware communication patterns
+- **Interactive Workflows**: improving human-in-the-loop experiences with granular permissioning, standardized interaction patterns, and [ways to directly communicate](https://github.com/modelcontextprotocol/specification/issues/97) with the end user
+
+## Multimodality
+
+Supporting the full spectrum of AI capabilities in MCP, including:
+
+- **Additional Modalities**: video and other media types
+- **[Streaming](https://github.com/modelcontextprotocol/specification/issues/117)**: multipart, chunked messages, and bidirectional communication for interactive experiences
+
+## Governance
+
+We're implementing governance structures that prioritize:
+
+- **Community-Led Development**: fostering a collaborative ecosystem where community members and AI developers can all participate in MCP's evolution, ensuring it serves diverse applications and use cases
+- **Transparent Standardization**: establishing clear processes for contributing to the specification, while exploring formal standardization via industry bodies
+
+## Get Involved
+
+We welcome your contributions to MCP's future! Join our [GitHub Discussions](https://github.com/orgs/modelcontextprotocol/discussions) to share ideas, provide feedback, or participate in the development process.

docs/clients.mdx

@@ -0,0 +1,58 @@
+---
+title: "What's New"
+description: 'The latest updates and improvements to MCP'
+---
+
+<Update label="2025-03-26" description="Kotlin SDK 0.4.0 released">
+- Fix issues and cleanup API
+- Added binary compatibility tracking to avoid breaking changes
+- Drop jdk requirements to JDK8 
+- Added Claude Desktop integration with sample
+- The full changelog can be found here: https://github.com/modelcontextprotocol/kotlin-sdk/releases/tag/0.4.0
+</Update>
+
+<Update label="2025-03-26" description="Java SDK 0.8.1 released">
+- Version [0.8.1](https://github.com/modelcontextprotocol/java-sdk/releases/tag/v0.8.1) of the MCP Java SDK has been released,
+    providing important bug fixes.
+</Update>
+<Update label="2025-03-24" description="C# SDK released">
+ - We are exited to announce the availability of the MCP
+   [C# SDK](https://github.com/modelcontextprotocol/csharp-sdk/) developed by
+   [Peder Holdgaard Pedersen](http://github.com/PederHP) and Microsoft. This joins our growing
+   list of supported languages. The C# SDK is also available as
+   [NuGet package](https://www.nuget.org/packages/ModelContextProtocol)
+ - Python SDK 1.5.0 was released with multiple fixes and improvements.
+</Update>
+<Update label="2025-03-21" description="Java SDK 0.8.0 released">
+- Version [0.8.0](https://github.com/modelcontextprotocol/java-sdk/releases/tag/v0.8.0) of the MCP Java SDK has been released,
+    delivering important session management improvements and bug fixes.
+</Update>
+<Update label="2025-03-10" description="Typescript SDK release">
+ - Typescript SDK 1.7.0 was released with multiple fixes and improvements.
+</Update>
+<Update label="2025-02-14" description="Java SDK released">
+  - We're excited to announce that the Java SDK developed by Spring AI at VMware Tanzu is now
+    the official [Java SDK](https://github.com/modelcontextprotocol/java-sdk) for MCP.
+    This joins our existing Kotlin SDK in our growing list of supported languages.
+    The Spring AI team will maintain the SDK as an integral part of the Model Context Protocol
+    organization. We're thrilled to welcome them to the MCP community!
+</Update>
+
+<Update label="2025-01-27" description="Python SDK 1.2.1">
+  - Version [1.2.1](https://github.com/modelcontextprotocol/python-sdk/releases/tag/v1.2.1) of the MCP Python SDK has been released,
+    delivering important stability improvements and bug fixes.
+</Update>
+<Update label="2025-01-18" description="SDK and Server Improvements">
+  - Simplified, express-like API in the [TypeScript SDK](https://github.com/modelcontextprotocol/typescript-sdk)
+  - Added 8 new clients to the [clients page](https://modelcontextprotocol.io/clients)
+</Update>
+
+<Update label="2025-01-03" description="SDK and Server Improvements">
+  - FastMCP API in the [Python SDK](https://github.com/modelcontextprotocol/python-sdk)
+  - Dockerized MCP servers in the [servers repo](https://github.com/modelcontextprotocol/servers)
+</Update>
+
+<Update label="2024-12-21" description="Kotlin SDK released">
+  - Jetbrains released a Kotlin SDK for MCP!
+  - For a sample MCP Kotlin server, check out [this repository](https://github.com/modelcontextprotocol/kotlin-sdk/tree/main/samples/kotlin-mcp-server)
+</Update>