diff --git a/docs/first-server/python.mdx b/docs/first-server/python.mdx
index a551d5f..31fc673 100644
--- a/docs/first-server/python.mdx
+++ b/docs/first-server/python.mdx
@@ -427,7 +427,7 @@ This guide uses the OpenWeatherMap API. You'll need a free API key from [OpenWea
   </Card>
 </CardGroup>
 
-## Available Transports
+## Available transports
 
 While this guide uses stdio transport, MCP supports multiple transport options:
 
@@ -445,7 +445,7 @@ transport = SSEServerTransport("/events", response)
 
 ## Troubleshooting
 
-### Installation Issues
+### Installation issues
 ```bash
 # Check Python version
 python --version
@@ -455,14 +455,14 @@ pip uninstall -r requirements.txt
 pip install -r requirements.txt
 ```
 
-### Runtime Errors
+### Runtime errors
 ```bash
 # Enable debug logging
 export MCP_LOG_LEVEL=DEBUG
 python weather_server.py
 ```
 
-### Type Checking
+### Type checking
 ```bash
 # Install mypy
 pip install mypy
@@ -523,7 +523,7 @@ mypy weather_server.py
   </Accordion>
 </AccordionGroup>
 
-## Advanced Features
+## Advanced features
 
 <Steps>
   <Step title="Add caching">
diff --git a/docs/first-server/typescript.mdx b/docs/first-server/typescript.mdx
index ecd06d8..0047394 100644
--- a/docs/first-server/typescript.mdx
+++ b/docs/first-server/typescript.mdx
@@ -562,7 +562,7 @@ This guide uses the OpenWeatherMap API. You'll need a free API key from [OpenWea
   </Card>
 </CardGroup>
 
-## Available Transports
+## Available transports
 
 While this guide uses stdio transport, MCP supports multiple transport options:
 
@@ -580,7 +580,7 @@ const transport = new SSEServerTransport("/events", response);
 
 ## Troubleshooting
 
-### Build Errors
+### Build errors
 ```bash
 # Check TypeScript version
 npx tsc --version
@@ -590,7 +590,7 @@ rm -rf dist/
 npm run build
 ```
 
-### Runtime Errors
+### Runtime errors
 Look for detailed error messages in the Claude app logs:
 ```bash
 # Launch Claude with logging
@@ -600,7 +600,7 @@ open /Applications/Claude.app --stdout ~/Claude.log --stderr ~/Claude.log
 tail -f ~/Claude.log
 ```
 
-### Type Errors
+### Type errors
 ```bash
 # Check types without building
 npx tsc --noEmit