diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
new file mode 100644
index 0000000..68d0b96
--- /dev/null
+++ b/CONTRIBUTING.md
@@ -0,0 +1,50 @@
+# Contributing to MCP Documentation
+
+Thank you for your interest in contributing to the Model Context Protocol (MCP) documentation! This guide will help you get started with contributing.
+
+## Getting Started
+
+1. Install the required tools:
+    - Node.js
+    - Git
+    - [Mintlify CLI](https://www.npmjs.com/package/mintlify): `npm i -g mintlify`
+
+2. Fork and clone the repository
+3. Create a new branch for your changes
+4. Run `mintlify dev` to preview changes locally
+
+## Documentation Guidelines
+
+- 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
+
+## Content Types
+
+You can contribute to:
+
+- Conceptual guides
+- API reference documentation
+- Tutorials and quickstarts
+- Best practices and examples
+- Troubleshooting guides
+
+## Pull Request Process
+
+1. Ensure your changes follow our documentation guidelines
+2. Update the relevant table of contents if needed
+3. Test your changes locally using `mintlify dev`
+4. Submit a pull request with a clear description of your changes
+5. Wait for review and address any feedback
+
+## Need Help?
+
+- Check existing documentation at [modelcontextprotocol.io](https://modelcontextprotocol.io)
+- [Open an issue](https://github.com/modelcontextprotocol/docs/issues) for bugs or concerns
+- Join our [community discussions](https://github.com/modelcontextprotocol/docs/discussions)
+
+## Code of Conduct
+
+Please note that this project follows our [Code of Conduct](CODE_OF_CONDUCT.md). By participating, you agree to uphold these guidelines.
diff --git a/README.md b/README.md
index 6c10353..a7d2a6e 100644
--- a/README.md
+++ b/README.md
@@ -1,26 +1,9 @@
 # Model Context Protocol Documentation
 
-The official docs of MCP. This README is a WIP.
+The official documentation for the [Model Context Protocol](https://modelcontextprotocol.io).
 
-### Development
-
-Install the [Mintlify CLI](https://www.npmjs.com/package/mintlify) to preview the documentation changes locally. To install, use the following command
-
-```
-npm i -g mintlify
-```
-
-Run the following command at the root of your documentation (where mint.json is)
-
-```
-mintlify dev
-```
+For detailed contribution guidelines, development setup, and troubleshooting, please see our [Contributing Guide](CONTRIBUTING.md).
 
 ### Publishing Changes
 
-Install our Github App to auto propagate changes from your repo to your deployment. Changes will be deployed to production automatically after pushing to the default branch. Find the link to install on your dashboard.
-
-#### Troubleshooting
-
-- Mintlify dev isn't running - Run `mintlify install` it'll re-install dependencies.
-- Page loads as a 404 - Make sure you are running in a folder with `mint.json`
+Changes will be deployed to production automatically after pushing to the default branch.