tokens-for-good 0.2.3 → 0.2.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tokens-for-good",
-  "version": "0.2.3",
+  "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.3',
+  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

@@ -90,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