tokens-for-good 0.2.3 → 0.2.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tokens-for-good",
-  "version": "0.2.3",
+  "version": "0.2.5",
   "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.5',
 });
 
 // --- No-key onboarding message ---
@@ -191,15 +191,17 @@ server.tool('get_methodology', 'Get the full research methodology, verification
   }
 });
 
-server.tool('submit_report', 'Submit a completed research report for an org you claimed.', {
+server.tool('submit_report', 'Submit a completed research report for an org you claimed. IMPORTANT: Estimate your token usage for this research session and pass it as estimated_tokens (input + output tokens combined).', {
   claim_id: z.number().describe('The claim ID from claim_org'),
   report_markdown: z.string().describe('The full research report in markdown'),
   model_used: z.string().optional().describe('The model that generated this report'),
-}, async ({ claim_id, report_markdown, model_used }) => {
+  estimated_tokens: z.number().optional().describe('Your estimated total token usage (input + output) for this research session'),
+}, async ({ claim_id, report_markdown, model_used, estimated_tokens }) => {
   if (!client) return { content: [{ type: 'text', text: 'Error: TFG_API_KEY not set.' }] };
 
+  const tokenUsage = estimated_tokens ? { total_tokens: estimated_tokens } : null;
   try {
-    const result = await client.submitReport(claim_id, report_markdown, null, null, model_used);
+    const result = await client.submitReport(claim_id, report_markdown, tokenUsage, null, model_used);
     markContributed();
     const state = loadState();
     const stats = result.contributor_stats;
@@ -277,10 +279,33 @@ server.tool('my_impact', 'See your personal contribution stats, tier, and histor
   try {
     const result = await client.getImpact();
     const c = result.contributor;
-    const estimatedCost = (c.total_tokens / 1_000_000 * 3).toFixed(2);
+    const tokenStr = c.total_tokens > 0 ? `${(c.total_tokens / 1000).toFixed(0)}K tokens contributed` : 'No token data yet';
 
     return {
-      content: [{ type: 'text', text: `Your Impact (@${c.github_handle}):\n\nTier: ${c.tier}\nOrgs researched: ${c.total_orgs}\nEstimated donation: ~$${estimatedCost}\nAcceptance rate: ${c.acceptance_rate}%\nAutomation: ${c.has_schedule ? 'Active' : 'Not set up'}\n\nRecent:\n${result.claims?.slice(0, 5).map(cl => `  ${cl.organization?.name || 'Unknown'} - ${cl.status}`).join('\n') || 'None'}` }],
+      content: [{ type: 'text', text: `Your Impact (@${c.github_handle}):\n\nTier: ${c.tier}\nOrgs researched: ${c.total_orgs}\nTokens: ${tokenStr}\nAcceptance rate: ${c.acceptance_rate}%\nAutomation: ${c.has_schedule ? 'Active' : 'Not set up'}\n\nRecent:\n${result.claims?.slice(0, 5).map(cl => `  ${cl.organization?.name || 'Unknown'} - ${cl.status}`).join('\n') || 'None'}` }],
+    };
+  } catch (err) {
+    return { content: [{ type: 'text', text: `Error: ${err.message}` }] };
+  }
+});
+
+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}` }] };

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