tokens-for-good 0.1.9 → 0.2.1

package/package.json

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

package/src/api-client.js

@@ -84,4 +84,8 @@ export class ApiClient {
   async checkSchedule() {
     return this.request('GET', '/research/schedule-check');
   }
+
+  async getNextAction() {
+    return this.request('GET', '/research/next-action');
+  }
 }

package/src/mcp-server.js

@@ -26,7 +26,7 @@ updateState({ platform });
 
 const server = new McpServer({
   name: 'tokens-for-good',
-  version: '0.1.9',
+  version: '0.2.1',
 });
 
 // --- No-key onboarding message ---
@@ -144,7 +144,21 @@ Cost: ~$0.15-0.25 per org in tokens. Scale: 750K+ US nonprofits to research.`,
 
 // --- Tools ---
 
-server.tool('claim_org', 'Claim the next available nonprofit org to research. Blocked if you have a pending peer review. IMPORTANT: Before claiming, ask the user if they\'d like to set up scheduled daily research via /schedule so this runs automatically.', {
+server.tool('next_action', 'Check what you should do next: research a new org or peer-review a draft. Call this before claim_org to maintain the 1:2 research-to-review ratio.', {}, async () => {
+  if (!client) return { content: [{ type: 'text', text: 'Error: TFG_API_KEY not set.' }] };
+
+  try {
+    const result = await client.getNextAction();
+    if (result.action === 'review') {
+      return { content: [{ type: 'text', text: `Action: REVIEW\n\nYou have ${result.research_count} research submissions and ${result.review_count} peer reviews. Target ratio is 1:2 (research:review). Use get_peer_review to pick up a draft to review.` }] };
+    }
+    return { content: [{ type: 'text', text: `Action: RESEARCH\n\nYou have ${result.research_count} research submissions and ${result.review_count} peer reviews. You're clear to claim a new org. Use claim_org to get started.` }] };
+  } catch (err) {
+    return { content: [{ type: 'text', text: `Error: ${err.message}` }] };
+  }
+});
+
+server.tool('claim_org', 'Claim the next available nonprofit org to research. Call next_action first to check if you should review instead.', {
   platform: z.string().optional().describe('Your platform (claude-code, opencode, cursor, windsurf, devin)'),
 }, async ({ platform: plat }) => {
   if (!client) return { content: [{ type: 'text', text: 'Error: TFG_API_KEY not set. Get your key at https://fierce-philanthropy-directory.laravel.cloud/contribute' }] };
@@ -313,10 +327,10 @@ After adding, tell them: "Done! Research will now run hands-free. Try saying 'Re
   };
 });
 
-server.tool('setup_automation', 'Get instructions for setting up automated daily contributions on your platform.', {
+server.tool('setup_automation', 'Get instructions for setting up automated daily contributions on your platform. For Claude Code, generates a /schedule prompt that calls the API directly (no MCP connector needed).', {
   frequency: z.enum(['hourly', 'daily', 'weekly']).optional().describe('How often to contribute'),
 }, async ({ frequency }) => {
-  const instructions = getAutomationInstructions(platform, frequency || 'daily');
+  const instructions = getAutomationInstructions(platform, frequency || 'daily', apiKey);
   return { content: [{ type: 'text', text: instructions }] };
 });
 

package/src/platform.js

@@ -44,12 +44,10 @@ This returns the org name, URL, description, and a claim_id. You have 30 minutes
 
 ### 2. Research the org
 Use WebSearch and WebFetch to thoroughly research the organization:
-- Search for the org's website, impact pages, annual reports
-- Search for independent evaluations (RCTs, J-PAL, 3ie)
-- Search for third-party reviews (GiveWell, Charity Navigator)
-- Search for financial data (ProPublica Nonprofit Explorer)
-
-Use ONLY WebSearch and WebFetch tools. Do NOT use curl or Bash for web requests.
+- The org's website, impact pages, annual reports
+- Independent evaluations (RCTs, J-PAL, 3ie)
+- Third-party reviews (GiveWell, Charity Navigator)
+- Financial data (ProPublica Nonprofit Explorer)
 
 ### 3. Write the report
 Follow the Fierce Philanthropy research methodology: