tokens-for-good 0.2.2 → 0.2.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tokens-for-good",
-  "version": "0.2.2",
+  "version": "0.2.4",
   "type": "module",
   "description": "Donate your spare AI tokens to research nonprofits for Fierce Philanthropy",
   "bin": {

package/src/mcp-server.js

@@ -26,7 +26,7 @@ updateState({ platform });
 
 const server = new McpServer({
   name: 'tokens-for-good',
-  version: '0.2.2',
+  version: '0.2.4',
 });
 
 // --- No-key onboarding message ---
@@ -287,6 +287,29 @@ server.tool('my_impact', 'See your personal contribution stats, tier, and histor
   }
 });
 
+server.tool('get_badge', 'Get a markdown badge for your GitHub README showing your Tokens for Good contribution stats.', {}, async () => {
+  if (!client) return { content: [{ type: 'text', text: 'Error: TFG_API_KEY not set.' }] };
+
+  try {
+    const result = await client.getImpact();
+    const c = result.contributor;
+    const tier = c.tier || 'new';
+    const orgCount = c.total_orgs || 0;
+    const label = `Tokens_for_Good`;
+    const message = `${orgCount}_org${orgCount !== 1 ? 's' : ''}_researched`;
+    const color = tier === 'gold' ? 'FFD700' : tier === 'silver' ? 'C0C0C0' : tier === 'bronze' ? 'CD7F32' : '54BC4B';
+    const badgeUrl = `https://img.shields.io/badge/${label}-${message}-${color}?style=flat`;
+    const linkUrl = `https://fierce-philanthropy-directory.laravel.cloud/contribute`;
+    const markdown = `[![Tokens for Good](${badgeUrl})](${linkUrl})`;
+
+    return {
+      content: [{ type: 'text', text: `Add this badge to your GitHub README:\n\n\`\`\`markdown\n${markdown}\n\`\`\`\n\nPreview: ${markdown}\n\nTier: ${tier} | Orgs: ${orgCount}` }],
+    };
+  } catch (err) {
+    return { content: [{ type: 'text', text: `Error: ${err.message}` }] };
+  }
+});
+
 server.tool('setup_guide', 'Get setup instructions for Tokens for Good. Use this if the user needs help with installation, API keys, or configuration.', {}, async () => {
   return { content: [{ type: 'text', text: NO_KEY_INSTRUCTIONS }] };
 });

package/src/platform.js

@@ -1,21 +1,20 @@
 // Platform detection and automation guidance
 
 export function detectPlatform() {
-  // Check environment hints
   if (process.env.CLAUDE_CODE) return 'claude-code';
   if (process.env.OPENCODE) return 'opencode';
   if (process.env.DEVIN) return 'devin';
   if (process.env.CURSOR_SESSION) return 'cursor';
   if (process.env.WINDSURF_SESSION) return 'windsurf';
 
-  // Check parent process name
   const parentName = process.env._ || process.env.PARENT_PROCESS || '';
   if (parentName.includes('claude')) return 'claude-code';
   if (parentName.includes('opencode')) return 'opencode';
   if (parentName.includes('cursor')) return 'cursor';
   if (parentName.includes('windsurf')) return 'windsurf';
 
-  return 'unknown';
+  // Default to claude-code since it's the primary MCP host
+  return 'claude-code';
 }
 
 export function isSchedulable(platform) {
@@ -91,6 +90,40 @@ Method: POST
 Headers: X-TFG-Api-Key: ${apiKey}, Content-Type: application/json
 Body: {"claim_id": <claim_id from step 1>, "report_markdown": "<full report>", "model_used": "claude-code-scheduled"}
 
+### 5. Check next-action
+After submitting, check if you need to do a peer review before continuing:
+
+WebFetch URL: https://fierce-philanthropy-directory.laravel.cloud/api/research/next-action
+Method: GET
+Headers: X-TFG-Api-Key: ${apiKey}, Accept: application/json
+
+If the response says action is "review", do the review:
+
+**5a. Get the review:**
+WebFetch URL: https://fierce-philanthropy-directory.laravel.cloud/api/research/review/next
+Method: GET
+Headers: X-TFG-Api-Key: ${apiKey}, Accept: application/json
+
+**5b. Review the report** — score it 1-4 (4=great, 3=good with minor fixes, 2=needs redo, 1=bad actor)
+
+**5c. Submit the review:**
+WebFetch URL: https://fierce-philanthropy-directory.laravel.cloud/api/research/review/submit
+Method: POST
+Headers: X-TFG-Api-Key: ${apiKey}, Content-Type: application/json
+Body: {"claim_id": <claim_id>, "score": <1-4>, "notes": "<review notes>", "updated_report": "<fixed report if score is 3>"}
+
+### 6. Repeat (up to 3 orgs per session)
+After completing each org (and any peer review), loop back to Step 1 and claim the next org.
+Research up to 3 orgs total per session. After 3 orgs (or if no more are available), stop.
+
+## Batch Flow Summary
+\`\`\`
+for i in 1..3:
+  claim org → research → submit report
+  check next-action → if review needed, do review
+  repeat
+\`\`\`
+
 ### Rules
 - Every factual claim needs an inline citation [Source Name](URL)
 - Only use direct results from the org, not from similar orgs
@@ -137,7 +170,7 @@ Configure a ${frequency} recurring session with the prompt:
 Devin runs in the cloud, fully autonomous.`;
 
     default:
-      return `Automated contributions are not available on this platform. You can contribute manually by saying "Research an org for Fierce Philanthropy" in any session.`;
+      return getAutomationInstructions('claude-code', frequency, apiKey);
   }
 }