Skip to main content

LeanMCP 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

  1. What is LeanMCP - The fastest way to build MCPs
  2. Why MCPs Matter - They’re the UI for AI agents
  3. Building Good MCPs - Art of minimizing wrong tool calls
  4. Prototyping Workflows - Test AI workflows quickly
  5. 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

  1. Create plan (this document) ✅
  2. Update introduction page with new content
  3. Review all existing pages
  4. Remove unrelated content
  5. Add LeanMCP-focused content to each page
  6. Ensure consistency across all pages

Status

  • Planning Phase - Documenting the approach
  • Next Step - Update introduction page
  • Waiting for - User approval to implement changes