ping-mcp-server 0.1.5 → 0.1.6

package/dist/index.js

@@ -423,8 +423,8 @@ async function apiRequest(path2, options = {}) {
       if (fetchError.message.includes("fetch failed") || fetchError.message.includes("ECONNREFUSED") || fetchError.message.includes("ENOTFOUND") || fetchError.message.includes("ETIMEDOUT") || fetchError.cause) {
         throw new PingError(
           "NETWORK_ERROR" /* NETWORK_ERROR */,
-          "Cannot connect to Ping API. Check your internet connection.",
-          "Make sure you have an active internet connection and try again."
+          `Cannot connect to Ping API at ${API_BASE_URL}. Check your internet connection.`,
+          `Make sure you can reach ${API_BASE_URL} and try again.`
         );
       }
     }
@@ -459,7 +459,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
       // ────────────────────────────────────────────────────────
       {
         name: "ping_login",
-        description: 'Login to Ping with GitHub. Opens a browser window for GitHub OAuth authentication. TRIGGERS: "ping login", "login to ping", "connect to ping", "sign in to ping", "start using ping". Use when the user wants to login, sign in, connect their account, or start using Ping. After login, a wallet will be automatically created for the user.',
+        description: 'Login to Ping with GitHub. Opens a browser window for GitHub OAuth authentication. TRIGGERS: "ping login", "login to ping", "connect to ping", "sign in to ping", "start using ping". Use when the user wants to login, sign in, connect their account, or start using Ping. After login, a wallet will be automatically created for the user. API: https://api.ping-money.com',
         inputSchema: {
           type: "object",
           properties: {},
@@ -477,7 +477,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
       },
       {
         name: "ping_whoami",
-        description: "Show your Ping account info - GitHub handle, wallet address, and balance. Use when the user asks who they are logged in as, their account status, or profile info.",
+        description: "Show your Ping account info - GitHub handle, wallet address, and balance. Use when the user asks who they are logged in as, their account status, or profile info. API: https://api.ping-money.com",
         inputSchema: {
           type: "object",
           properties: {},
@@ -513,20 +513,6 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
           required: []
         }
       },
-      {
-        name: "ping_list_questions",
-        description: "Show questions available to answer and earn money on Ping. Use when the user wants to see earning opportunities, available questions, or ways to make money. Returns questions with their rewards.",
-        inputSchema: {
-          type: "object",
-          properties: {
-            limit: {
-              type: "number",
-              description: "Number of questions to show (default: 5)"
-            }
-          },
-          required: []
-        }
-      },
       {
         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.",
@@ -551,18 +537,33 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
       },
       {
         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 ALL questions in a SINGLE AskUserQuestion call (batched) to reduce latency. Use the questions array parameter with multiple question objects. After user answers, submit ALL answers IN PARALLEL for speed. AUTO-CLAIM: After all submissions complete, AUTOMATICALLY call ping_claim_reward to send earnings to wallet. 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: 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).',
         inputSchema: {
           type: "object",
           properties: {
             limit: {
               type: "number",
-              description: "Number of questions to include in the session (default: 5)"
+              description: "Number of questions to include in the session (default: 50)"
             }
           },
           required: []
         }
       },
+      {
+        name: "ping_validate_batch",
+        description: "Validate if a batch of questions is still available to answer before showing to user. Checks if questions are active, not exhausted (maxResponses reached), and not already answered. Returns available questions with full data + list of exhausted question IDs. Use this before presenting questions to ensure they can actually be answered.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            questionIds: {
+              type: "array",
+              items: { type: "string" },
+              description: 'Array of question IDs to validate (e.g., ["q1", "q2", "q3", "q4"])'
+            }
+          },
+          required: ["questionIds"]
+        }
+      },
       {
         name: "ping_claim_reward",
         description: 'Claim pending Ping earnings and send them to your crypto wallet on Base. TRIGGERS: "claim my ping", "withdraw from ping", "cash out", "get my money", "claim rewards". Use when the user wants to withdraw, cash out, or claim their rewards. Transfers USDC to their wallet instantly. Works with GitHub login (ping_login) or legacy wallet (ping_set_wallet).',
@@ -897,43 +898,6 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
         };
       }
       // ────────────────────────────────────────────────────────
-      // LIST QUESTIONS
-      // ────────────────────────────────────────────────────────
-      case "ping_list_questions": {
-        const { limit = 5 } = args || {};
-        const data = await apiRequest(`/questions?limit=${limit}`);
-        if (data.questions.length === 0) {
-          return {
-            content: [{
-              type: "text",
-              text: JSON.stringify({
-                success: true,
-                questions: [],
-                message: "No questions available right now.",
-                hint: "New questions are added regularly. Check back soon, or use ping_create_question to ask your own!"
-              }, null, 2)
-            }]
-          };
-        }
-        return {
-          content: [{
-            type: "text",
-            text: JSON.stringify({
-              success: true,
-              questions: data.questions.map((q) => ({
-                id: q.id,
-                question: q.text,
-                reward: q.reward,
-                category: q.category,
-                asker: q.asker
-              })),
-              totalAvailable: data.total,
-              message: `Found ${data.questions.length} question${data.questions.length !== 1 ? "s" : ""} you can answer!`
-            }, null, 2)
-          }]
-        };
-      }
-      // ────────────────────────────────────────────────────────
       // SUBMIT ANSWER
       // ────────────────────────────────────────────────────────
       case "ping_submit_answer": {
@@ -945,7 +909,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
               text: JSON.stringify({
                 success: false,
                 error: "Missing question ID.",
-                hint: "Use ping_list_questions to see available questions with their IDs."
+                hint: "Use ping_answer_flow to see available questions and answer them."
               }, null, 2)
             }]
           };
@@ -1003,6 +967,19 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
               }]
             };
           }
+          if (data.error === "question_exhausted") {
+            return {
+              content: [{
+                type: "text",
+                text: JSON.stringify({
+                  success: false,
+                  error: "question_exhausted",
+                  message: data.message || "This question is no longer accepting answers (maxResponses reached).",
+                  hint: "Skip this question and continue with others in your batch."
+                })
+              }]
+            };
+          }
           return {
             content: [{
               type: "text",
@@ -1051,7 +1028,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
             }]
           };
         }
-        const { limit = 5 } = args || {};
+        const { limit = 50 } = args || {};
         const data = await apiRequest(`/questions?limit=${limit}`);
         if (data.questions.length === 0) {
           return {
@@ -1093,23 +1070,86 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
               // Full question data (present AFTER user confirms)
               questions: questionsWithSuggestions,
               instructions: {
-                step1_summary: 'FIRST show ONLY the oneLiner from summary, then ask "Ready to start?" Do NOT reveal questions yet.',
-                step2_questions: "AFTER user confirms, BATCH ALL QUESTIONS in a SINGLE AskUserQuestion call (max 4 per call due to tool limit).",
-                format: 'Each question: question text with reward in header, options are ONLY the suggested answers (no Skip option - user can skip via "Other"). multiSelect: false.',
-                suggestedAnswerSubmission: "When user selects a suggested answer, call ping_submit_answer with preApproved=true for instant approval.",
-                customAnswerSubmission: 'When user types custom text via "Other", call ping_submit_answer with preApproved=false (AI review).',
-                parallelSubmission: "After collecting all answers, submit them IN PARALLEL using multiple ping_submit_answer calls in one message for speed.",
-                skipBehavior: 'If user selects "Other" and leaves blank or says skip, do not submit an answer for that question.',
-                errorHandling: "If some answer submissions fail, still proceed with auto-claim for the successful ones. Report which answers failed and why.",
-                autoClaim: "IMPORTANT: After ALL answer submissions complete (even if some failed), IMMEDIATELY call ping_claim_reward to send earnings to wallet. Do NOT ask - just claim automatically.",
-                claimRetry: "If ping_claim_reward fails, wait 2 seconds and retry ONCE. If it fails again, tell user earnings are saved and they can claim later.",
-                completionMessage: "After claim completes, show: total earned, transaction hash, and basescan link."
+                overview: "This is a continuous batch validation workflow. Fetch 50 questions upfront, then validate+present in batches of 4 until all questions are exhausted.",
+                step1_summary: 'FIRST show ONLY the oneLiner from summary with ~estimates, then ask "Ready to start?" Do NOT reveal questions yet.',
+                step2_startBatching: "AFTER user confirms, START THE BATCH LOOP below:",
+                batchLoop: {
+                  step1_selectNext: "Take the next 4 question IDs from the questions array (questions you haven't shown yet).",
+                  step2_validate: "Call ping_validate_batch with those 4 question IDs to check availability.",
+                  step3_handleExhausted: "If some questions are exhausted, use only the available ones returned (might be 0-4 questions).",
+                  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.',
+                  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.",
+                claimRetry: "If ping_claim_reward fails, wait 2 seconds and retry ONCE. If it fails again, tell user earnings are saved.",
+                completionMessage: "Show: total questions answered, total earned, any exhausted questions encountered, transaction hash, and basescan link."
               }
             }, null, 2)
           }]
         };
       }
       // ────────────────────────────────────────────────────────
+      // VALIDATE BATCH
+      // ────────────────────────────────────────────────────────
+      case "ping_validate_batch": {
+        const { questionIds } = args || {};
+        if (!questionIds || !Array.isArray(questionIds) || questionIds.length === 0) {
+          return {
+            content: [{
+              type: "text",
+              text: JSON.stringify({
+                success: false,
+                error: "Invalid question IDs provided. Expected an array of question IDs."
+              }, null, 2)
+            }]
+          };
+        }
+        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 data = await apiRequest("/questions/validate", {
+          method: "POST",
+          body: JSON.stringify({ questionIds })
+        });
+        const availableWithSuggestions = data.available.map((q) => {
+          const suggestions = generateSuggestedAnswers(q.text, q.category);
+          return {
+            id: q.id,
+            question: q.text,
+            reward: q.reward,
+            rewardCents: q.rewardCents,
+            category: q.category,
+            suggestedAnswers: suggestions
+          };
+        });
+        return {
+          content: [{
+            type: "text",
+            text: JSON.stringify({
+              success: true,
+              available: availableWithSuggestions,
+              exhausted: data.exhausted,
+              totalRemaining: data.totalRemaining,
+              message: data.available.length === 0 ? "All questions in this batch are no longer available." : data.exhausted.length > 0 ? `${data.available.length} questions available, ${data.exhausted.length} exhausted.` : `All ${data.available.length} questions are available!`
+            }, null, 2)
+          }]
+        };
+      }
+      // ────────────────────────────────────────────────────────
       // CLAIM REWARD
       // ────────────────────────────────────────────────────────
       case "ping_claim_reward": {

package/package.json

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

package/src/index.ts

@@ -688,8 +688,8 @@ async function apiRequest<T>(
           fetchError.cause) {
         throw new PingError(
           PingErrorCode.NETWORK_ERROR,
-          'Cannot connect to Ping API. Check your internet connection.',
-          'Make sure you have an active internet connection and try again.'
+          `Cannot connect to Ping API at ${API_BASE_URL}. Check your internet connection.`,
+          `Make sure you can reach ${API_BASE_URL} and try again.`
         );
       }
     }
@@ -743,7 +743,8 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
           'Login to Ping with GitHub. Opens a browser window for GitHub OAuth authentication. ' +
           'TRIGGERS: "ping login", "login to ping", "connect to ping", "sign in to ping", "start using ping". ' +
           'Use when the user wants to login, sign in, connect their account, or start using Ping. ' +
-          'After login, a wallet will be automatically created for the user.',
+          'After login, a wallet will be automatically created for the user. ' +
+          'API: https://api.ping-money.com',
         inputSchema: {
           type: 'object',
           properties: {},
@@ -765,7 +766,8 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
         name: 'ping_whoami',
         description:
           'Show your Ping account info - GitHub handle, wallet address, and balance. ' +
-          'Use when the user asks who they are logged in as, their account status, or profile info.',
+          'Use when the user asks who they are logged in as, their account status, or profile info. ' +
+          'API: https://api.ping-money.com',
         inputSchema: {
           type: 'object',
           properties: {},
@@ -808,23 +810,6 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
           required: [],
         },
       },
-      {
-        name: 'ping_list_questions',
-        description:
-          'Show questions available to answer and earn money on Ping. ' +
-          'Use when the user wants to see earning opportunities, available questions, or ways to make money. ' +
-          'Returns questions with their rewards.',
-        inputSchema: {
-          type: 'object',
-          properties: {
-            limit: {
-              type: 'number',
-              description: 'Number of questions to show (default: 5)',
-            },
-          },
-          required: [],
-        },
-      },
       {
         name: 'ping_submit_answer',
         description:
@@ -857,22 +842,42 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
           '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 ALL questions in a SINGLE AskUserQuestion call (batched) to reduce latency. ' +
-          'Use the questions array parameter with multiple question objects. ' +
-          'After user answers, submit ALL answers IN PARALLEL for speed. ' +
-          'AUTO-CLAIM: After all submissions complete, AUTOMATICALLY call ping_claim_reward to send earnings to wallet. ' +
+          '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).',
         inputSchema: {
           type: 'object',
           properties: {
             limit: {
               type: 'number',
-              description: 'Number of questions to include in the session (default: 5)',
+              description: 'Number of questions to include in the session (default: 50)',
             },
           },
           required: [],
         },
       },
+      {
+        name: 'ping_validate_batch',
+        description:
+          'Validate if a batch of questions is still available to answer before showing to user. ' +
+          'Checks if questions are active, not exhausted (maxResponses reached), and not already answered. ' +
+          'Returns available questions with full data + list of exhausted question IDs. ' +
+          'Use this before presenting questions to ensure they can actually be answered.',
+        inputSchema: {
+          type: 'object',
+          properties: {
+            questionIds: {
+              type: 'array',
+              items: { type: 'string' },
+              description: 'Array of question IDs to validate (e.g., ["q1", "q2", "q3", "q4"])',
+            },
+          },
+          required: ['questionIds'],
+        },
+      },
       {
         name: 'ping_claim_reward',
         description:
@@ -1289,57 +1294,6 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
         };
       }
 
-      // ────────────────────────────────────────────────────────
-      // LIST QUESTIONS
-      // ────────────────────────────────────────────────────────
-      case 'ping_list_questions': {
-        const { limit = 5 } = (args || {}) as { limit?: number };
-
-        const data = await apiRequest<{
-          questions: Array<{
-            id: string;
-            text: string;
-            reward: string;
-            rewardCents: number;
-            category: string;
-            asker: string;
-          }>;
-          total: number;
-        }>(`/questions?limit=${limit}`);
-
-        if (data.questions.length === 0) {
-          return {
-            content: [{
-              type: 'text',
-              text: JSON.stringify({
-                success: true,
-                questions: [],
-                message: 'No questions available right now.',
-                hint: 'New questions are added regularly. Check back soon, or use ping_create_question to ask your own!',
-              }, null, 2),
-            }],
-          };
-        }
-
-        return {
-          content: [{
-            type: 'text',
-            text: JSON.stringify({
-              success: true,
-              questions: data.questions.map(q => ({
-                id: q.id,
-                question: q.text,
-                reward: q.reward,
-                category: q.category,
-                asker: q.asker,
-              })),
-              totalAvailable: data.total,
-              message: `Found ${data.questions.length} question${data.questions.length !== 1 ? 's' : ''} you can answer!`,
-            }, null, 2),
-          }],
-        };
-      }
-
       // ────────────────────────────────────────────────────────
       // SUBMIT ANSWER
       // ────────────────────────────────────────────────────────
@@ -1357,7 +1311,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
               text: JSON.stringify({
                 success: false,
                 error: 'Missing question ID.',
-                hint: 'Use ping_list_questions to see available questions with their IDs.',
+                hint: 'Use ping_answer_flow to see available questions and answer them.',
               }, null, 2),
             }],
           };
@@ -1438,6 +1392,21 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
             };
           }
 
+          // Check if question is exhausted (reached maxResponses)
+          if (data.error === 'question_exhausted') {
+            return {
+              content: [{
+                type: 'text',
+                text: JSON.stringify({
+                  success: false,
+                  error: 'question_exhausted',
+                  message: data.message || 'This question is no longer accepting answers (maxResponses reached).',
+                  hint: 'Skip this question and continue with others in your batch.',
+                }),
+              }],
+            };
+          }
+
           return {
             content: [{
               type: 'text',
@@ -1495,7 +1464,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
           };
         }
 
-        const { limit = 5 } = (args || {}) as { limit?: number };
+        const { limit = 50 } = (args || {}) as { limit?: number };
 
         // Fetch questions from API
         const data = await apiRequest<{
@@ -1557,23 +1526,108 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
               // Full question data (present AFTER user confirms)
               questions: questionsWithSuggestions,
               instructions: {
-                step1_summary: 'FIRST show ONLY the oneLiner from summary, then ask "Ready to start?" Do NOT reveal questions yet.',
-                step2_questions: 'AFTER user confirms, BATCH ALL QUESTIONS in a SINGLE AskUserQuestion call (max 4 per call due to tool limit).',
-                format: 'Each question: question text with reward in header, options are ONLY the suggested answers (no Skip option - user can skip via "Other"). multiSelect: false.',
-                suggestedAnswerSubmission: 'When user selects a suggested answer, call ping_submit_answer with preApproved=true for instant approval.',
-                customAnswerSubmission: 'When user types custom text via "Other", call ping_submit_answer with preApproved=false (AI review).',
-                parallelSubmission: 'After collecting all answers, submit them IN PARALLEL using multiple ping_submit_answer calls in one message for speed.',
-                skipBehavior: 'If user selects "Other" and leaves blank or says skip, do not submit an answer for that question.',
-                errorHandling: 'If some answer submissions fail, still proceed with auto-claim for the successful ones. Report which answers failed and why.',
-                autoClaim: 'IMPORTANT: After ALL answer submissions complete (even if some failed), IMMEDIATELY call ping_claim_reward to send earnings to wallet. Do NOT ask - just claim automatically.',
-                claimRetry: 'If ping_claim_reward fails, wait 2 seconds and retry ONCE. If it fails again, tell user earnings are saved and they can claim later.',
-                completionMessage: 'After claim completes, show: total earned, transaction hash, and basescan link.',
+                overview: 'This is a continuous batch validation workflow. Fetch 50 questions upfront, then validate+present in batches of 4 until all questions are exhausted.',
+                step1_summary: 'FIRST show ONLY the oneLiner from summary with ~estimates, then ask "Ready to start?" Do NOT reveal questions yet.',
+                step2_startBatching: 'AFTER user confirms, START THE BATCH LOOP below:',
+                batchLoop: {
+                  step1_selectNext: 'Take the next 4 question IDs from the questions array (questions you haven\'t shown yet).',
+                  step2_validate: 'Call ping_validate_batch with those 4 question IDs to check availability.',
+                  step3_handleExhausted: 'If some questions are exhausted, use only the available ones returned (might be 0-4 questions).',
+                  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.',
+                  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.',
+                claimRetry: 'If ping_claim_reward fails, wait 2 seconds and retry ONCE. If it fails again, tell user earnings are saved.',
+                completionMessage: 'Show: total questions answered, total earned, any exhausted questions encountered, transaction hash, and basescan link.',
               },
             }, null, 2),
           }],
         };
       }
 
+      // ────────────────────────────────────────────────────────
+      // VALIDATE BATCH
+      // ────────────────────────────────────────────────────────
+      case 'ping_validate_batch': {
+        const { questionIds } = (args || {}) as { questionIds: string[] };
+
+        if (!questionIds || !Array.isArray(questionIds) || questionIds.length === 0) {
+          return {
+            content: [{
+              type: 'text',
+              text: JSON.stringify({
+                success: false,
+                error: 'Invalid question IDs provided. Expected an array of question IDs.',
+              }, null, 2),
+            }],
+          };
+        }
+
+        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),
+            }],
+          };
+        }
+
+        // Call the validate endpoint
+        const data = await apiRequest<{
+          available: Array<{
+            id: string;
+            text: string;
+            reward: string;
+            rewardCents: number;
+            category: string;
+          }>;
+          exhausted: string[];
+          totalRemaining: number;
+        }>('/questions/validate', {
+          method: 'POST',
+          body: JSON.stringify({ questionIds }),
+        });
+
+        // Generate suggested answers for available questions
+        const availableWithSuggestions = data.available.map(q => {
+          const suggestions = generateSuggestedAnswers(q.text, q.category);
+          return {
+            id: q.id,
+            question: q.text,
+            reward: q.reward,
+            rewardCents: q.rewardCents,
+            category: q.category,
+            suggestedAnswers: suggestions,
+          };
+        });
+
+        return {
+          content: [{
+            type: 'text',
+            text: JSON.stringify({
+              success: true,
+              available: availableWithSuggestions,
+              exhausted: data.exhausted,
+              totalRemaining: data.totalRemaining,
+              message: data.available.length === 0
+                ? 'All questions in this batch are no longer available.'
+                : data.exhausted.length > 0
+                  ? `${data.available.length} questions available, ${data.exhausted.length} exhausted.`
+                  : `All ${data.available.length} questions are available!`,
+            }, null, 2),
+          }],
+        };
+      }
+
       // ────────────────────────────────────────────────────────
       // CLAIM REWARD
       // ────────────────────────────────────────────────────────

package/package/package.json

@@ -1,29 +0,0 @@
-{
-  "name": "ping-mcp-server",
-  "version": "0.1.4",
-  "description": "MCP server that gives Claude Code the ability to interact with Ping",
-  "type": "module",
-  "bin": {
-    "ping-mcp-server": "./dist/init.js",
-    "ping-mcp": "./dist/index.js",
-    "ping-init": "./dist/init.js"
-  },
-  "scripts": {
-    "dev": "tsx watch src/index.ts",
-    "build": "tsup src/index.ts src/init.ts --format esm --dts",
-    "start": "node dist/index.js",
-    "test": "vitest",
-    "lint": "eslint src/",
-    "clean": "rm -rf dist"
-  },
-  "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.0.0",
-    "zod": "^3.22.0"
-  },
-  "devDependencies": {
-    "@types/node": "^25.0.3",
-    "tsup": "^8.0.0",
-    "tsx": "^4.0.0",
-    "vitest": "^1.0.0"
-  }
-}