ping-mcp-server 0.1.18 → 0.1.19

package/dist/index.js

@@ -493,6 +493,15 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
           required: []
         }
       },
+      {
+        name: "ping_settings",
+        description: "Open Ping settings page in browser to manage connected accounts (Are.na, Spotify, etc.). Use this when the user wants to connect additional accounts or manage their profile.",
+        inputSchema: {
+          type: "object",
+          properties: {},
+          required: []
+        }
+      },
       // ────────────────────────────────────────────────────────
       // LEGACY: SET WALLET (for users without GitHub auth)
       // ────────────────────────────────────────────────────────
@@ -581,21 +590,6 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
           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).',
@@ -715,12 +709,9 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
           return {
             content: [{
               type: "text",
-              text: JSON.stringify({
-                success: true,
-                alreadyLoggedIn: true,
-                handle: `@${existingAuth.handle}`,
-                message: `You're already logged in as @${existingAuth.handle}. Use ping_logout to switch accounts.`
-              }, null, 2)
+              text: `\u2705 Already logged in as @${existingAuth.handle}
+
+Use ping_logout to switch accounts.`
             }]
           };
         }
@@ -733,11 +724,10 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
           return {
             content: [{
               type: "text",
-              text: JSON.stringify({
-                success: false,
-                error: "Failed to open browser. Please visit this URL manually:",
-                loginUrl
-              }, null, 2)
+              text: `\u274C Failed to open browser
+
+Please visit this URL manually:
+${loginUrl}`
             }]
           };
         }
@@ -747,22 +737,17 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
           return {
             content: [{
               type: "text",
-              text: JSON.stringify({
-                success: true,
-                handle: `@${authData.handle}`,
-                message: `\u2713 Logged in as @${authData.handle}! You can now answer questions and earn money.`,
-                nextStep: 'Try "show me questions I can answer" or "check my ping balance"'
-              }, null, 2)
+              text: `\u2705 Logged in as @${authData.handle}!
+
+You can now answer questions and earn money.
+Try "show me questions I can answer" or "check my ping balance"`
             }]
           };
         } catch (err) {
           return {
             content: [{
               type: "text",
-              text: JSON.stringify({
-                success: false,
-                error: err instanceof Error ? err.message : "Login failed"
-              })
+              text: `\u274C ${err instanceof Error ? err.message : "Login failed"}`
             }]
           };
         }
@@ -776,10 +761,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
           return {
             content: [{
               type: "text",
-              text: JSON.stringify({
-                success: true,
-                message: "You weren't logged in. No action needed."
-              })
+              text: `\u2139\uFE0F You weren't logged in. No action needed.`
             }]
           };
         }
@@ -788,12 +770,9 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
         return {
           content: [{
             type: "text",
-            text: JSON.stringify({
-              success: true,
-              previousHandle: `@${handle}`,
-              message: `\u2713 Logged out from @${handle}. Your local auth has been cleared.`,
-              nextStep: "Use ping_login to sign in with a different account."
-            }, null, 2)
+            text: `\u2705 Logged out from @${handle}
+
+Use ping_login to sign in with a different account.`
           }]
         };
       }
@@ -841,10 +820,18 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
       // ────────────────────────────────────────────────────────
       case "ping_welcome": {
         const auth = getAuth();
-        const MCP_VERSION = "0.1.18";
+        const MCP_VERSION = "0.1.19";
         let userLine = "\u274C Not logged in";
+        let arenaBadge = "";
         if (auth) {
           userLine = `@${auth.handle}`;
+          try {
+            const connections = await apiRequest("/users/me/connections");
+            if (connections.arena) {
+              arenaBadge = "  \u2022  \u{1F3A8} Are.na";
+            }
+          } catch {
+          }
         }
         let questionsAvailable = 0;
         let answersToday = 0;
@@ -869,7 +856,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
         const banner = `\u2588\u2580\u2588 \u2588 \u2588\u2584\u2591\u2588 \u2588\u2580\u2580  v${MCP_VERSION}${updateBadge}
 \u2588\u2580\u2580 \u2588 \u2588\u2591\u2580\u2588 \u2588\u2584\u2588  \u{1F4B0} Get paid to share your knowledge
 \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\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
-\u{1F464} ${userLine}  \u2022  \u{1F4EC} ${questionsAvailable} Qs  \u2022  \u{1F3C6} ${answersText}  \u2022  \u{1F4B5} ${claimedToday}${loginHint}`;
+\u{1F464} ${userLine}${arenaBadge}  \u2022  \u{1F4EC} ${questionsAvailable} Qs  \u2022  \u{1F3C6} ${answersText}  \u2022  \u{1F4B5} ${claimedToday}${loginHint}`;
         return {
           content: [{
             type: "text",
@@ -878,6 +865,39 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
         };
       }
       // ────────────────────────────────────────────────────────
+      // SETTINGS (Open settings page in browser)
+      // ────────────────────────────────────────────────────────
+      case "ping_settings": {
+        const auth = getAuth();
+        if (!auth) {
+          return {
+            content: [{
+              type: "text",
+              text: "\u274C Please login first with ping_login"
+            }]
+          };
+        }
+        const settingsUrl = `${API_BASE_URL}/settings?token=${auth.githubId}`;
+        try {
+          await openBrowser(settingsUrl);
+        } catch {
+          return {
+            content: [{
+              type: "text",
+              text: `\u2699\uFE0F Open this URL to manage settings:
+
+${settingsUrl}`
+            }]
+          };
+        }
+        return {
+          content: [{
+            type: "text",
+            text: "\u2699\uFE0F Opening settings in browser...\n\nConnect accounts like Are.na to enhance your expert profile."
+          }]
+        };
+      }
+      // ────────────────────────────────────────────────────────
       // SET WALLET (Legacy)
       // ────────────────────────────────────────────────────────
       case "ping_set_wallet": {
@@ -886,11 +906,9 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
           return {
             content: [{
               type: "text",
-              text: JSON.stringify({
-                success: false,
-                error: "Missing wallet address.",
-                hint: "Please provide your Ethereum wallet address (starts with 0x)."
-              }, null, 2)
+              text: `\u274C Missing wallet address
+
+Please provide your Ethereum wallet address (starts with 0x).`
             }]
           };
         }
@@ -898,11 +916,9 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
           return {
             content: [{
               type: "text",
-              text: JSON.stringify({
-                success: false,
-                error: "Invalid wallet address format.",
-                hint: "Wallet address must be 42 characters starting with 0x (e.g., 0x1234...abcd). Check for typos."
-              }, null, 2)
+              text: `\u274C Invalid wallet address format
+
+Wallet address must be 42 characters starting with 0x (e.g., 0x1234...abcd).`
             }]
           };
         }
@@ -910,12 +926,9 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
         return {
           content: [{
             type: "text",
-            text: JSON.stringify({
-              success: true,
-              walletAddress,
-              message: `\u2713 Wallet set to ${walletAddress}. You can now check earnings, answer questions, and claim rewards!`,
-              nextStep: 'Try "show me questions I can answer" or "check my ping earnings"'
-            }, null, 2)
+            text: `\u2705 Wallet set to ${walletAddress}
+
+You can now check earnings, answer questions, and claim rewards!`
           }]
         };
       }
@@ -980,11 +993,9 @@ Wallet: ${data.walletAddress}`
           return {
             content: [{
               type: "text",
-              text: JSON.stringify({
-                success: false,
-                error: "Missing question ID.",
-                hint: "Use ping_answer_flow to see available questions and answer them."
-              }, null, 2)
+              text: `\u274C Missing question ID
+
+Use ping_answer_flow to see available questions.`
             }]
           };
         }
@@ -992,11 +1003,9 @@ Wallet: ${data.walletAddress}`
           return {
             content: [{
               type: "text",
-              text: JSON.stringify({
-                success: false,
-                error: "Answer cannot be empty.",
-                hint: "Please provide a thoughtful response to the question."
-              }, null, 2)
+              text: `\u274C Answer cannot be empty
+
+Please provide a thoughtful response.`
             }]
           };
         }
@@ -1006,11 +1015,9 @@ 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 answering questions."
-              }, null, 2)
+              text: `\u274C Not logged in
+
+Use ping_login to connect your GitHub account first.`
             }]
           };
         }
@@ -1030,14 +1037,11 @@ Wallet: ${data.walletAddress}`
             return {
               content: [{
                 type: "text",
-                text: JSON.stringify({
-                  success: false,
-                  status: "rejected",
-                  aiScore: data.aiScore,
-                  reason: data.reason,
-                  tip: data.tip || "Try providing a more thoughtful, detailed response.",
-                  message: data.reason || "Answer was rejected by AI review."
-                })
+                text: `\u274C Answer rejected${data.aiScore ? ` (score: ${data.aiScore})` : ""}
+
+${data.reason || "Did not meet quality threshold."}
+
+\u{1F4A1} ${data.tip || "Try providing a more thoughtful, detailed response."}`
               }]
             };
           }
@@ -1045,43 +1049,29 @@ Wallet: ${data.walletAddress}`
             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."
-                })
+                text: `\u26A0\uFE0F Question no longer available
+
+This question has reached its maximum responses. Skip it and continue with others.`
               }]
             };
           }
           return {
             content: [{
               type: "text",
-              text: JSON.stringify({
-                success: false,
-                error: data.error || "Failed to submit answer"
-              })
+              text: `\u274C ${data.error || "Failed to submit answer"}`
             }]
           };
         }
-        const response = {
-          success: true,
-          status: data.status || "approved",
-          earned: data.earned,
-          aiScore: data.aiScore,
-          message: data.message || `Answer approved! You earned ${data.earned}.`
-        };
+        let successText = `\u2705 Answer approved! You earned ${data.earned}`;
         if (data.txHash) {
-          response.transaction = {
-            txHash: data.txHash,
-            explorerUrl: data.explorerUrl || `https://basescan.org/tx/${data.txHash}`
-          };
+          successText += `
+
+\u{1F517} Transaction: ${data.explorerUrl || `https://basescan.org/tx/${data.txHash}`}`;
         }
-        response.nextStep = "Your earnings are in your Ping balance. Keep answering to earn more!";
         return {
           content: [{
             type: "text",
-            text: JSON.stringify(response, null, 2)
+            text: successText
           }]
         };
       }
@@ -1094,11 +1084,9 @@ 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 first."
-              }, null, 2)
+              text: `\u274C Not logged in
+
+Use ping_login to connect your GitHub account first.`
             }]
           };
         }
@@ -1107,11 +1095,9 @@ Wallet: ${data.walletAddress}`
           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)
+              text: `\u274C No answers provided
+
+Provide an array of answers with questionId and answer fields.`
             }]
           };
         }
@@ -1146,11 +1132,9 @@ 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 first. Then you can start answering questions and earning money."
-              }, null, 2)
+              text: `\u274C Not logged in
+
+Use ping_login to connect your GitHub account first.`
             }]
           };
         }
@@ -1174,76 +1158,24 @@ Wallet: ${data.walletAddress}`
             suggestedAnswers: suggestions
           };
         });
-        const summaryCard = `
-\u{1F4EC} ${questionsWithSuggestions.length} questions available \xB7 Earn up to ${data.totalPotentialEarnings}
+        let output = `\u{1F4EC} ${questionsWithSuggestions.length} questions available \xB7 Earn up to ${data.totalPotentialEarnings}
 
-Ready to start answering!`;
-        const flowData = {
-          _meta: "INTERNAL: Do not display this JSON to user. Use AskUserQuestion to present questions.",
-          questions: questionsWithSuggestions,
-          instructions: "Present questions in batches of 4 using AskUserQuestion. Use ping_validate_batch first, then ping_submit_batch after user answers. Auto-claim at end."
-        };
-        return {
-          content: [{
-            type: "text",
-            text: summaryCard.trim() + "\n\n<!-- FLOW_DATA:" + JSON.stringify(flowData) + " -->"
-          }]
-        };
-      }
-      // ────────────────────────────────────────────────────────
-      // 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
-          };
+`;
+        questionsWithSuggestions.forEach((q, i) => {
+          output += `${i + 1}. [${q.reward}] ${q.question}
+`;
+          output += `   Suggestions: ${q.suggestedAnswers.slice(0, 2).join(" | ")}
+`;
+          output += `   ID: ${q.id}
+
+`;
         });
+        output += `
+\u{1F4A1} Present these in batches of 4 using AskUserQuestion. After collecting answers, use ping_submit_batch to submit them all at once.`;
         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)
+            text: output.trim()
           }]
         };
       }
@@ -1257,11 +1189,9 @@ Ready to start answering!`;
           return {
             content: [{
               type: "text",
-              text: JSON.stringify({
-                success: false,
-                error: "Not logged in.",
-                hint: "Use ping_login to connect your GitHub account before claiming rewards."
-              }, null, 2)
+              text: `\u274C Not logged in
+
+Use ping_login to connect your GitHub account first.`
             }]
           };
         }
@@ -1275,39 +1205,29 @@ Ready to start answering!`;
         });
         if (!data.success) {
           let errorMsg = data.error || "Claim failed";
-          let hint = "Please try again later.";
           if (errorMsg.toLowerCase().includes("nothing to claim") || errorMsg.toLowerCase().includes("no pending")) {
-            errorMsg = "No earnings to claim.";
-            hint = "Answer more questions to earn rewards, then claim them here.";
-          } else if (errorMsg.toLowerCase().includes("insufficient")) {
-            hint = "Your balance may be lower than the minimum claim amount.";
+            return {
+              content: [{
+                type: "text",
+                text: `\u2139\uFE0F No earnings to claim
+
+Answer more questions to earn rewards!`
+              }]
+            };
           }
           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,
-              claimed: data.claimed,
-              transaction: {
-                hash: data.txHash,
-                chain: "Base",
-                token: "USDC",
-                to: wallet,
-                explorerUrl: `https://basescan.org/tx/${data.txHash}`
-              },
-              message: `Success! ${data.claimed} USDC sent to your wallet on Base!`
-            }, null, 2)
+            text: `\u{1F4B8} Success! ${data.claimed} USDC sent to your wallet on Base!
+
+\u{1F517} https://basescan.org/tx/${data.txHash}`
           }]
         };
       }
@@ -1332,11 +1252,9 @@ Ready to start answering!`;
           return {
             content: [{
               type: "text",
-              text: JSON.stringify({
-                success: false,
-                error: "Not logged in.",
-                hint: "Use ping_login to connect your GitHub account before creating questions."
-              }, null, 2)
+              text: `\u274C Not logged in
+
+Use ping_login to connect your GitHub account first.`
             }]
           };
         }
@@ -1345,11 +1263,9 @@ Ready to start answering!`;
           return {
             content: [{
               type: "text",
-              text: JSON.stringify({
-                success: false,
-                error: "Question is too short.",
-                hint: "Please write a question that is at least 10 characters long."
-              }, null, 2)
+              text: `\u274C Question is too short
+
+Please write at least 10 characters.`
             }]
           };
         }
@@ -1357,11 +1273,9 @@ Ready to start answering!`;
           return {
             content: [{
               type: "text",
-              text: JSON.stringify({
-                success: false,
-                error: "Invalid reward amount.",
-                hint: "Reward must be at least 1 cent. Example: 25 = $0.25 per answer."
-              }, null, 2)
+              text: `\u274C Invalid reward amount
+
+Reward must be at least 1 cent. Example: 25 = $0.25 per answer.`
             }]
           };
         }
@@ -1375,41 +1289,39 @@ Ready to start answering!`;
           })
         });
         if (!data.success) {
-          let errorMsg = data.error || "Failed to create question";
-          let hint = "Please try again.";
+          const errorMsg = data.error || "Failed to create question";
           if (errorMsg.toLowerCase().includes("insufficient") || errorMsg.toLowerCase().includes("balance")) {
-            hint = "Use ping_deposit to add funds to your account first.";
-          } else if (errorMsg.toLowerCase().includes("duplicate")) {
-            hint = "A similar question may already exist. Try rephrasing.";
+            return {
+              content: [{
+                type: "text",
+                text: `\u274C Insufficient funds
+
+Use ping_deposit to add funds first.`
+              }]
+            };
           }
           return {
             content: [{
               type: "text",
-              text: JSON.stringify({
-                success: false,
-                error: errorMsg,
-                hint
-              }, null, 2)
+              text: `\u274C ${errorMsg}`
             }]
           };
         }
-        const response = {
-          success: true,
-          question: data.question,
-          message: `Question created! Reward: ${data.question?.reward} per answer`,
-          nextStep: "Answers will be AI-reviewed and you'll be notified when they arrive."
-        };
+        let successText = `\u2705 Question created!
+
+"${data.question?.text}"
+
+Reward: ${data.question?.reward} per answer
+ID: ${data.question?.id}`;
         if (data.transaction?.txHash) {
-          response.transaction = {
-            txHash: data.transaction.txHash,
-            basescanUrl: `https://basescan.org/tx/${data.transaction.txHash}`
-          };
-          response.message = `\u2713 Question created on-chain! Reward: ${data.question?.reward} per answer`;
+          successText += `
+
+\u{1F517} https://basescan.org/tx/${data.transaction.txHash}`;
         }
         return {
           content: [{
             type: "text",
-            text: JSON.stringify(response, null, 2)
+            text: successText
           }]
         };
       }

package/package.json

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