Update app.py

app.py

@@ -220,6 +220,42 @@ with gr.Blocks(
     **Built for the MCP 1st Birthday Hackathon** 🎉
     """)
 
+    with gr.Accordion("ℹ️ API URL Guidelines & Tips", open=False):
+        gr.Markdown("""
+        ### ✅ What Works Best:
+        - **Base API URLs** (e.g., `https://api.example.com`)
+        - **REST APIs** with clear endpoints
+        - **OpenAPI/Swagger** documented APIs
+        - **Public APIs** (no complex auth)
+
+        ### 🎯 Try These Free APIs:
+
+        **No Auth Required (Perfect for Testing!):**
+        - `https://jsonplaceholder.typicode.com` - Fake REST API (best for testing!)
+        - `https://api.github.com` - GitHub public API
+        - `https://dog.ceo/api` - Random dog images
+        - `https://catfact.ninja` - Random cat facts
+        - `https://api.coindesk.com/v1/bpi` - Bitcoin prices
+        - `https://api.ipify.org` - Get IP address
+
+        **With API Key (Free Tier):**
+        - `https://api.openweathermap.org/data/2.5` - Weather data
+        - `https://newsapi.org/v2` - News articles
+        - `https://api.stripe.com` - Payment processing (test mode)
+
+        ### 💡 Tips:
+        - **Start with jsonplaceholder.typicode.com** - always works!
+        - Paste the **base URL** (not a specific endpoint)
+        - If API needs a key, add it in the "API Key" field below
+        - Cached URLs generate instantly (try the same URL twice!)
+
+        ### ⚠️ May Not Work Well:
+        - GraphQL APIs (REST only for now)
+        - APIs requiring OAuth flows
+        - WebSocket-only APIs
+        - APIs with very complex authentication
+        """)
+
     with gr.Row():
         with gr.Column(scale=2):
             gr.Markdown("### 📝 Input")
@@ -249,18 +285,23 @@ with gr.Blocks(
                 size="lg"
             )
 
-            with gr.Accordion("📚 Examples & Tips", open=False):
+            with gr.Accordion("🚀 Quick Start Examples", open=True):
                 gr.Markdown("""
-                **Try these APIs:**
-                - `https://jsonplaceholder.typicode.com` - Fake REST API (great for testing!)
-                - `https://api.github.com` - GitHub API
-                - `https://api.stripe.com` - Stripe API
-                - `https://api.openweathermap.org` - Weather API
-
-                **💡 Tips:**
-                - MCPs are cached by URL to save API calls
-                - Check "Force Regenerate" to create a fresh version
-                - Generated MCPs use stdio transport (works locally)
+                **Click to copy and paste:**
+
+                ```
+                https://jsonplaceholder.typicode.com
+                ```
+                ⭐ **Recommended first try!** Always works, no API key needed.
+
+                ---
+
+                **More examples:**
+                - `https://api.github.com` - GitHub API (no auth)
+                - `https://dog.ceo/api` - Dog images (fun!)
+                - `https://catfact.ninja` - Cat facts (simple)
+
+                💡 **Tip:** MCPs are cached - try the same URL twice to see instant results!
                 """)
 
     gr.Markdown("---")