FreeToken

项目介绍

FreeToken 是一个面向 ZCode、Claude Code、Codex、Cursor 等 AI Agent 的广告变现平台。 当 Agent 检测到模型 provider 余额不足或 token 用量过高时，自动引导用户通过看广告 / 做任务赚取积分， 积分可兑换成 provider token 额度。

• ✅ 多 Agent 通用 MCP server
• ✅ ZCode 每次对话自动检查余额
• ✅ 接入 Lootably / AdGate / AdGem
• ✅ 本地 SQLite 积分系统
• ✅ snooze 暂停提醒

安装 MCP Server

方式一：远程一键安装（推荐）

不需要先下载代码，一条命令自动完成下载、安装依赖、配置 Agent：

node -e "$(curl -fsSL https://raw.githubusercontent.com/kreator666/freetoken/main/install.js)"

Windows PowerShell：

(Invoke-WebRequest -Uri https://raw.githubusercontent.com/kreator666/freetoken/main/install.js -UseBasicParsing).Content | node -

方式二：已有代码配置

如果已经下载了 freetoken 代码，在项目目录内运行：

pnpm setup
# 或
node bin/freetoken.cjs setup

安装完成后，暴露的 tools： check_balance、get_earn_token_prompt、get_user_points、request_redeem、snooze_reminder、is_snoozed、open_offerwall。