Skip to main contentLeanMCP Documentation Plan
Main Goal
Transform the documentation to focus entirely on LeanMCP - the fastest way to build and deploy MCP Servers.
Content Strategy
Key Message
- LeanMCP = Fast MCP building and deployment
- MCPs = UI for AI Agents (every tool call is like a click)
- Simple words - No jargon or complex explanations
Core Topics to Cover
- What is LeanMCP - The fastest way to build MCPs
- Why MCPs Matter - They’re the UI for AI agents
- Building Good MCPs - Art of minimizing wrong tool calls
- Prototyping Workflows - Test AI workflows quickly
- From Prototype to Production - Easy deployment
Content to Remove
- All Mintlify generic content
- Documentation setup instructions
- Branding/customization guides
- API reference examples not related to LeanMCP
Page Structure Plan
Introduction Page (index.mdx)
- What is LeanMCP
- Why MCPs are important
- How LeanMCP helps you build better MCPs
Core Documentation Pages
- Getting Started - Building your first MCP
- MCP Best Practices - Art of good MCP design
- Testing & Prototyping - How to test AI workflows
- Deployment - From prototype to production
- API Reference - LeanMCP specific APIs
Writing Guidelines
- Simple words only - No technical jargon
- Short sentences - Easy to understand
- Clear examples - Show, don’t just tell
- Focus on LeanMCP - Everything must relate to our product
Implementation Approach
- Create plan (this document) ✅
- Update introduction page with new content
- Review all existing pages
- Remove unrelated content
- Add LeanMCP-focused content to each page
- Ensure consistency across all pages
Status
- Planning Phase - Documenting the approach
- Next Step - Update introduction page
- Waiting for - User approval to implement changes