ping-mcp-server 0.1.19 → 0.1.22

package/dist/index.js

@@ -75,6 +75,66 @@ function clearAuth() {
   delete config.serverWalletAddress;
   saveConfig(config);
 }
+var CONTEXT_FILE = path.join(CONFIG_DIR, "context.json");
+function loadContext() {
+  try {
+    if (fs.existsSync(CONTEXT_FILE)) {
+      const data = fs.readFileSync(CONTEXT_FILE, "utf-8");
+      return JSON.parse(data);
+    }
+  } catch (error) {
+  }
+  return { problems: [], techStack: [], lastUpdated: (/* @__PURE__ */ new Date()).toISOString() };
+}
+function saveContext(context) {
+  try {
+    if (!fs.existsSync(CONFIG_DIR)) {
+      fs.mkdirSync(CONFIG_DIR, { recursive: true });
+    }
+    context.lastUpdated = (/* @__PURE__ */ new Date()).toISOString();
+    fs.writeFileSync(CONTEXT_FILE, JSON.stringify(context, null, 2));
+  } catch (error) {
+    console.error("Failed to save context:", error);
+  }
+}
+function generateQuestionSuggestions(context) {
+  const suggestions = [];
+  const templates = {
+    decision: [
+      "Choosing between {X} - what would you pick and why?",
+      "Is {X} worth the added complexity?",
+      "Anyone regret going with {X}? What would you do differently?"
+    ],
+    debugging: [
+      "Seeing weird behavior with {X} - anyone dealt with this?",
+      "What's the gotcha everyone hits with {X}?"
+    ],
+    architecture: [
+      "What's the production-ready way to handle {X}?",
+      "Is {X} overkill for a small team?",
+      "How do you think about {X} vs just keeping it simple?"
+    ],
+    tooling: [
+      "What's the vibe on {X} in 2025? Worth adopting?",
+      "Anyone actually using {X} in production? How's it going?",
+      "What do people actually use for {X}? (not what's popular on Twitter)"
+    ],
+    other: [
+      "What's your take on {X}?",
+      "How do you think about {X}?"
+    ]
+  };
+  for (const problem of context.problems.slice(0, 3)) {
+    const categoryTemplates = templates[problem.category] || templates.other;
+    const template = categoryTemplates[Math.floor(Math.random() * categoryTemplates.length)];
+    suggestions.push(template.replace("{X}", problem.summary));
+  }
+  if (context.techStack.length > 0) {
+    const tech = context.techStack[0];
+    suggestions.push(`What's something you wish you knew before using ${tech}?`);
+  }
+  return suggestions;
+}
 function generateSuggestedAnswers(questionText, category) {
   const lowerQuestion = questionText.toLowerCase();
   if (lowerQuestion.includes("coffee") && lowerQuestion.includes("tea")) {
@@ -503,6 +563,42 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
         }
       },
       // ────────────────────────────────────────────────────────
+      // CONTEXT TOOLS (for smart question suggestions)
+      // ────────────────────────────────────────────────────────
+      {
+        name: "ping_log_context",
+        description: "Log what the user is working on for smarter question suggestions. Call this when you notice the user is: making a decision between options, debugging something tricky, discussing architecture, or evaluating tools. This helps Ping suggest relevant questions later.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            summary: {
+              type: "string",
+              description: 'Brief summary of the problem/decision (e.g., "choosing between Prisma and Drizzle")'
+            },
+            category: {
+              type: "string",
+              enum: ["decision", "debugging", "architecture", "tooling", "other"],
+              description: "Type of problem"
+            },
+            tags: {
+              type: "array",
+              items: { type: "string" },
+              description: 'Related technologies or concepts (e.g., ["orm", "database", "typescript"])'
+            }
+          },
+          required: ["summary", "category"]
+        }
+      },
+      {
+        name: "ping_suggest_questions",
+        description: "Get question suggestions based on what the user has been working on. Call this when: (1) user wants to create a question but doesn't know what to ask, (2) you notice something that would benefit from human expertise/taste rather than AI knowledge, (3) proactively when the user has been wrestling with a decision. Returns taste/judgment questions that humans answer better than AI.",
+        inputSchema: {
+          type: "object",
+          properties: {},
+          required: []
+        }
+      },
+      // ────────────────────────────────────────────────────────
       // LEGACY: SET WALLET (for users without GitHub auth)
       // ────────────────────────────────────────────────────────
       {
@@ -820,7 +916,7 @@ Use ping_login to sign in with a different account.`
       // ────────────────────────────────────────────────────────
       case "ping_welcome": {
         const auth = getAuth();
-        const MCP_VERSION = "0.1.19";
+        const MCP_VERSION = "0.1.21";
         let userLine = "\u274C Not logged in";
         let arenaBadge = "";
         if (auth) {
@@ -836,9 +932,15 @@ Use ping_login to sign in with a different account.`
         let questionsAvailable = 0;
         let answersToday = 0;
         let claimedToday = "$0.00";
+        if (auth) {
+          try {
+            const questionsData = await apiRequest("/questions?limit=1");
+            questionsAvailable = questionsData.totalAvailable;
+          } catch {
+          }
+        }
         try {
           const stats = await apiRequest("/stats");
-          questionsAvailable = stats.questions.active;
           answersToday = stats.responses.today;
           claimedToday = stats.rewards.claimedToday;
         } catch {
@@ -898,6 +1000,89 @@ ${settingsUrl}`
         };
       }
       // ────────────────────────────────────────────────────────
+      // LOG CONTEXT (for smart question suggestions)
+      // ────────────────────────────────────────────────────────
+      case "ping_log_context": {
+        const { summary, category, tags = [] } = args || {};
+        if (!summary || !category) {
+          return {
+            content: [{
+              type: "text",
+              text: "\u274C Missing required fields: summary and category"
+            }]
+          };
+        }
+        const context = loadContext();
+        context.problems.unshift({
+          summary,
+          category,
+          tags,
+          timestamp: (/* @__PURE__ */ new Date()).toISOString()
+        });
+        context.problems = context.problems.slice(0, 10);
+        for (const tag of tags) {
+          if (!context.techStack.includes(tag)) {
+            context.techStack.unshift(tag);
+          }
+        }
+        context.techStack = context.techStack.slice(0, 10);
+        saveContext(context);
+        return {
+          content: [{
+            type: "text",
+            text: `\u{1F4DD} Logged: "${summary}" (${category})
+
+This will help suggest relevant questions later.`
+          }]
+        };
+      }
+      // ────────────────────────────────────────────────────────
+      // SUGGEST QUESTIONS (based on stored context)
+      // ────────────────────────────────────────────────────────
+      case "ping_suggest_questions": {
+        const context = loadContext();
+        if (context.problems.length === 0 && context.techStack.length === 0) {
+          return {
+            content: [{
+              type: "text",
+              text: `\u{1F4A1} No context stored yet!
+
+As you work, I'll learn what you're dealing with and suggest relevant questions.
+
+**Generic taste/judgment questions:**
+\u2022 "What's something you wish you knew earlier in your career?"
+\u2022 "What tool do you use that most people don't know about?"
+\u2022 "What's overrated in tech right now?"`
+            }]
+          };
+        }
+        const suggestions = generateQuestionSuggestions(context);
+        let output = `\u{1F4A1} **Question suggestions based on your recent work:**
+
+`;
+        suggestions.forEach((q, i) => {
+          output += `${i + 1}. "${q}"
+`;
+        });
+        output += `
+**Your recent context:**
+`;
+        output += `\u2022 Problems: ${context.problems.slice(0, 3).map((p) => p.summary).join(", ")}
+`;
+        if (context.techStack.length > 0) {
+          output += `\u2022 Tech: ${context.techStack.slice(0, 5).join(", ")}
+`;
+        }
+        output += `
+_Pick one to ask, edit it, or write your own!_`;
+        return {
+          content: [{
+            type: "text",
+            text: output
+          }]
+        };
+      }
+      // ────────────────────────────────────────────────────────
       // SET WALLET (Legacy)
       // ────────────────────────────────────────────────────────
       case "ping_set_wallet": {
@@ -1334,11 +1519,9 @@ ID: ${data.question?.id}`;
           return {
             content: [{
               type: "text",
-              text: JSON.stringify({
-                success: false,
-                error: "Not logged in.",
-                hint: "Use ping_login to connect your GitHub account."
-              }, null, 2)
+              text: `\u274C Not logged in
+
+Use ping_login to connect your GitHub account.`
             }]
           };
         }
@@ -1348,24 +1531,27 @@ ID: ${data.question?.id}`;
           return {
             content: [{
               type: "text",
-              text: JSON.stringify({
-                success: true,
-                questions: [],
-                message: "You haven't created any questions yet.",
-                hint: "Use ping_create_question to ask your first question and get answers from the community!"
-              }, null, 2)
+              text: `\u{1F4ED} No questions yet
+
+Use ping_create_question to ask your first question!`
             }]
           };
         }
+        let output = `\u{1F4CB} Your Questions (${data.questions.length} total)
+
+`;
+        data.questions.forEach((q, i) => {
+          const statusEmoji = q.status === "active" ? "\u{1F7E2}" : "\u26AA";
+          output += `${i + 1}. ${statusEmoji} "${q.text}"
+`;
+          output += `   Reward: ${q.reward} \xB7 Responses: ${q.responseCount}/${q.maxResponses} \xB7 ID: ${q.id}
+
+`;
+        });
         return {
           content: [{
             type: "text",
-            text: JSON.stringify({
-              success: true,
-              questions: data.questions,
-              total: data.total,
-              message: `Found ${data.questions.length} question${data.questions.length !== 1 ? "s" : ""}`
-            }, null, 2)
+            text: output.trim()
           }]
         };
       }
@@ -1378,11 +1564,9 @@ ID: ${data.question?.id}`;
           return {
             content: [{
               type: "text",
-              text: JSON.stringify({
-                success: false,
-                error: "Not logged in.",
-                hint: "Use ping_login to connect your GitHub account."
-              }, null, 2)
+              text: `\u274C Not logged in
+
+Use ping_login to connect your GitHub account.`
             }]
           };
         }
@@ -1391,11 +1575,9 @@ ID: ${data.question?.id}`;
           return {
             content: [{
               type: "text",
-              text: JSON.stringify({
-                success: false,
-                error: "Missing question ID.",
-                hint: "Use ping_my_questions to see your questions and their IDs."
-              }, null, 2)
+              text: `\u274C Missing question ID
+
+Use ping_my_questions to see your questions and their IDs.`
             }]
           };
         }
@@ -1404,27 +1586,27 @@ ID: ${data.question?.id}`;
           return {
             content: [{
               type: "text",
-              text: JSON.stringify({
-                success: true,
-                question: data.question,
-                responses: [],
-                total: 0,
-                message: "No responses yet.",
-                hint: "Answers usually start arriving within a few hours. Check back later!"
-              }, null, 2)
+              text: `\u{1F4ED} No responses yet for "${data.question.text}"
+
+Answers usually arrive within a few hours. Check back later!`
             }]
           };
         }
+        let output = `\u{1F4AC} Responses to "${data.question.text}" (${data.responses.length} total)
+
+`;
+        data.responses.forEach((r, i) => {
+          const statusEmoji = r.status === "approved" ? "\u2705" : r.status === "rejected" ? "\u274C" : "\u23F3";
+          output += `${i + 1}. ${statusEmoji} "${r.answerText.slice(0, 100)}${r.answerText.length > 100 ? "..." : ""}"
+`;
+          if (r.aiScore) output += `   Score: ${r.aiScore}/100
+`;
+          output += "\n";
+        });
         return {
           content: [{
             type: "text",
-            text: JSON.stringify({
-              success: true,
-              question: data.question,
-              responses: data.responses,
-              total: data.total,
-              message: `Found ${data.responses.length} response${data.responses.length !== 1 ? "s" : ""} to your question`
-            }, null, 2)
+            text: output.trim()
           }]
         };
       }
@@ -1437,11 +1619,9 @@ ID: ${data.question?.id}`;
           return {
             content: [{
               type: "text",
-              text: JSON.stringify({
-                success: false,
-                error: "Not logged in.",
-                hint: "Use ping_login to connect your GitHub account."
-              }, null, 2)
+              text: `\u274C Not logged in
+
+Use ping_login to connect your GitHub account.`
             }]
           };
         }
@@ -1450,11 +1630,9 @@ ID: ${data.question?.id}`;
           return {
             content: [{
               type: "text",
-              text: JSON.stringify({
-                success: false,
-                error: "Missing question ID.",
-                hint: "Use ping_my_questions to see your questions and their IDs."
-              }, null, 2)
+              text: `\u274C Missing question ID
+
+Use ping_my_questions to see your questions and their IDs.`
             }]
           };
         }
@@ -1462,32 +1640,20 @@ ID: ${data.question?.id}`;
           method: "POST"
         });
         if (!data.success) {
-          let errorMsg = data.error || "Failed to close question";
-          let hint = "Please try again.";
-          if (errorMsg.toLowerCase().includes("not found")) {
-            hint = "Check that the question ID is correct using ping_my_questions.";
-          } else if (errorMsg.toLowerCase().includes("already closed")) {
-            hint = "This question has already been closed.";
-          }
+          const errorMsg = data.error || "Failed to close question";
           return {
             content: [{
               type: "text",
-              text: JSON.stringify({
-                success: false,
-                error: errorMsg,
-                hint
-              }, null, 2)
+              text: `\u274C ${errorMsg}`
             }]
           };
         }
         return {
           content: [{
             type: "text",
-            text: JSON.stringify({
-              success: true,
-              refunded: data.refunded,
-              message: `Question closed. ${data.refunded} refunded to your balance.`
-            }, null, 2)
+            text: `\u2705 Question closed
+
+${data.refunded} refunded to your balance.`
           }]
         };
       }
@@ -1500,11 +1666,9 @@ ID: ${data.question?.id}`;
           return {
             content: [{
               type: "text",
-              text: JSON.stringify({
-                success: false,
-                error: "Not logged in.",
-                hint: "Use ping_login to connect your GitHub account before adding funds."
-              }, null, 2)
+              text: `\u274C Not logged in
+
+Use ping_login to connect your GitHub account first.`
             }]
           };
         }
@@ -1513,11 +1677,9 @@ ID: ${data.question?.id}`;
           return {
             content: [{
               type: "text",
-              text: JSON.stringify({
-                success: false,
-                error: "Deposit amount too small.",
-                hint: "Minimum deposit is $1.00 (100 cents). Example: 1000 = $10.00"
-              }, null, 2)
+              text: `\u274C Deposit amount too small
+
+Minimum deposit is $1.00 (100 cents). Example: 1000 = $10.00`
             }]
           };
         }
@@ -1529,24 +1691,18 @@ ID: ${data.question?.id}`;
           return {
             content: [{
               type: "text",
-              text: JSON.stringify({
-                success: false,
-                error: data.error || "Deposit failed.",
-                hint: "Please try again. If the problem persists, contact support."
-              }, null, 2)
+              text: `\u274C ${data.error || "Deposit failed"}`
             }]
           };
         }
         return {
           content: [{
             type: "text",
-            text: JSON.stringify({
-              success: true,
-              deposited: data.deposited,
-              newBalance: data.newBalance,
-              message: `Deposited ${data.deposited}! Your new balance is ${data.newBalance}.`,
-              nextStep: "You can now create questions with ping_create_question"
-            }, null, 2)
+            text: `\u2705 Deposited ${data.deposited}!
+
+New balance: ${data.newBalance}
+
+You can now create questions with ping_create_question`
           }]
         };
       }
@@ -1564,10 +1720,16 @@ ID: ${data.question?.id}`;
     }
   } catch (error) {
     const errorResponse = formatErrorResponse(error);
+    let errorText = `\u274C ${errorResponse.error}`;
+    if (errorResponse.hint) {
+      errorText += `
+
+\u{1F4A1} ${errorResponse.hint}`;
+    }
     return {
       content: [{
         type: "text",
-        text: JSON.stringify(errorResponse, null, 2)
+        text: errorText
       }],
       isError: true
     };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ping-mcp-server",
-  "version": "0.1.19",
+  "version": "0.1.22",
   "description": "MCP server that gives Claude Code the ability to interact with Ping",
   "type": "module",
   "bin": {

package/src/index.ts

@@ -134,6 +134,104 @@ function clearAuth(): void {
   saveConfig(config);
 }
 
+// ============================================================
+// CONTEXT STORAGE (for smart question suggestions)
+// ============================================================
+
+/**
+ * Context file stores what the user has been working on across sessions.
+ * This enables Ping to suggest relevant questions based on actual problems.
+ */
+const CONTEXT_FILE = path.join(CONFIG_DIR, 'context.json');
+
+interface PingContext {
+  // Problems/decisions the user is working through
+  problems: Array<{
+    summary: string;
+    category: 'decision' | 'debugging' | 'architecture' | 'tooling' | 'other';
+    tags: string[];
+    timestamp: string;
+  }>;
+  // Inferred tech stack from their projects
+  techStack: string[];
+  // Last updated timestamp
+  lastUpdated: string;
+}
+
+function loadContext(): PingContext {
+  try {
+    if (fs.existsSync(CONTEXT_FILE)) {
+      const data = fs.readFileSync(CONTEXT_FILE, 'utf-8');
+      return JSON.parse(data);
+    }
+  } catch (error) {
+    // Ignore errors, return empty context
+  }
+  return { problems: [], techStack: [], lastUpdated: new Date().toISOString() };
+}
+
+function saveContext(context: PingContext): void {
+  try {
+    if (!fs.existsSync(CONFIG_DIR)) {
+      fs.mkdirSync(CONFIG_DIR, { recursive: true });
+    }
+    context.lastUpdated = new Date().toISOString();
+    fs.writeFileSync(CONTEXT_FILE, JSON.stringify(context, null, 2));
+  } catch (error) {
+    console.error('Failed to save context:', error);
+  }
+}
+
+/**
+ * Generate question suggestions based on stored context.
+ * Focuses on taste/judgment questions that humans answer better than AI.
+ */
+function generateQuestionSuggestions(context: PingContext): string[] {
+  const suggestions: string[] = [];
+
+  // Question templates focused on taste/judgment (not technical how-to)
+  const templates = {
+    decision: [
+      'Choosing between {X} - what would you pick and why?',
+      'Is {X} worth the added complexity?',
+      'Anyone regret going with {X}? What would you do differently?',
+    ],
+    debugging: [
+      'Seeing weird behavior with {X} - anyone dealt with this?',
+      'What\'s the gotcha everyone hits with {X}?',
+    ],
+    architecture: [
+      'What\'s the production-ready way to handle {X}?',
+      'Is {X} overkill for a small team?',
+      'How do you think about {X} vs just keeping it simple?',
+    ],
+    tooling: [
+      'What\'s the vibe on {X} in 2025? Worth adopting?',
+      'Anyone actually using {X} in production? How\'s it going?',
+      'What do people actually use for {X}? (not what\'s popular on Twitter)',
+    ],
+    other: [
+      'What\'s your take on {X}?',
+      'How do you think about {X}?',
+    ],
+  };
+
+  // Generate suggestions from recent problems
+  for (const problem of context.problems.slice(0, 3)) {
+    const categoryTemplates = templates[problem.category] || templates.other;
+    const template = categoryTemplates[Math.floor(Math.random() * categoryTemplates.length)];
+    suggestions.push(template.replace('{X}', problem.summary));
+  }
+
+  // Add tech stack based suggestions if we have them
+  if (context.techStack.length > 0) {
+    const tech = context.techStack[0];
+    suggestions.push(`What's something you wish you knew before using ${tech}?`);
+  }
+
+  return suggestions;
+}
+
 // ============================================================
 // SUGGESTED ANSWER GENERATION
 // ============================================================
@@ -798,6 +896,51 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
         },
       },
       // ────────────────────────────────────────────────────────
+      // CONTEXT TOOLS (for smart question suggestions)
+      // ────────────────────────────────────────────────────────
+      {
+        name: 'ping_log_context',
+        description:
+          'Log what the user is working on for smarter question suggestions. ' +
+          'Call this when you notice the user is: making a decision between options, ' +
+          'debugging something tricky, discussing architecture, or evaluating tools. ' +
+          'This helps Ping suggest relevant questions later.',
+        inputSchema: {
+          type: 'object',
+          properties: {
+            summary: {
+              type: 'string',
+              description: 'Brief summary of the problem/decision (e.g., "choosing between Prisma and Drizzle")',
+            },
+            category: {
+              type: 'string',
+              enum: ['decision', 'debugging', 'architecture', 'tooling', 'other'],
+              description: 'Type of problem',
+            },
+            tags: {
+              type: 'array',
+              items: { type: 'string' },
+              description: 'Related technologies or concepts (e.g., ["orm", "database", "typescript"])',
+            },
+          },
+          required: ['summary', 'category'],
+        },
+      },
+      {
+        name: 'ping_suggest_questions',
+        description:
+          'Get question suggestions based on what the user has been working on. ' +
+          'Call this when: (1) user wants to create a question but doesn\'t know what to ask, ' +
+          '(2) you notice something that would benefit from human expertise/taste rather than AI knowledge, ' +
+          '(3) proactively when the user has been wrestling with a decision. ' +
+          'Returns taste/judgment questions that humans answer better than AI.',
+        inputSchema: {
+          type: 'object',
+          properties: {},
+          required: [],
+        },
+      },
+      // ────────────────────────────────────────────────────────
       // LEGACY: SET WALLET (for users without GitHub auth)
       // ────────────────────────────────────────────────────────
       {
@@ -1188,7 +1331,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
       // ────────────────────────────────────────────────────────
       case 'ping_welcome': {
         const auth = getAuth();
-        const MCP_VERSION = '0.1.19';
+        const MCP_VERSION = '0.1.21';
 
         // Get user handle and connections
         let userLine = '❌ Not logged in';
@@ -1210,18 +1353,30 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
           }
         }
 
-        // Get stats (with fallback defaults)
+        // Get USER-SPECIFIC available questions (not platform-wide)
         let questionsAvailable = 0;
         let answersToday = 0;
         let claimedToday = '$0.00';
 
+        // First get questions available FOR THIS USER
+        if (auth) {
+          try {
+            const questionsData = await apiRequest<{
+              questions: Array<{ id: string }>;
+              totalAvailable: number;
+            }>('/questions?limit=1');
+            questionsAvailable = questionsData.totalAvailable;
+          } catch {
+            // Fall back to 0
+          }
+        }
+
+        // Then get platform stats for answers/claimed (these are user-specific)
         try {
           const stats = await apiRequest<{
-            questions: { active: number };
             responses: { today: number };
             rewards: { claimedToday: string };
           }>('/stats');
-          questionsAvailable = stats.questions.active;
           answersToday = stats.responses.today;
           claimedToday = stats.rewards.claimedToday;
         } catch {
@@ -1296,6 +1451,97 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
         };
       }
 
+      // ────────────────────────────────────────────────────────
+      // LOG CONTEXT (for smart question suggestions)
+      // ────────────────────────────────────────────────────────
+      case 'ping_log_context': {
+        const { summary, category, tags = [] } = (args || {}) as {
+          summary: string;
+          category: 'decision' | 'debugging' | 'architecture' | 'tooling' | 'other';
+          tags?: string[];
+        };
+
+        if (!summary || !category) {
+          return {
+            content: [{
+              type: 'text',
+              text: '❌ Missing required fields: summary and category',
+            }],
+          };
+        }
+
+        // Load existing context
+        const context = loadContext();
+
+        // Add new problem (keep last 10)
+        context.problems.unshift({
+          summary,
+          category,
+          tags,
+          timestamp: new Date().toISOString(),
+        });
+        context.problems = context.problems.slice(0, 10);
+
+        // Update tech stack from tags
+        for (const tag of tags) {
+          if (!context.techStack.includes(tag)) {
+            context.techStack.unshift(tag);
+          }
+        }
+        context.techStack = context.techStack.slice(0, 10);
+
+        // Save
+        saveContext(context);
+
+        return {
+          content: [{
+            type: 'text',
+            text: `📝 Logged: "${summary}" (${category})\n\nThis will help suggest relevant questions later.`,
+          }],
+        };
+      }
+
+      // ────────────────────────────────────────────────────────
+      // SUGGEST QUESTIONS (based on stored context)
+      // ────────────────────────────────────────────────────────
+      case 'ping_suggest_questions': {
+        const context = loadContext();
+
+        // If no context yet, return generic suggestions
+        if (context.problems.length === 0 && context.techStack.length === 0) {
+          return {
+            content: [{
+              type: 'text',
+              text: `💡 No context stored yet!\n\nAs you work, I'll learn what you're dealing with and suggest relevant questions.\n\n**Generic taste/judgment questions:**\n• "What's something you wish you knew earlier in your career?"\n• "What tool do you use that most people don't know about?"\n• "What's overrated in tech right now?"`,
+            }],
+          };
+        }
+
+        // Generate suggestions
+        const suggestions = generateQuestionSuggestions(context);
+
+        // Format output
+        let output = `💡 **Question suggestions based on your recent work:**\n\n`;
+        suggestions.forEach((q, i) => {
+          output += `${i + 1}. "${q}"\n`;
+        });
+
+        output += `\n**Your recent context:**\n`;
+        output += `• Problems: ${context.problems.slice(0, 3).map(p => p.summary).join(', ')}\n`;
+        if (context.techStack.length > 0) {
+          output += `• Tech: ${context.techStack.slice(0, 5).join(', ')}\n`;
+        }
+
+        output += `\n_Pick one to ask, edit it, or write your own!_`;
+
+        return {
+          content: [{
+            type: 'text',
+            text: output,
+          }],
+        };
+      }
+
       // ────────────────────────────────────────────────────────
       // SET WALLET (Legacy)
       // ────────────────────────────────────────────────────────
@@ -1924,11 +2170,7 @@ Wallet: ${data.walletAddress}`,
           return {
             content: [{
               type: 'text',
-              text: JSON.stringify({
-                success: false,
-                error: 'Not logged in.',
-                hint: 'Use ping_login to connect your GitHub account.',
-              }, null, 2),
+              text: `❌ Not logged in\n\nUse ping_login to connect your GitHub account.`,
             }],
           };
         }
@@ -1939,11 +2181,7 @@ Wallet: ${data.walletAddress}`,
           return {
             content: [{
               type: 'text',
-              text: JSON.stringify({
-                success: false,
-                error: 'Missing question ID.',
-                hint: 'Use ping_my_questions to see your questions and their IDs.',
-              }, null, 2),
+              text: `❌ Missing question ID\n\nUse ping_my_questions to see your questions and their IDs.`,
             }],
           };
         }
@@ -1969,28 +2207,24 @@ Wallet: ${data.walletAddress}`,
           return {
             content: [{
               type: 'text',
-              text: JSON.stringify({
-                success: true,
-                question: data.question,
-                responses: [],
-                total: 0,
-                message: 'No responses yet.',
-                hint: 'Answers usually start arriving within a few hours. Check back later!',
-              }, null, 2),
+              text: `📭 No responses yet for "${data.question.text}"\n\nAnswers usually arrive within a few hours. Check back later!`,
             }],
           };
         }
 
+        // Build human-readable response list
+        let output = `💬 Responses to "${data.question.text}" (${data.responses.length} total)\n\n`;
+        data.responses.forEach((r, i) => {
+          const statusEmoji = r.status === 'approved' ? '✅' : r.status === 'rejected' ? '❌' : '⏳';
+          output += `${i + 1}. ${statusEmoji} "${r.answerText.slice(0, 100)}${r.answerText.length > 100 ? '...' : ''}"\n`;
+          if (r.aiScore) output += `   Score: ${r.aiScore}/100\n`;
+          output += '\n';
+        });
+
         return {
           content: [{
             type: 'text',
-            text: JSON.stringify({
-              success: true,
-              question: data.question,
-              responses: data.responses,
-              total: data.total,
-              message: `Found ${data.responses.length} response${data.responses.length !== 1 ? 's' : ''} to your question`,
-            }, null, 2),
+            text: output.trim(),
           }],
         };
       }
@@ -2005,11 +2239,7 @@ Wallet: ${data.walletAddress}`,
           return {
             content: [{
               type: 'text',
-              text: JSON.stringify({
-                success: false,
-                error: 'Not logged in.',
-                hint: 'Use ping_login to connect your GitHub account.',
-              }, null, 2),
+              text: `❌ Not logged in\n\nUse ping_login to connect your GitHub account.`,
             }],
           };
         }
@@ -2020,11 +2250,7 @@ Wallet: ${data.walletAddress}`,
           return {
             content: [{
               type: 'text',
-              text: JSON.stringify({
-                success: false,
-                error: 'Missing question ID.',
-                hint: 'Use ping_my_questions to see your questions and their IDs.',
-              }, null, 2),
+              text: `❌ Missing question ID\n\nUse ping_my_questions to see your questions and their IDs.`,
             }],
           };
         }
@@ -2038,23 +2264,11 @@ Wallet: ${data.walletAddress}`,
         });
 
         if (!data.success) {
-          let errorMsg = data.error || 'Failed to close question';
-          let hint = 'Please try again.';
-
-          if (errorMsg.toLowerCase().includes('not found')) {
-            hint = 'Check that the question ID is correct using ping_my_questions.';
-          } else if (errorMsg.toLowerCase().includes('already closed')) {
-            hint = 'This question has already been closed.';
-          }
-
+          const errorMsg = data.error || 'Failed to close question';
           return {
             content: [{
               type: 'text',
-              text: JSON.stringify({
-                success: false,
-                error: errorMsg,
-                hint,
-              }, null, 2),
+              text: `❌ ${errorMsg}`,
             }],
           };
         }
@@ -2062,11 +2276,7 @@ Wallet: ${data.walletAddress}`,
         return {
           content: [{
             type: 'text',
-            text: JSON.stringify({
-              success: true,
-              refunded: data.refunded,
-              message: `Question closed. ${data.refunded} refunded to your balance.`,
-            }, null, 2),
+            text: `✅ Question closed\n\n${data.refunded} refunded to your balance.`,
           }],
         };
       }
@@ -2081,11 +2291,7 @@ Wallet: ${data.walletAddress}`,
           return {
             content: [{
               type: 'text',
-              text: JSON.stringify({
-                success: false,
-                error: 'Not logged in.',
-                hint: 'Use ping_login to connect your GitHub account before adding funds.',
-              }, null, 2),
+              text: `❌ Not logged in\n\nUse ping_login to connect your GitHub account first.`,
             }],
           };
         }
@@ -2096,11 +2302,7 @@ Wallet: ${data.walletAddress}`,
           return {
             content: [{
               type: 'text',
-              text: JSON.stringify({
-                success: false,
-                error: 'Deposit amount too small.',
-                hint: 'Minimum deposit is $1.00 (100 cents). Example: 1000 = $10.00',
-              }, null, 2),
+              text: `❌ Deposit amount too small\n\nMinimum deposit is $1.00 (100 cents). Example: 1000 = $10.00`,
             }],
           };
         }
@@ -2119,11 +2321,7 @@ Wallet: ${data.walletAddress}`,
           return {
             content: [{
               type: 'text',
-              text: JSON.stringify({
-                success: false,
-                error: data.error || 'Deposit failed.',
-                hint: 'Please try again. If the problem persists, contact support.',
-              }, null, 2),
+              text: `❌ ${data.error || 'Deposit failed'}`,
             }],
           };
         }
@@ -2131,13 +2329,7 @@ Wallet: ${data.walletAddress}`,
         return {
           content: [{
             type: 'text',
-            text: JSON.stringify({
-              success: true,
-              deposited: data.deposited,
-              newBalance: data.newBalance,
-              message: `Deposited ${data.deposited}! Your new balance is ${data.newBalance}.`,
-              nextStep: 'You can now create questions with ping_create_question',
-            }, null, 2),
+            text: `✅ Deposited ${data.deposited}!\n\nNew balance: ${data.newBalance}\n\nYou can now create questions with ping_create_question`,
           }],
         };
       }
@@ -2155,12 +2347,16 @@ Wallet: ${data.walletAddress}`,
         };
     }
   } catch (error) {
-    // Use the formatErrorResponse helper for consistent error formatting
+    // Human-readable error messages
     const errorResponse = formatErrorResponse(error);
+    let errorText = `❌ ${errorResponse.error}`;
+    if (errorResponse.hint) {
+      errorText += `\n\n💡 ${errorResponse.hint}`;
+    }
     return {
       content: [{
         type: 'text',
-        text: JSON.stringify(errorResponse, null, 2),
+        text: errorText,
       }],
       isError: true,
     };