ping-mcp-server 0.1.8 → 0.1.10

package/dist/index.js

@@ -515,7 +515,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
       },
       {
         name: "ping_submit_answer",
-        description: "Submit an answer to a Ping question and earn the reward. Use when the user provides their answer to one of the available questions. Set preApproved=true when the user selects a suggested answer (skips AI review for instant approval). Requires GitHub login (ping_login) or wallet address.",
+        description: "Submit a SINGLE answer. DEPRECATED: Use ping_submit_batch instead for better UX. Only use this if you need to submit exactly one answer.",
         inputSchema: {
           type: "object",
           properties: {
@@ -535,9 +535,32 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
           required: ["questionId", "answer"]
         }
       },
+      {
+        name: "ping_submit_batch",
+        description: "Submit multiple answers at once. ALWAYS use this instead of ping_submit_answer. Returns a fun receipt-style summary. Much cleaner UX than individual submissions.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            answers: {
+              type: "array",
+              items: {
+                type: "object",
+                properties: {
+                  questionId: { type: "string" },
+                  answer: { type: "string" },
+                  preApproved: { type: "boolean" }
+                },
+                required: ["questionId", "answer"]
+              },
+              description: "Array of answers to submit"
+            }
+          },
+          required: ["answers"]
+        }
+      },
       {
         name: "ping_answer_flow",
-        description: 'Start an interactive Q&A session to earn money answering Ping questions. TRIGGERS: "ping", "/ping", "answer questions", "earn money", "make money with ping", "start earning". Returns questions with suggested answers. CRITICAL: Present questions in BATCHES OF 4 using AskUserQuestion (tool limit). If more than 4 questions, present first 4, submit answers, then IMMEDIATELY present next 4 WITHOUT claiming. Continue batching until all questions are answered. Submit answers IN PARALLEL for each batch. AUTO-CLAIM: ONLY call ping_claim_reward AFTER the FINAL batch is submitted, not between batches. Requires GitHub login first (ping_login).',
+        description: 'Start an interactive Q&A session to earn money answering Ping questions. TRIGGERS: "ping", "/ping", "answer questions", "earn money", "make money with ping", "start earning". Returns questions with suggested answers. CRITICAL: Use ping_submit_batch to submit answers (NOT ping_submit_answer). Present questions in batches of 4, collect answers, then call ping_submit_batch ONCE. AUTO-CLAIM: Call ping_claim_reward AFTER all batches submitted. Requires GitHub login first (ping_login).',
         inputSchema: {
           type: "object",
           properties: {
@@ -573,6 +596,15 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
           required: []
         }
       },
+      {
+        name: "ping_stats",
+        description: "Get platform statistics for social proof - total answers today, rewards claimed, etc. Use this when showing the Ping welcome banner or dashboard.",
+        inputSchema: {
+          type: "object",
+          properties: {},
+          required: []
+        }
+      },
       // ────────────────────────────────────────────────────────
       // QUESTIONER TOOLS (Phase 1)
       // ────────────────────────────────────────────────────────
@@ -1012,6 +1044,58 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
         };
       }
       // ────────────────────────────────────────────────────────
+      // BATCH SUBMIT (Submit multiple answers at once)
+      // ────────────────────────────────────────────────────────
+      case "ping_submit_batch": {
+        const auth = getAuth();
+        if (!auth) {
+          return {
+            content: [{
+              type: "text",
+              text: JSON.stringify({
+                success: false,
+                error: "Not logged in.",
+                hint: "Use ping_login to connect your GitHub account first."
+              }, null, 2)
+            }]
+          };
+        }
+        const { answers } = args || {};
+        if (!answers || answers.length === 0) {
+          return {
+            content: [{
+              type: "text",
+              text: JSON.stringify({
+                success: false,
+                error: "No answers provided.",
+                hint: "Provide an array of answers with questionId and answer fields."
+              }, null, 2)
+            }]
+          };
+        }
+        const data = await apiRequest("/answers/batch", {
+          method: "POST",
+          body: JSON.stringify({ answers })
+        });
+        const { summary } = data;
+        const checkmark = summary.approved > 0 ? "\u2705" : "\u2B1C";
+        const statusLine = summary.errors > 0 ? `${summary.approved}/${summary.submitted} approved, ${summary.errors} error(s)` : `${summary.approved}/${summary.submitted} approved`;
+        const receipt = `
+\u250C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2510
+\u2502  \u{1F9FE} PING RECEIPT            \u2502
+\u251C\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2524
+\u2502  ${checkmark} ${statusLine.padEnd(24)}\u2502
+\u2502  \u{1F4B0} ${summary.totalEarned.padEnd(24)}\u2502
+\u2502  \u{1F4CA} Balance: ${summary.pendingBalance.padEnd(14)}\u2502
+\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2518`;
+        return {
+          content: [{
+            type: "text",
+            text: receipt.trim() + "\n\n" + (summary.approved > 0 ? "\u{1F389} Nice work! Your earnings are ready to claim." : "Keep trying - quality answers get approved!")
+          }]
+        };
+      }
+      // ────────────────────────────────────────────────────────
       // ANSWER FLOW (Interactive Q&A Session)
       // ────────────────────────────────────────────────────────
       case "ping_answer_flow": {
@@ -1079,8 +1163,8 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                   step4_skip: "If 0 questions available in this batch, skip to next 4 question IDs and validate again.",
                   step5_present: "Present available questions using AskUserQuestion (1-4 questions). Format: question text with reward in header, options are ONLY suggested answers.",
                   step6_collect: "User answers the questions.",
-                  step7_submit: "Submit answers IN PARALLEL using multiple ping_submit_answer calls. preApproved=true for suggested answers, preApproved=false for custom.",
-                  step8_handleErrors: 'If some submissions fail with "question_exhausted" error, log them but continue.',
+                  step7_submit: "Submit ALL answers at once using ping_submit_batch. Pass array of {questionId, answer, preApproved}. preApproved=true for suggested answers, preApproved=false for custom. This returns a clean receipt summary.",
+                  step8_showReceipt: "Display the receipt returned by ping_submit_batch. It shows approved count, earnings, and balance.",
                   step9_repeat: "If more questions remain in the original questions array, repeat from step1_selectNext. Otherwise, proceed to finalClaim."
                 },
                 finalClaim: "AFTER ALL batches complete (no more questions left to validate), call ping_claim_reward ONCE automatically.",
@@ -1213,6 +1297,25 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
         };
       }
       // ────────────────────────────────────────────────────────
+      // PLATFORM STATS (for welcome banner)
+      // ────────────────────────────────────────────────────────
+      case "ping_stats": {
+        const data = await apiRequest("/stats");
+        return {
+          content: [{
+            type: "text",
+            text: JSON.stringify({
+              success: true,
+              stats: {
+                questionsAvailable: data.questions.active,
+                answersToday: data.responses.today,
+                rewardsClaimedToday: data.rewards.claimedToday
+              }
+            }, null, 2)
+          }]
+        };
+      }
+      // ────────────────────────────────────────────────────────
       // CREATE QUESTION (Questioner)
       // ────────────────────────────────────────────────────────
       case "ping_create_question": {

package/package.json

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

package/src/index.ts

@@ -813,10 +813,8 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
       {
         name: 'ping_submit_answer',
         description:
-          'Submit an answer to a Ping question and earn the reward. ' +
-          'Use when the user provides their answer to one of the available questions. ' +
-          'Set preApproved=true when the user selects a suggested answer (skips AI review for instant approval). ' +
-          'Requires GitHub login (ping_login) or wallet address.',
+          'Submit a SINGLE answer. DEPRECATED: Use ping_submit_batch instead for better UX. ' +
+          'Only use this if you need to submit exactly one answer.',
         inputSchema: {
           type: 'object',
           properties: {
@@ -836,17 +834,40 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
           required: ['questionId', 'answer'],
         },
       },
+      {
+        name: 'ping_submit_batch',
+        description:
+          'Submit multiple answers at once. ALWAYS use this instead of ping_submit_answer. ' +
+          'Returns a fun receipt-style summary. Much cleaner UX than individual submissions.',
+        inputSchema: {
+          type: 'object',
+          properties: {
+            answers: {
+              type: 'array',
+              items: {
+                type: 'object',
+                properties: {
+                  questionId: { type: 'string' },
+                  answer: { type: 'string' },
+                  preApproved: { type: 'boolean' },
+                },
+                required: ['questionId', 'answer'],
+              },
+              description: 'Array of answers to submit',
+            },
+          },
+          required: ['answers'],
+        },
+      },
       {
         name: 'ping_answer_flow',
         description:
           'Start an interactive Q&A session to earn money answering Ping questions. ' +
           'TRIGGERS: "ping", "/ping", "answer questions", "earn money", "make money with ping", "start earning". ' +
           'Returns questions with suggested answers. ' +
-          'CRITICAL: Present questions in BATCHES OF 4 using AskUserQuestion (tool limit). ' +
-          'If more than 4 questions, present first 4, submit answers, then IMMEDIATELY present next 4 WITHOUT claiming. ' +
-          'Continue batching until all questions are answered. ' +
-          'Submit answers IN PARALLEL for each batch. ' +
-          'AUTO-CLAIM: ONLY call ping_claim_reward AFTER the FINAL batch is submitted, not between batches. ' +
+          'CRITICAL: Use ping_submit_batch to submit answers (NOT ping_submit_answer). ' +
+          'Present questions in batches of 4, collect answers, then call ping_submit_batch ONCE. ' +
+          'AUTO-CLAIM: Call ping_claim_reward AFTER all batches submitted. ' +
           'Requires GitHub login first (ping_login).',
         inputSchema: {
           type: 'object',
@@ -892,6 +913,17 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
           required: [],
         },
       },
+      {
+        name: 'ping_stats',
+        description:
+          'Get platform statistics for social proof - total answers today, rewards claimed, etc. ' +
+          'Use this when showing the Ping welcome banner or dashboard.',
+        inputSchema: {
+          type: 'object',
+          properties: {},
+          required: [],
+        },
+      },
       // ────────────────────────────────────────────────────────
       // QUESTIONER TOOLS (Phase 1)
       // ────────────────────────────────────────────────────────
@@ -1445,6 +1477,95 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
         };
       }
 
+      // ────────────────────────────────────────────────────────
+      // BATCH SUBMIT (Submit multiple answers at once)
+      // ────────────────────────────────────────────────────────
+      case 'ping_submit_batch': {
+        const auth = getAuth();
+
+        if (!auth) {
+          return {
+            content: [{
+              type: 'text',
+              text: JSON.stringify({
+                success: false,
+                error: 'Not logged in.',
+                hint: 'Use ping_login to connect your GitHub account first.',
+              }, null, 2),
+            }],
+          };
+        }
+
+        const { answers } = (args || {}) as {
+          answers: Array<{
+            questionId: string;
+            answer: string;
+            preApproved?: boolean;
+          }>;
+        };
+
+        if (!answers || answers.length === 0) {
+          return {
+            content: [{
+              type: 'text',
+              text: JSON.stringify({
+                success: false,
+                error: 'No answers provided.',
+                hint: 'Provide an array of answers with questionId and answer fields.',
+              }, null, 2),
+            }],
+          };
+        }
+
+        // Call the batch endpoint
+        const data = await apiRequest<{
+          success: boolean;
+          summary: {
+            submitted: number;
+            approved: number;
+            rejected: number;
+            errors: number;
+            totalEarned: string;
+            totalEarnedCents: number;
+            pendingBalance: string;
+          };
+          results: Array<{
+            questionId: string;
+            status: string;
+            earned?: string;
+            error?: string;
+          }>;
+        }>('/answers/batch', {
+          method: 'POST',
+          body: JSON.stringify({ answers }),
+        });
+
+        // Build a fun receipt-style ASCII art response
+        const { summary } = data;
+        const checkmark = summary.approved > 0 ? '✅' : '⬜';
+        const statusLine = summary.errors > 0
+          ? `${summary.approved}/${summary.submitted} approved, ${summary.errors} error(s)`
+          : `${summary.approved}/${summary.submitted} approved`;
+
+        const receipt = `
+┌─────────────────────────────┐
+│  🧾 PING RECEIPT            │
+├─────────────────────────────┤
+│  ${checkmark} ${statusLine.padEnd(24)}│
+│  💰 ${summary.totalEarned.padEnd(24)}│
+│  📊 Balance: ${summary.pendingBalance.padEnd(14)}│
+└─────────────────────────────┘`;
+
+        return {
+          content: [{
+            type: 'text',
+            text: receipt.trim() + '\n\n' + (summary.approved > 0
+              ? '🎉 Nice work! Your earnings are ready to claim.'
+              : 'Keep trying - quality answers get approved!'),
+          }],
+        };
+      }
+
       // ────────────────────────────────────────────────────────
       // ANSWER FLOW (Interactive Q&A Session)
       // ────────────────────────────────────────────────────────
@@ -1535,8 +1656,8 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                   step4_skip: 'If 0 questions available in this batch, skip to next 4 question IDs and validate again.',
                   step5_present: 'Present available questions using AskUserQuestion (1-4 questions). Format: question text with reward in header, options are ONLY suggested answers.',
                   step6_collect: 'User answers the questions.',
-                  step7_submit: 'Submit answers IN PARALLEL using multiple ping_submit_answer calls. preApproved=true for suggested answers, preApproved=false for custom.',
-                  step8_handleErrors: 'If some submissions fail with "question_exhausted" error, log them but continue.',
+                  step7_submit: 'Submit ALL answers at once using ping_submit_batch. Pass array of {questionId, answer, preApproved}. preApproved=true for suggested answers, preApproved=false for custom. This returns a clean receipt summary.',
+                  step8_showReceipt: 'Display the receipt returned by ping_submit_batch. It shows approved count, earnings, and balance.',
                   step9_repeat: 'If more questions remain in the original questions array, repeat from step1_selectNext. Otherwise, proceed to finalClaim.',
                 },
                 finalClaim: 'AFTER ALL batches complete (no more questions left to validate), call ping_claim_reward ONCE automatically.',
@@ -1709,6 +1830,31 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
         };
       }
 
+      // ────────────────────────────────────────────────────────
+      // PLATFORM STATS (for welcome banner)
+      // ────────────────────────────────────────────────────────
+      case 'ping_stats': {
+        const data = await apiRequest<{
+          questions: { total: number; active: number };
+          responses: { total: number; today: number };
+          rewards: { claimedToday: string; claimedTodayCents: number };
+        }>('/stats');
+
+        return {
+          content: [{
+            type: 'text',
+            text: JSON.stringify({
+              success: true,
+              stats: {
+                questionsAvailable: data.questions.active,
+                answersToday: data.responses.today,
+                rewardsClaimedToday: data.rewards.claimedToday,
+              },
+            }, null, 2),
+          }],
+        };
+      }
+
       // ────────────────────────────────────────────────────────
       // CREATE QUESTION (Questioner)
       // ────────────────────────────────────────────────────────