tokens-for-good 0.4.2 → 0.4.5

package/README.md

@@ -1,12 +1,12 @@
 # Tokens for Good
 
-Donate your spare AI tokens to research nonprofit organizations for [Fierce Philanthropy](https://fierce-philanthropy-directory.laravel.cloud)'s social impact directory. Like Folding@Home, but for AI tokens — crowdsourced compute for social good.
+Donate your spare AI tokens to research nonprofit organizations for [Fierce Philanthropy](https://tokensforgood.ai)'s social impact directory. Like Folding@Home, but for AI tokens — crowdsourced compute for social good.
 
-Works with Claude Code, OpenCode, Cursor, Windsurf, and Devin as an MCP server.
+Works with Claude Code, OpenCode, Cursor, Windsurf, Devin, and Qwen Code as an MCP server.
 
 ## Quickstart
 
-1. **Sign up** at [fierce-philanthropy-directory.laravel.cloud/contribute](https://fierce-philanthropy-directory.laravel.cloud/contribute) (GitHub OAuth, free) and copy your API key.
+1. **Sign up** at [tokensforgood.ai/contribute](https://tokensforgood.ai/contribute) (GitHub OAuth, free) and copy your API key.
 2. **Run init in your terminal:**
 
    ```bash
@@ -58,9 +58,14 @@ Once installed, these are available to your AI via the MCP server:
 ## Non-Claude-Code platforms
 
 - **OpenCode** — `init` writes `~/.config/opencode/opencode.json` and prints a cron line you can paste into `crontab -e`.
+- **Qwen Code** — `init` writes `~/.qwen/settings.json` (preserving other keys) plus a `/tfg` slash command at `~/.qwen/commands/tfg.md`. For recurring runs, enable Qwen Code's experimental cron (`QWEN_CODE_ENABLE_CRON=1`) or use a system cron line.
 - **Cursor / Windsurf / Devin** — `init` writes the MCP config; automation requires platform-native scheduling.
 
-## Development
+## Contributing
+
+TFG has been built and tested primarily on **Claude Code**. Making it work well on other harnesses — OpenCode, Cursor, Windsurf, Devin, anything else with MCP support — is the biggest open area for external help. See [CONTRIBUTING.md](CONTRIBUTING.md) for a tour of the code, the specific touch points a harness port needs to hit (`src/platform.js`, `src/init.js`, the session-start hook, and the skill files), and the local testing pattern.
+
+For quick dev setup:
 
 ```bash
 git clone https://github.com/Tokens-for-Good/tokens-for-good

package/package.json

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

package/pipeline/01-research/PROMPT.md

@@ -53,8 +53,19 @@ List the top 20 negative consequences of that social problem for that population
 #### PROMPT 3 — Intermediary vs Ultimate Outcome Classification
 
 Keep all 20 items. Add a column classifying each as Intermediary or Ultimate Outcome.
-- **Intermediary:** changes in behavior or action from gains in knowledge, skills, or attitudes
-- **Ultimate:** changes in condition or life status (reduced poverty, improved health, economic stability)
+
+**Definitions:**
+- **Intermediary:** changes in behavior, action, or resources that result from the intervention but don't yet prove lives improved (e.g., increased income, employment, school enrollment, access to healthcare, consumption)
+- **Ultimate:** changes in condition or life status that directly reflect well-being improvements (e.g., improved health, housing security, quality of life, food security)
+
+**Edge cases — apply these exactly:**
+- Getting healthcare = Intermediary. Health actually improving = Ultimate.
+- Income going up = Intermediary. Using that income to improve housing, education, or health = Ultimate.
+- Moving out of poverty = Intermediary. Well-being or quality of life improving because of it = Ultimate.
+- Increased farm yield = Intermediary. Enhanced food security = Ultimate.
+- Increased access to most anything = Intermediary (we don't know if life improved because of that access).
+- School learning outcomes or completing school = Intermediary. Quality of life changing due to a better job from those outcomes = Ultimate.
+- Asset changes = Intermediary unless we know specifically what the asset is and how it improves life (safer housing, a latrine, durable productive tools = Ultimate; generic "asset score" or "asset holdings" = Intermediary).
 
 Sort by Intermediary first, then Ultimate.
 
@@ -83,36 +94,33 @@ Keep the table with ALL previous columns. For each of the 20 negative consequenc
 
 Write a recommendation (2-4 sentences): lead with stance, state strongest evidence, note caveats if any.
 
-Then include this scored checklist. Base score is out of 100. Counterfactuals are extra credit (max 120).
+**Section 2 — Scorecard**
 
-Base score (out of 100):
 - [x] or [ ] a. Has Ultimate Outcome Goals (50 pts)
 - [x] or [ ] b. Measures Intermediate Outcomes (10 pts)
 - [x] or [ ] c. Measures Ultimate Outcomes (15 pts)
 - [x] or [ ] d. Shows Continual Learning & Adaptation (25 pts)
-
-Extra credit:
 - [x] or [ ] e. Measures Intermediate Counterfactual (10 pts)
 - [x] or [ ] f. Measures Ultimate Counterfactual (10 pts)
 
-**Score: [X]/100** (can exceed 100 with extra credit, max 120)
+**Score: [X]/120**
 
-**Section 2 — The Social Problem**
+**Section 3 — The Social Problem**
 Frame with specificity ("chronic malnutrition among children under 5 in rural sub-Saharan Africa", not just "poverty"). Include scale and cite prevalence data.
 
-**Section 3 — The Solution**
+**Section 4 — The Solution**
 What the organization actually does (not their mission statement). Explain the theory of change: how does activity X lead to outcome Y? Be specific about the intervention.
 
-**Section 4 — Key Outputs**
+**Section 5 — Key Outputs**
 Measured activities and direct products with specific numbers. Distinguish outputs (things produced) from outcomes (changes caused).
 
-**Section 5 — Key Intermediate Outcomes**
+**Section 6 — Key Intermediate Outcomes**
 Measurable short-to-medium term changes. Note whether data is self-reported or independently verified. Include any counterfactual data found.
 
-**Section 6 — Key Ultimate Outcomes**
+**Section 7 — Key Ultimate Outcomes**
 Long-term impact evidence only. This section may be thin. Do not pad it. If no ultimate outcome data exists, say so in one sentence.
 
-**Section 7 — Continual Learning & Adaptation**
+**Section 8 — Continual Learning & Adaptation**
 Documented program changes based on evidence. "They adapted" needs specifics: what changed, based on what data, when?
 
 #### SOURCES
@@ -147,7 +155,7 @@ Run these checks before submitting. They are not optional.
 
 **Structure:**
 - [ ] All 5 prompt tables present and complete (20 rows each)
-- [ ] All 7 summary sections present with substantive content
+- [ ] All 8 summary sections present with substantive content
 - [ ] SOURCES section lists every URL cited inline
 - [ ] Scored checklist adds up correctly
 
@@ -164,6 +172,7 @@ Run these checks before submitting. They are not optional.
 - [ ] Replace "leverage" with "use", "utilize" with "use"
 - [ ] Paragraphs under 4 sentences
 - [ ] No superlatives unless backed by comparative data
+- [ ] Every acronym defined in full before first use (e.g., "Randomized Controlled Trial (RCT)" not just "RCT")
 
 ### 5. Submit
 

package/pipeline/04-peer-review/PROMPT.md

@@ -31,7 +31,7 @@ Pick 3-5 citation URLs from the report (prioritize any flagged by the automated
 
 Verify:
 - [ ] All 5 prompt sections present (PROMPT 1-5) with 20 rows each
-- [ ] All 7 summary sections present (Sections 1-7)
+- [ ] All 8 summary sections present (Sections 1-8)
 - [ ] SOURCES section exists with citations
 - [ ] Every factual claim has its own inline citation `[Source Name](URL)`
 - [ ] No claims cited to general overview pages when a specific report or data page exists
@@ -40,17 +40,14 @@ Verify:
 
 The scored checklist uses these weights. Verify the math and the evidence:
 
-Base score (out of 100):
 - a. Has Ultimate Outcome Goals (50 pts)
 - b. Measures Intermediate Outcomes (10 pts)
 - c. Measures Ultimate Outcomes (15 pts)
 - d. Shows Continual Learning & Adaptation (25 pts)
-
-Extra credit:
 - e. Measures Intermediate Counterfactual (10 pts)
 - f. Measures Ultimate Counterfactual (10 pts)
 
-**Score: X/100** (can exceed 100 with extra credit, max 120)
+**Score: X/120**
 
 Check:
 - Are checked items supported by evidence in the report?
@@ -65,6 +62,7 @@ Check:
 - Sections that are empty or trivially short
 - Claims that contradict other parts of the report
 - Em dashes, filler adjectives (robust, comprehensive, innovative), AI transitions
+- Acronyms used before being defined in full (e.g., "RCT" without first writing "Randomized Controlled Trial (RCT)")
 
 ### 7. Assign a Score
 

package/src/api-client.js

@@ -1,12 +1,12 @@
 // HTTP client for the Fierce Philanthropy coordination API
 
-const BASE_URL = process.env.FIERCE_API_URL || 'https://fierce-philanthropy-directory.laravel.cloud/api';
+const BASE_URL = process.env.FIERCE_API_URL || 'https://tokensforgood.ai/api';
 
 export class ApiClient {
   constructor(apiKey) {
     this.apiKey = apiKey;
     if (!apiKey) {
-      throw new Error('TFG_API_KEY environment variable is required. Get your key at https://fierce-philanthropy-directory.laravel.cloud/contribute');
+      throw new Error('TFG_API_KEY environment variable is required. Get your key at https://tokensforgood.ai/contribute');
     }
   }
 

package/src/cli.js

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
+#!/usr/bin/env node
 
 // CLI entry point for tokens-for-good.
 // Usage:

package/src/init.js

@@ -28,6 +28,7 @@ const PLATFORM_CHOICES = [
   { title: 'Cursor',       value: 'cursor' },
   { title: 'Windsurf',     value: 'windsurf' },
   { title: 'Devin',        value: 'devin' },
+  { title: 'Qwen Code',    value: 'qwen-code' },
 ];
 
 const onCancel = () => {
@@ -57,7 +58,7 @@ export async function runInit() {
   const { apiKey } = await prompts({
     type: 'password',
     name: 'apiKey',
-    message: 'Paste your TFG API key (get one at https://fierce-philanthropy-directory.laravel.cloud/contribute):',
+    message: 'Paste your TFG API key (get one at https://tokensforgood.ai/contribute):',
     validate: v => /^tfg_(live|test)_/.test((v || '').trim()) || 'Key should start with tfg_live_ or tfg_test_',
   }, { onCancel });
 
@@ -110,6 +111,9 @@ export async function runInit() {
     console.log(`✓ ${plans[2].label}`);
     writeSkillFile('tfg');
     console.log(`✓ ${plans[3].label}`);
+  } else if (platform === 'qwen-code') {
+    writeQwenCommand('tfg');
+    console.log(`✓ ${plans[1].label}`);
   }
 
   saveState({
@@ -137,6 +141,8 @@ function planWrites(platform) {
     plans.push({ label: `${settingsPath()}  (SessionStart hook)` });
     plans.push({ label: `${skillPath('tfg-schedule')}  (/tfg-schedule skill)` });
     plans.push({ label: `${skillPath('tfg')}  (/tfg skill)` });
+  } else if (platform === 'qwen-code') {
+    plans.push({ label: `${qwenCommandPath('tfg')}  (/tfg slash command)` });
   }
   plans.push({ label: `${statePath()}  (recorded choice)` });
   return plans;
@@ -149,32 +155,28 @@ function homeRelative(abs) {
 }
 
 function mcpConfigPath(platform) {
-  const abs = (() => {
-    switch (platform) {
-      case 'opencode':
-        return join(homedir(), '.config', 'opencode', 'opencode.json');
-      case 'cursor':
-        return join(process.cwd(), '.cursor', 'mcp.json');
-      case 'windsurf':
-        return join(homedir(), '.codeium', 'windsurf', 'mcp_config.json');
-      case 'devin':
-      case 'claude-code':
-      default:
-        return join(homedir(), '.mcp.json');
-    }
-  })();
-  return homeRelative(abs);
+  return homeRelative(absoluteMcpPath(platform));
 }
 
-function settingsPath()  { return homeRelative(join(homedir(), '.claude', 'settings.json')); }
-function skillPath(name) { return homeRelative(join(homedir(), '.claude', 'skills', name, 'SKILL.md')); }
-function statePath()     { return homeRelative(join(homedir(), '.tokens-for-good', 'state.json')); }
+function settingsPath()         { return homeRelative(join(homedir(), '.claude', 'settings.json')); }
+function skillPath(name)        { return homeRelative(join(homedir(), '.claude', 'skills', name, 'SKILL.md')); }
+function qwenCommandPath(name)  { return homeRelative(join(homedir(), '.qwen', 'commands', `${name}.md`)); }
+function statePath()            { return homeRelative(join(homedir(), '.tokens-for-good', 'state.json')); }
 
 // --- File writers ---
 
 function readJsonOrEmpty(path) {
   if (!existsSync(path)) return {};
-  try { return JSON.parse(readFileSync(path, 'utf-8')); } catch { return {}; }
+  const raw = readFileSync(path, 'utf-8');
+  try {
+    return JSON.parse(raw);
+  } catch {
+    throw new Error(
+      `${path} exists but is not valid JSON.\n` +
+      `Fix or delete the file, then re-run init.\n` +
+      `(Tip: paste it into https://jsonlint.com to find the syntax error.)`
+    );
+  }
 }
 
 function ensureDir(path) {
@@ -219,6 +221,8 @@ function absoluteMcpPath(platform) {
       return join(process.cwd(), '.cursor', 'mcp.json');
     case 'windsurf':
       return join(homedir(), '.codeium', 'windsurf', 'mcp_config.json');
+    case 'qwen-code':
+      return join(homedir(), '.qwen', 'settings.json');
     case 'devin':
     case 'claude-code':
     default:
@@ -284,6 +288,16 @@ function writeSkillFile(name) {
   writeFileSync(dst, readFileSync(src, 'utf-8'), 'utf-8');
 }
 
+// Qwen Code uses Gemini CLI's custom-command format: one .md per command at
+// ~/.qwen/commands/<name>.md. YAML frontmatter is supported; the body is the
+// command prompt. Our existing skill body works as-is.
+function writeQwenCommand(name) {
+  const src = join(PKG_ROOT, 'skills', `${name}.md`);
+  const dst = join(homedir(), '.qwen', 'commands', `${name}.md`);
+  ensureDir(dst);
+  writeFileSync(dst, readFileSync(src, 'utf-8'), 'utf-8');
+}
+
 // --- Closing guidance ---
 
 function printClosingGuidance(platform, flow, freq) {
@@ -300,13 +314,25 @@ function printClosingGuidance(platform, flow, freq) {
     if (flow === 'scheduled') {
       console.log(`MCP config written to ${mcpConfigPath('opencode')}.\n`);
       console.log('To run on a schedule, add this to your crontab (crontab -e):');
-      const cron = freq === 'hourly' ? '0 * * * *' : freq === 'weekly' ? '0 2 * * 1' : '0 2 * * *';
-      console.log(`  ${cron} cd /path/to/workspace && opencode run "Research a nonprofit org for Fierce Philanthropy using the tokens-for-good MCP tools."\n`);
+      console.log(`  ${cronExpression(freq)} cd /path/to/workspace && opencode run "Research a nonprofit org for Fierce Philanthropy using the tokens-for-good MCP tools."\n`);
     } else {
       console.log('MCP config written. In OpenCode run: "Research a nonprofit org for Fierce Philanthropy."\n');
     }
     return;
   }
+  if (platform === 'qwen-code') {
+    console.log(`MCP config written to ${mcpConfigPath('qwen-code')}.`);
+    console.log(`Slash command written to ${qwenCommandPath('tfg')}.`);
+    console.log('Restart Qwen Code, then run `/tfg` to research one org.');
+    if (flow === 'scheduled') {
+      console.log('\nFor recurring runs, either:');
+      console.log('  • Enable Qwen Code\'s experimental cron (set QWEN_CODE_ENABLE_CRON=1 and use the Cron tool / /loop), or');
+      console.log('  • Add a system cron line (crontab -e):');
+      console.log(`      ${cronExpression(freq)} cd /path/to/workspace && qwen --prompt "Run /tfg"`);
+    }
+    console.log('');
+    return;
+  }
   // cursor, windsurf, devin
   console.log(`MCP config written to ${mcpConfigPath(platform)}.`);
   console.log(`Restart ${platform} and run: "Research a nonprofit org for Fierce Philanthropy."`);
@@ -315,3 +341,9 @@ function printClosingGuidance(platform, flow, freq) {
   }
   console.log('');
 }
+
+function cronExpression(freq) {
+  if (freq === 'hourly') return '0 * * * *';
+  if (freq === 'weekly') return '0 2 * * 1';
+  return '0 2 * * *';
+}

package/src/mcp-server.js

@@ -1,351 +1,356 @@
-#!/usr/bin/env node
-import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
-import { z } from 'zod';
-import { ApiClient } from './api-client.js';
-import { detectPlatform, isSchedulable, getAutomationInstructions } from './platform.js';
-import { loadState, updateState, isSnoozed, hasContributedToday, markContributed, markSetupComplete } from './state.js';
-import { readFileSync, existsSync } from 'fs';
-import { join, dirname } from 'path';
-import { fileURLToPath } from 'url';
-import { homedir } from 'os';
-
-const __dirname = dirname(fileURLToPath(import.meta.url));
-const PIPELINE_DIR = join(__dirname, '..', 'pipeline');
-const PKG_VERSION = JSON.parse(readFileSync(join(__dirname, '..', 'package.json'), 'utf-8')).version;
-const STATE_FILE = join(homedir(), '.tokens-for-good', 'state.json');
-
-const INIT_GUARD_MESSAGE = `Tokens for Good setup isn't complete on this machine yet.
-
-Tell the user to run this in their terminal (not in Claude), then restart Claude Code:
-
-  npx tokens-for-good init
-
-The init command asks them to choose a contribution cadence (hourly / daily / weekly / one-off) and wires up everything else automatically. It takes about 30 seconds.`;
-
-// Gate: only fires for genuinely cold installs where state.json is missing
-// entirely. Existing users — including those on the pre-0.4.0 schema — pass
-// through untouched. Init writes state.json on first successful completion,
-// so after that this never fires again.
-function notInitialized() {
-  return !existsSync(STATE_FILE);
-}
-
-const apiKey = process.env.TFG_API_KEY;
-let client;
-try {
-  client = new ApiClient(apiKey);
-} catch {
-  // Will fail on tool calls, but server can still start
-  client = null;
-}
-
-const platform = detectPlatform();
-updateState({ platform });
-
-const server = new McpServer({
-  name: 'tokens-for-good',
-  version: PKG_VERSION,
-});
-
-// --- No-key onboarding message ---
-
-const NO_KEY_INSTRUCTIONS = `The user wants to set up Tokens for Good. Tell them to run this in their terminal (not here in Claude), then restart Claude Code:
-
-  npx tokens-for-good init
-
-The command walks them through everything in under a minute:
-1. Create an account at https://fierce-philanthropy-directory.laravel.cloud/contribute (GitHub OAuth, free)
-2. Copy their API key (starts with \`tfg_live_\`) and paste it into the init prompt
-3. Pick a cadence: **daily** (recommended), weekly, hourly, or one-off
-4. Confirm
-
-init writes everything — MCP config, SessionStart hook, /tfg and /tfg-schedule skills, and their recorded preference — in one shot. The first Claude Code session after init runs their chosen flow automatically.
-
-**What is Tokens for Good?** A way for developers to donate their spare AI subscription tokens to research nonprofit organizations for Fierce Philanthropy's social impact directory. Each org takes ~5 minutes and ~$0.20 in tokens. Contributors get credit on a public leaderboard.`;
-
-// --- Resources ---
-
-server.resource('about', 'tokens-for-good://about', 'text/plain', async () => ({
-  contents: [{
-    uri: 'tokens-for-good://about',
-    text: `Tokens for Good - Donate Your Spare AI Tokens to Research Nonprofits
-
-What: An MCP server that lets AI coding tool users (Claude Code, Opencode, Cursor, Windsurf, Devin) contribute their spare subscription tokens to research nonprofit organizations for Fierce Philanthropy's social impact directory.
-
-How it works:
-1. Sign up at https://fierce-philanthropy-directory.laravel.cloud/contribute (GitHub OAuth)
-2. Get your API key, add it to your MCP config as TFG_API_KEY
-3. Say "Research an org for Fierce Philanthropy"
-4. Your AI claims an org, researches it (web search + analysis), verifies citations, humanizes the writing, and submits the report
-5. Another contributor's AI peer-reviews your report
-6. A human reviewer finalizes it for the directory
-
-Research pipeline (per org, all done by your AI):
-- Research the org using web search + web fetch, following the 6-prompt methodology
-- Score using a weighted checklist (100 pts base, 120 max with extra credit)
-- Verify citations by visiting each URL before submitting
-- Clean up writing style (no AI tells, no filler adjectives, no em dashes)
-
-Contributor tiers:
-- New: first 5 orgs, easy orgs only
-- Bronze: 5+ orgs
-- Silver: 25+ orgs, >80% acceptance rate
-- Gold: 100+ orgs, >90% acceptance rate
-
-Automation: On Claude Code, use /schedule to auto-contribute daily. On Opencode, set up a system cron. On Cursor/Windsurf, contribute manually when prompted.
-
-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.', {
-  platform: z.string().optional().describe('Your platform (claude-code, opencode, cursor, windsurf, devin)'),
-}, async ({ platform: plat }) => {
-  if (notInitialized()) return { content: [{ type: 'text', text: INIT_GUARD_MESSAGE }] };
-  if (!client) return { content: [{ type: 'text', text: 'Error: TFG_API_KEY not set. Get your key at https://fierce-philanthropy-directory.laravel.cloud/contribute' }] };
-
-  try {
-    const result = await client.claimOrg(plat || platform);
-    return {
-      content: [{ type: 'text', text: `Claimed: ${result.org.name}\nURL: ${result.org.url}\nDescription: ${result.org.description || 'N/A'}\nSource: ${result.org.source || 'N/A'}\nClaim ID: ${result.claim_id}\nExpires: ${result.expires_at}\n\nNext steps:\n1. Call get_methodology with step="research" to get the full research instructions\n2. Follow the methodology to research this org using WebSearch and WebFetch\n3. The methodology includes citation verification and writing quality checks — complete them before submitting\n4. Submit with submit_report when done` }],
-    };
-  } catch (err) {
-    return { content: [{ type: 'text', text: `Error: ${err.message}` }] };
-  }
-});
-
-server.tool('get_methodology', 'Get the full research methodology, verification instructions, or humanization instructions.', {
-  step: z.enum(['research', 'verify', 'humanize', 'peer-review']).describe('Which pipeline step to get instructions for'),
-}, async ({ step }) => {
-  const stepMap = {
-    'research': '01-research/PROMPT.md',
-    'verify': '02-verify/PROMPT.md',
-    'humanize': '03-humanize/PROMPT.md',
-    'peer-review': '04-peer-review/PROMPT.md',
-  };
-
-  try {
-    const content = readFileSync(join(PIPELINE_DIR, stepMap[step]), 'utf-8');
-    return { content: [{ type: 'text', text: content }] };
-  } catch {
-    return { content: [{ type: 'text', text: `Error: Could not load ${step} methodology file.` }] };
-  }
-});
-
-server.tool('submit_report', 'Submit a completed research report for an org you claimed. You MUST include estimated_tokens.', {
-  claim_id: z.string().describe('The claim ID from claim_org'),
-  report_markdown: z.string().describe('The full research report in markdown'),
-  estimated_tokens: z.number().describe('Estimated total tokens used: count web searches (~1K each), web fetches (~2-5K each), report output (~4 tokens/word), plus ~10K overhead'),
-  model_used: z.string().optional().describe('The model that generated this report'),
-}, async ({ claim_id, report_markdown, estimated_tokens, model_used }) => {
-  if (!client) return { content: [{ type: 'text', text: 'Error: TFG_API_KEY not set.' }] };
-
-  try {
-    const result = await client.submitReport(claim_id, report_markdown, null, null, model_used, PKG_VERSION);
-    markContributed();
-
-    // One-off users: first successful submit completes their initial setup,
-    // so the SessionStart hook stops prompting from the next session onward.
-    const state = loadState();
-    if (state.intended_flow === 'one_off' && !state.first_setup_complete) {
-      markSetupComplete();
-    }
-
-    return {
-      content: [{ type: 'text', text: `Report submitted for ${result.org_name}!\n\nYour stats:\n- Total orgs: ${result.contributor_stats.total_orgs}\n- Tier: ${result.contributor_stats.tier}\n- Orgs remaining: ${result.orgs_remaining}\n\nYour report will now go through peer review. Thank you for contributing!` }],
-    };
-  } catch (err) {
-    return { content: [{ type: 'text', text: `Submit error: ${err.message}${err.data?.validation_errors ? '\n' + err.data.validation_errors.join('\n') : ''}` }] };
-  }
-});
-
-server.tool('get_peer_review', 'Get a draft report assigned to you for peer review. You must complete peer reviews before claiming new orgs.', {}, async () => {
-  if (!client) return { content: [{ type: 'text', text: 'Error: TFG_API_KEY not set.' }] };
-
-  try {
-    const result = await client.getNextPeerReview();
-    let peerMethodology = '';
-    try {
-      peerMethodology = readFileSync(join(PIPELINE_DIR, '04-peer-review/PROMPT.md'), 'utf-8');
-    } catch {
-      peerMethodology = 'Score 1-4: 4=Great, 3=Good with fixes (submit corrected version), 2=Needs redo, 1=Bad actor.';
-    }
-    let factCheckNote = '';
-    if (result.automated_review?.summary) {
-      const s = result.automated_review.summary;
-      const lines = [
-        `\n\n## Automated Fact-Check Results`,
-        `Quality: ${s.overall_quality} | Fact support: ${Math.round(s.fact_support_rate * 100)}% | Avg trust: ${Math.round(s.avg_trust_score * 100)}%`,
-        `Facts checked: ${result.automated_review.facts_checked}/${result.automated_review.facts_extracted} | Citations rated: ${result.automated_review.citations_rated}`,
-      ];
-      if (s.red_flags?.length > 0) {
-        lines.push(`\nRed flags:\n${s.red_flags.map(f => `  - ${f}`).join('\n')}`);
-      }
-      if (s.strengths?.length > 0) {
-        lines.push(`\nStrengths:\n${s.strengths.map(f => `  - ${f}`).join('\n')}`);
-      }
-      lines.push(`\nUse these results to focus your spot-checks on flagged areas.`);
-      factCheckNote = lines.join('\n');
-    } else if (result.automated_review) {
-      factCheckNote = `\n\nAutomated Fact-Check: ${result.automated_review.status} (no summary available yet)`;
-    }
-    return {
-      content: [{ type: 'text', text: `Peer review assigned:\nOrg: ${result.org.name}\nAuthor: ${result.author}\nClaim ID: ${result.claim_id}${factCheckNote}\n\n---\n\n${peerMethodology}\n\n---\n\n${result.report_markdown}\n\n---\n\nUse submit_peer_review with your score and notes.` }],
-    };
-  } catch (err) {
-    if (err.status === 404) {
-      return { content: [{ type: 'text', text: 'No peer reviews assigned to you right now.' }] };
-    }
-    return { content: [{ type: 'text', text: `Error: ${err.message}` }] };
-  }
-});
-
-server.tool('submit_peer_review', 'Submit your peer review score for a report.', {
-  claim_id: z.string().describe('The claim ID of the report being reviewed'),
-  score: z.number().min(1).max(4).describe('Score: 4=great, 3=good with fixes, 2=needs redo, 1=bad actor'),
-  notes: z.string().optional().describe('Review notes explaining the score'),
-  updated_report: z.string().optional().describe('If score is 3, the fixed version of the report'),
-}, async ({ claim_id, score, notes, updated_report }) => {
-  if (!client) return { content: [{ type: 'text', text: 'Error: TFG_API_KEY not set.' }] };
-
-  try {
-    const result = await client.submitPeerReview(claim_id, score, notes, updated_report);
-    return {
-      content: [{ type: 'text', text: `Peer review submitted for ${result.org_name}.\nScore: ${result.score}/4\n\nYou can now claim a new org to research.` }],
-    };
-  } catch (err) {
-    return { content: [{ type: 'text', text: `Error: ${err.message}` }] };
-  }
-});
-
-server.tool('research_status', 'See the overall Tokens for Good project progress and leaderboard.', {}, async () => {
-  try {
-    const clientForStatus = client || new ApiClient('dummy'); // Status is public
-    const result = await clientForStatus.getStatus();
-    const topList = result.top_contributors?.map((c, i) =>
-      `${i + 1}. @${c.github_handle} (${c.total_orgs} orgs, ${c.tier})`
-    ).join('\n') || 'No contributors yet';
-
-    return {
-      content: [{ type: 'text', text: `Tokens for Good Progress:\n\nTotal orgs: ${result.total_orgs}\nPending research: ${result.pending_orgs}\nActive contributors (7d): ${result.active_contributors_7d}\n\nQueue:\n${Object.entries(result.queue || {}).map(([k, v]) => `  ${k}: ${v}`).join('\n')}\n\nTop Contributors:\n${topList}` }],
-    };
-  } catch (err) {
-    return { content: [{ type: 'text', text: `Error: ${err.message}` }] };
-  }
-});
-
-server.tool('my_impact', 'See your personal contribution stats, tier, and history.', {}, 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 estimatedCost = (c.total_tokens / 1_000_000 * 3).toFixed(2);
-
-    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'}` }],
-    };
-  } 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 }] };
-});
-
-server.tool('setup_automation', 'Get the scheduled-research prompt + setup instructions for the user\'s platform. Usually called by the /tfg-schedule skill (which extracts the prompt and invokes /schedule). Safe to call directly too — returns human-readable instructions.', {
-  frequency: z.enum(['hourly', 'daily', 'weekly']).optional().describe('How often to contribute'),
-}, async ({ frequency }) => {
-  if (notInitialized()) return { content: [{ type: 'text', text: INIT_GUARD_MESSAGE }] };
-  const instructions = getAutomationInstructions(platform, frequency || 'daily', apiKey);
-  return { content: [{ type: 'text', text: instructions }] };
-});
-
-server.tool('mark_setup_complete', 'Called by the /tfg-schedule skill after /schedule confirms, or by the /tfg skill after a successful first submission. Flips local state so the SessionStart hook stops emitting first-session instructions. Idempotent — safe to call multiple times.', {}, async () => {
-  markSetupComplete();
-  return { content: [{ type: 'text', text: 'Marked setup complete. The SessionStart hook will go silent from the next session.' }] };
-});
-
-// --- Prompts (session start) ---
-
-server.prompt('session_start', 'Check if you should research an org or complete a peer review', {}, async () => {
-  // No API key -- guide through setup
-  if (!client) {
-    return {
-      messages: [{
-        role: 'user',
-        content: { type: 'text', text: NO_KEY_INSTRUCTIONS },
-      }],
-    };
-  }
-
-  const state = loadState();
-
-  // Check for pending peer review first
-  if (client) {
-    try {
-      const review = await client.getNextPeerReview();
-      return {
-        messages: [{
-          role: 'user',
-          content: { type: 'text', text: `You have a pending peer review to complete before you can claim a new org. Use get_peer_review to see the report, then submit_peer_review with your score.` },
-        }],
-      };
-    } catch {
-      // No pending review, continue
-    }
-  }
-
-  if (isSnoozed()) {
-    return { messages: [{ role: 'user', content: { type: 'text', text: 'Tokens for Good is snoozed. No action needed.' } }] };
-  }
-
-  if (state.auto_schedule) {
-    try {
-      const impact = await client?.getImpact();
-      const c = impact?.contributor;
-      return {
-        messages: [{
-          role: 'user',
-          content: { type: 'text', text: `Tokens for Good: You're auto-contributing. ${c?.total_orgs || 0} orgs researched so far. Tier: ${c?.tier || 'new'}.` },
-        }],
-      };
-    } catch {
-      return { messages: [{ role: 'user', content: { type: 'text', text: 'Tokens for Good: Auto-contributions active.' } }] };
-    }
-  }
-
-  if (hasContributedToday()) {
-    return { messages: [{ role: 'user', content: { type: 'text', text: 'Tokens for Good: You already contributed today. Nice work!' } }] };
-  }
-
-  // Show the session start prompt
-  if (isSchedulable(platform)) {
-    return {
-      messages: [{
-        role: 'user',
-        content: { type: 'text', text: `Tokens for Good: Would you like to donate your spare tokens to research a nonprofit today?\n\n1. Set up automatic daily contributions (recommended) — run /tfg-schedule\n2. Just run one now — run /tfg\n3. Ask me tomorrow\n4. Ask me in a week` },
-      }],
-    };
-  } else {
-    return {
-      messages: [{
-        role: 'user',
-        content: { type: 'text', text: `Tokens for Good: Would you like to research a nonprofit org today? It takes about 5 minutes and costs ~$0.20 in tokens.\n\n1. Research an org now\n2. Ask me tomorrow\n3. Ask me in a week\n\nUse claim_org for option 1.` },
-      }],
-    };
-  }
-});
-
-// --- Start ---
-
-async function main() {
-  const transport = new StdioServerTransport();
-  await server.connect(transport);
-}
-
-main().catch(console.error);
+#!/usr/bin/env node
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { z } from 'zod';
+import { ApiClient } from './api-client.js';
+import { detectPlatform, isSchedulable, getAutomationInstructions } from './platform.js';
+import { loadState, updateState, isSnoozed, snoozeDays, hasContributedToday, markContributed, markSetupComplete } from './state.js';
+import { readFileSync, existsSync } from 'fs';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+import { homedir } from 'os';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const PIPELINE_DIR = join(__dirname, '..', 'pipeline');
+const PKG_VERSION = JSON.parse(readFileSync(join(__dirname, '..', 'package.json'), 'utf-8')).version;
+const STATE_FILE = join(homedir(), '.tokens-for-good', 'state.json');
+
+const INIT_GUARD_MESSAGE = `Tokens for Good setup isn't complete on this machine yet.
+
+Tell the user to run this in their terminal (not in Claude), then restart Claude Code:
+
+  npx tokens-for-good init
+
+The init command asks them to choose a contribution cadence (hourly / daily / weekly / one-off) and wires up everything else automatically. It takes about 30 seconds.`;
+
+// Gate: only fires for genuinely cold installs where state.json is missing
+// entirely. Existing users — including those on the pre-0.4.0 schema — pass
+// through untouched. Init writes state.json on first successful completion,
+// so after that this never fires again.
+function notInitialized() {
+  return !existsSync(STATE_FILE);
+}
+
+const apiKey = process.env.TFG_API_KEY;
+let client;
+try {
+  client = new ApiClient(apiKey);
+} catch {
+  // Will fail on tool calls, but server can still start
+  client = null;
+}
+
+const platform = detectPlatform();
+updateState({ platform });
+
+const server = new McpServer({
+  name: 'tokens-for-good',
+  version: PKG_VERSION,
+});
+
+// --- No-key onboarding message ---
+
+const NO_KEY_INSTRUCTIONS = `The user wants to set up Tokens for Good. Tell them to run this in their terminal (not here in Claude), then restart Claude Code:
+
+  npx tokens-for-good init
+
+The command walks them through everything in under a minute:
+1. Create an account at https://tokensforgood.ai/contribute (GitHub OAuth, free)
+2. Copy their API key (starts with \`tfg_live_\`) and paste it into the init prompt
+3. Pick a cadence: **daily** (recommended), weekly, hourly, or one-off
+4. Confirm
+
+init writes everything — MCP config, SessionStart hook, /tfg and /tfg-schedule skills, and their recorded preference — in one shot. The first Claude Code session after init runs their chosen flow automatically.
+
+**What is Tokens for Good?** A way for developers to donate their spare AI subscription tokens to research nonprofit organizations for Fierce Philanthropy's social impact directory. Each org takes ~5 minutes and ~$0.20 in tokens. Contributors get credit on a public leaderboard.`;
+
+// --- Resources ---
+
+server.resource('about', 'tokens-for-good://about', 'text/plain', async () => ({
+  contents: [{
+    uri: 'tokens-for-good://about',
+    text: `Tokens for Good - Donate Your Spare AI Tokens to Research Nonprofits
+
+What: An MCP server that lets AI coding tool users (Claude Code, Opencode, Cursor, Windsurf, Devin) contribute their spare subscription tokens to research nonprofit organizations for Fierce Philanthropy's social impact directory.
+
+How it works:
+1. Sign up at https://tokensforgood.ai/contribute (GitHub OAuth)
+2. Get your API key, add it to your MCP config as TFG_API_KEY
+3. Say "Research an org for Fierce Philanthropy"
+4. Your AI claims an org, researches it (web search + analysis), verifies citations, humanizes the writing, and submits the report
+5. Another contributor's AI peer-reviews your report
+6. A human reviewer finalizes it for the directory
+
+Research pipeline (per org, all done by your AI):
+- Research the org using web search + web fetch, following the 6-prompt methodology
+- Score using a weighted checklist (100 pts base, 120 max with extra credit)
+- Verify citations by visiting each URL before submitting
+- Clean up writing style (no AI tells, no filler adjectives, no em dashes)
+
+Contributor tiers:
+- New: first 5 orgs, easy orgs only
+- Bronze: 5+ orgs
+- Silver: 25+ orgs, >80% acceptance rate
+- Gold: 100+ orgs, >90% acceptance rate
+
+Automation: On Claude Code, use /schedule to auto-contribute daily. On Opencode, set up a system cron. On Cursor/Windsurf, contribute manually when prompted.
+
+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.', {
+  platform: z.string().optional().describe('Your platform (claude-code, opencode, cursor, windsurf, devin)'),
+}, async ({ platform: plat }) => {
+  if (notInitialized()) return { content: [{ type: 'text', text: INIT_GUARD_MESSAGE }] };
+  if (!client) return { content: [{ type: 'text', text: 'Error: TFG_API_KEY not set. Get your key at https://tokensforgood.ai/contribute' }] };
+
+  try {
+    const result = await client.claimOrg(plat || platform);
+    return {
+      content: [{ type: 'text', text: `Claimed: ${result.org.name}\nURL: ${result.org.url}\nDescription: ${result.org.description || 'N/A'}\nSource: ${result.org.source || 'N/A'}\nClaim ID: ${result.claim_id}\nExpires: ${result.expires_at}\n\nNext steps:\n1. Call get_methodology with step="research" to get the full research instructions\n2. Follow the methodology to research this org using WebSearch and WebFetch\n3. The methodology includes citation verification and writing quality checks — complete them before submitting\n4. Submit with submit_report when done` }],
+    };
+  } catch (err) {
+    return { content: [{ type: 'text', text: `Error: ${err.message}` }] };
+  }
+});
+
+server.tool('get_methodology', 'Get the full research methodology, verification instructions, or humanization instructions.', {
+  step: z.enum(['research', 'verify', 'humanize', 'peer-review']).describe('Which pipeline step to get instructions for'),
+}, async ({ step }) => {
+  const stepMap = {
+    'research': '01-research/PROMPT.md',
+    'verify': '02-verify/PROMPT.md',
+    'humanize': '03-humanize/PROMPT.md',
+    'peer-review': '04-peer-review/PROMPT.md',
+  };
+
+  try {
+    const content = readFileSync(join(PIPELINE_DIR, stepMap[step]), 'utf-8');
+    return { content: [{ type: 'text', text: content }] };
+  } catch {
+    return { content: [{ type: 'text', text: `Error: Could not load ${step} methodology file.` }] };
+  }
+});
+
+server.tool('submit_report', 'Submit a completed research report for an org you claimed. You MUST include estimated_tokens.', {
+  claim_id: z.string().describe('The claim ID from claim_org'),
+  report_markdown: z.string().describe('The full research report in markdown'),
+  estimated_tokens: z.number().describe('Estimated total tokens used: count web searches (~1K each), web fetches (~2-5K each), report output (~4 tokens/word), plus ~10K overhead'),
+  model_used: z.string().optional().describe('The model that generated this report'),
+}, async ({ claim_id, report_markdown, estimated_tokens, model_used }) => {
+  if (!client) return { content: [{ type: 'text', text: 'Error: TFG_API_KEY not set.' }] };
+
+  try {
+    const result = await client.submitReport(claim_id, report_markdown, estimated_tokens, null, model_used, PKG_VERSION);
+    markContributed();
+
+    // One-off users: first successful submit completes their initial setup,
+    // so the SessionStart hook stops prompting from the next session onward.
+    const state = loadState();
+    if (state.intended_flow === 'one_off' && !state.first_setup_complete) {
+      markSetupComplete();
+    }
+
+    return {
+      content: [{ type: 'text', text: `Report submitted for ${result.org_name}!\n\nYour stats:\n- Total orgs: ${result.contributor_stats.total_orgs}\n- Tier: ${result.contributor_stats.tier}\n- Orgs remaining: ${result.orgs_remaining}\n\nYour report will now go through peer review. Thank you for contributing!` }],
+    };
+  } catch (err) {
+    return { content: [{ type: 'text', text: `Submit error: ${err.message}${err.data?.validation_errors ? '\n' + err.data.validation_errors.join('\n') : ''}` }] };
+  }
+});
+
+server.tool('get_peer_review', 'Get a draft report assigned to you for peer review. You must complete peer reviews before claiming new orgs.', {}, async () => {
+  if (!client) return { content: [{ type: 'text', text: 'Error: TFG_API_KEY not set.' }] };
+
+  try {
+    const result = await client.getNextPeerReview();
+    let peerMethodology = '';
+    try {
+      peerMethodology = readFileSync(join(PIPELINE_DIR, '04-peer-review/PROMPT.md'), 'utf-8');
+    } catch {
+      peerMethodology = 'Score 1-4: 4=Great, 3=Good with fixes (submit corrected version), 2=Needs redo, 1=Bad actor.';
+    }
+    let factCheckNote = '';
+    if (result.automated_review?.summary) {
+      const s = result.automated_review.summary;
+      const lines = [
+        `\n\n## Automated Fact-Check Results`,
+        `Quality: ${s.overall_quality} | Fact support: ${Math.round(s.fact_support_rate * 100)}% | Avg trust: ${Math.round(s.avg_trust_score * 100)}%`,
+        `Facts checked: ${result.automated_review.facts_checked}/${result.automated_review.facts_extracted} | Citations rated: ${result.automated_review.citations_rated}`,
+      ];
+      if (s.red_flags?.length > 0) {
+        lines.push(`\nRed flags:\n${s.red_flags.map(f => `  - ${f}`).join('\n')}`);
+      }
+      if (s.strengths?.length > 0) {
+        lines.push(`\nStrengths:\n${s.strengths.map(f => `  - ${f}`).join('\n')}`);
+      }
+      lines.push(`\nUse these results to focus your spot-checks on flagged areas.`);
+      factCheckNote = lines.join('\n');
+    } else if (result.automated_review) {
+      factCheckNote = `\n\nAutomated Fact-Check: ${result.automated_review.status} (no summary available yet)`;
+    }
+    return {
+      content: [{ type: 'text', text: `Peer review assigned:\nOrg: ${result.org.name}\nAuthor: ${result.author}\nClaim ID: ${result.claim_id}${factCheckNote}\n\n---\n\n${peerMethodology}\n\n---\n\n${result.report_markdown}\n\n---\n\nUse submit_peer_review with your score and notes.` }],
+    };
+  } catch (err) {
+    if (err.status === 404) {
+      return { content: [{ type: 'text', text: 'No peer reviews assigned to you right now.' }] };
+    }
+    return { content: [{ type: 'text', text: `Error: ${err.message}` }] };
+  }
+});
+
+server.tool('submit_peer_review', 'Submit your peer review score for a report.', {
+  claim_id: z.string().describe('The claim ID of the report being reviewed'),
+  score: z.number().int().min(1).max(4).describe('Score: 4=great, 3=good with fixes, 2=needs redo, 1=bad actor'),
+  notes: z.string().optional().describe('Review notes explaining the score'),
+  updated_report: z.string().optional().describe('If score is 3, the fixed version of the report'),
+}, async ({ claim_id, score, notes, updated_report }) => {
+  if (!client) return { content: [{ type: 'text', text: 'Error: TFG_API_KEY not set.' }] };
+
+  try {
+    const result = await client.submitPeerReview(claim_id, score, notes, updated_report);
+    return {
+      content: [{ type: 'text', text: `Peer review submitted for ${result.org_name}.\nScore: ${result.score}/4\n\nYou can now claim a new org to research.` }],
+    };
+  } catch (err) {
+    return { content: [{ type: 'text', text: `Error: ${err.message}` }] };
+  }
+});
+
+server.tool('research_status', 'See the overall Tokens for Good project progress and leaderboard.', {}, async () => {
+  try {
+    const clientForStatus = client || new ApiClient('dummy'); // Status is public
+    const result = await clientForStatus.getStatus();
+    const topList = result.top_contributors?.map((c, i) =>
+      `${i + 1}. @${c.github_handle} (${c.total_orgs} orgs, ${c.tier})`
+    ).join('\n') || 'No contributors yet';
+
+    return {
+      content: [{ type: 'text', text: `Tokens for Good Progress:\n\nTotal orgs: ${result.total_orgs}\nPending research: ${result.pending_orgs}\nActive contributors (7d): ${result.active_contributors_7d}\n\nQueue:\n${Object.entries(result.queue || {}).map(([k, v]) => `  ${k}: ${v}`).join('\n')}\n\nTop Contributors:\n${topList}` }],
+    };
+  } catch (err) {
+    return { content: [{ type: 'text', text: `Error: ${err.message}` }] };
+  }
+});
+
+server.tool('my_impact', 'See your personal contribution stats, tier, and history.', {}, 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 estimatedCost = (c.total_tokens / 1_000_000 * 3).toFixed(2);
+
+    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'}` }],
+    };
+  } 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 }] };
+});
+
+server.tool('setup_automation', 'Get the scheduled-research prompt + setup instructions for the user\'s platform. Usually called by the /tfg-schedule skill (which extracts the prompt and invokes /schedule). Safe to call directly too — returns human-readable instructions.', {
+  frequency: z.enum(['hourly', 'daily', 'weekly']).optional().describe('How often to contribute'),
+}, async ({ frequency }) => {
+  if (notInitialized()) return { content: [{ type: 'text', text: INIT_GUARD_MESSAGE }] };
+  const instructions = getAutomationInstructions(platform, frequency || 'daily', apiKey);
+  return { content: [{ type: 'text', text: instructions }] };
+});
+
+server.tool('mark_setup_complete', 'Called by the /tfg-schedule skill after /schedule confirms, or by the /tfg skill after a successful first submission. Flips local state so the SessionStart hook stops emitting first-session instructions. Idempotent — safe to call multiple times.', {}, async () => {
+  markSetupComplete();
+  return { content: [{ type: 'text', text: 'Marked setup complete. The SessionStart hook will go silent from the next session.' }] };
+});
+
+server.tool('snooze', 'Snooze Tokens for Good reminders. Call this when the user says to remind them tomorrow, next week, or in N days.', {
+  days: z.number().int().min(1).max(365).describe('Days to snooze (1 = tomorrow, 7 = next week)'),
+}, async ({ days }) => {
+  snoozeDays(days);
+  return { content: [{ type: 'text', text: `Got it — Tokens for Good will stay quiet for ${days} day${days === 1 ? '' : 's'}.` }] };
+});
+
+// --- Prompts (session start) ---
+
+server.prompt('session_start', 'Check if you should research an org or complete a peer review', {}, async () => {
+  // No API key -- guide through setup
+  if (!client) {
+    return {
+      messages: [{
+        role: 'user',
+        content: { type: 'text', text: NO_KEY_INSTRUCTIONS },
+      }],
+    };
+  }
+
+  const state = loadState();
+
+  // Check for pending peer review first
+  try {
+    await client.getNextPeerReview();
+    return {
+      messages: [{
+        role: 'user',
+        content: { type: 'text', text: `You have a pending peer review to complete before you can claim a new org. Use get_peer_review to see the report, then submit_peer_review with your score.` },
+      }],
+    };
+  } catch {
+    // No pending review, continue
+  }
+
+  if (isSnoozed()) {
+    return { messages: [{ role: 'user', content: { type: 'text', text: 'Tokens for Good is snoozed. No action needed.' } }] };
+  }
+
+  if (state.auto_schedule) {
+    try {
+      const impact = await client?.getImpact();
+      const c = impact?.contributor;
+      return {
+        messages: [{
+          role: 'user',
+          content: { type: 'text', text: `Tokens for Good: You're auto-contributing. ${c?.total_orgs || 0} orgs researched so far. Tier: ${c?.tier || 'new'}.` },
+        }],
+      };
+    } catch {
+      return { messages: [{ role: 'user', content: { type: 'text', text: 'Tokens for Good: Auto-contributions active.' } }] };
+    }
+  }
+
+  if (hasContributedToday()) {
+    return { messages: [{ role: 'user', content: { type: 'text', text: 'Tokens for Good: You already contributed today. Nice work!' } }] };
+  }
+
+  // Show the session start prompt
+  if (isSchedulable(platform)) {
+    return {
+      messages: [{
+        role: 'user',
+        content: { type: 'text', text: `Tokens for Good: Would you like to donate your spare tokens to research a nonprofit today?\n\n1. Set up automatic daily contributions (recommended) — run /tfg-schedule\n2. Just run one now — run /tfg\n3. Ask me tomorrow\n4. Ask me in a week` },
+      }],
+    };
+  } else {
+    return {
+      messages: [{
+        role: 'user',
+        content: { type: 'text', text: `Tokens for Good: Would you like to research a nonprofit org today? It takes about 5 minutes and costs ~$0.20 in tokens.\n\n1. Research an org now\n2. Ask me tomorrow\n3. Ask me in a week\n\nUse claim_org for option 1.` },
+      }],
+    };
+  }
+});
+
+// --- Start ---
+
+async function main() {
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+}
+
+main().catch(console.error);

package/src/platform.js

@@ -6,23 +6,26 @@ export function detectPlatform() {
   if (process.env.DEVIN) return 'devin';
   if (process.env.CURSOR_SESSION) return 'cursor';
   if (process.env.WINDSURF_SESSION) return 'windsurf';
+  // Qwen Code doesn't reliably export a parent-identifying env var, so we
+  // fall through to the parent-process heuristic for it.
 
   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';
+  if (parentName.includes('qwen')) return 'qwen-code';
 
   // Default to claude-code since it's the primary MCP host
   return 'claude-code';
 }
 
 export function isSchedulable(platform) {
-  return ['claude-code', 'opencode', 'devin'].includes(platform);
+  return ['claude-code', 'opencode', 'devin', 'qwen-code'].includes(platform);
 }
 
 export function getSchedulePrompt(apiKey) {
-  const base = 'https://fierce-philanthropy-directory.laravel.cloud/api';
+  const base = 'https://tokensforgood.ai/api';
   return `You are a research agent for Fierce Philanthropy's Tokens for Good program.
 
 ## Setup
@@ -74,6 +77,16 @@ Configure a ${frequency} recurring session with the prompt:
 
 Devin runs in the cloud, fully autonomous.`;
 
+    case 'qwen-code':
+      return `Set up automated contributions on Qwen Code.
+
+Qwen Code v0.14+ has experimental built-in cron — enable it with QWEN_CODE_ENABLE_CRON=1 (or "experimental.cron": true in ~/.qwen/settings.json) and then use the Cron tool / /loop skill.
+
+For a portable option, use a system cron job (add via crontab -e):
+${getCronExpression(frequency)} cd /path/to/workspace && qwen --prompt "Research a nonprofit org for Fierce Philanthropy using the tokens-for-good MCP tools. Claim an org, research it, then submit the report."
+
+Your machine must stay on for system cron to run.`;
+
     default:
       return getAutomationInstructions('claude-code', frequency, apiKey);
   }

package/src/state.js

@@ -78,6 +78,7 @@ export function markSetupComplete() {
   updateState({ first_setup_complete: true });
 }
 
+
 export function isInitialized() {
   const state = loadState();
   return state.intended_flow !== null;