GiveReady
官方搜索超过41,000个经过验证的非营利组织,涵盖29个公益领域,向简略档案提交补充信息,并通过x402 USDC进行捐赠,零平台费用。
你可以用 GiveReady MCP 做什么?
- 搜索非营利组织 — 让您的AI助手通过
search_nonprofits按事业领域、国家或关键词查找经过验证的青年非营利组织。 - 获取非营利组织详情 — 通过
get_nonprofit检索完整档案,包括项目、影响力指标和钱包地址。 - 列出事业领域 — 询问29个受支持的事业类别概览,以通过
list_causes缩小捐赠选项范围。 - 提交补充数据 — 通过
submit_enrichment工具请求添加或更新非营利组织信息。
文档
GiveReady
面向 AI 代理的开源基础设施,用于发现青少年非营利组织并直接向其捐款。无中间环节。无平台费用。非营利组织保留 100% 的捐款。
问题
每个捐赠平台——Every.org、The Giving Block、Endaoment——都是中间商。资金先流向它们。它们负责转换、路由,并从中抽成。对于开普敦、百慕大或内罗毕的小型青少年慈善机构来说,这一层增加了摩擦、费用和延迟,侵蚀了本已微薄的预算。
12 个月内,捐赠者不会再去网站捐款。他们会告诉 AI 助手“帮我找一个开普敦的青少年慈善机构,给他们转 20 美元。”代理需要结构化数据来找到合适的组织,以及支付通道来发送资金。现有平台无法同时提供这两者。
GiveReady 的职能
发现。 一个 MCP 服务器和 REST API 为 AI 代理提供对 41,000+ 个经认证的非营利组织的结构化访问,涵盖 29 个事业领域——包括项目、影响力指标、受益人群统计、捐赠链接以及可用的钱包地址。当 AI 代理需要寻找慈善机构时,它会查询 GiveReady。
直接支付。 x402 协议让 AI 代理直接将 USDC 发送到非营利组织自己的钱包。没有中间商持有资金。非营利组织从资金到达那一刻起就完全掌控。在 Solana 上不到一秒即可结算。
可嵌入的捐赠按钮。 每个入驻的非营利组织都会获得一个零依赖的 JavaScript 小部件,用于其网站。一个脚本标签即可。生成 Solana Pay 二维码或直接转账链接。捐赠者使用 Phantom 或 Coinbase Wallet 扫描。无需后端。无平台费用。
没有支付的发现只是搜索引擎。没有发现的支付只是钱包。没人能找到的捐赠按钮只是一个小部件。GiveReady 将三者合而为一。
为什么在美国/英国/欧盟之外很重要
传统捐赠平台通过美国支付基础设施路由。如果你在百慕大、非洲大部分地区、加勒比地区或东南亚进行银行业务,你要么被排除在外,要么支付转换费用,使小额捐赠变得毫无意义。
Solana 上的 USDC 在任何地方都可用。非营利组织只需要一部智能手机和一个钱包应用。接收资金零 KYC。如果需要,可通过本地交易所兑换为当地货币。这不仅仅是西方慈善机构的基础设施——它是任何国家任何非营利组织的基础设施。
架构
giveready/
├── src/
│ ├── index.js # Cloudflare Worker: API, pages, x402, admin, cron
│ ├── payable.js # Payability report for agents (/payable)
│ ├── wallet-proof.js # Ed25519 proof that a charity controls its wallet
│ └── wallet-proof-page.js # Signing page for the wallet proof
├── mcp-server/ # MCP server for AI agents (published as giveready-mcp)
├── public/ # Static assets served by the Worker
│ ├── widget/ # Embeddable donate button (zero dependencies)
│ ├── guides/ learn/ # Long-form guides, rendered from markdown
│ └── openapi.json # OpenAPI spec
├── migrations/ # Numbered D1 migrations, idempotent, run on deploy
├── tests/ # Node test runner suite (npm test, runs offline)
├── scripts/ # Data import, smoke tests and monitoring jobs
├── docs/ # Deploy notes, incident write-ups, design specs
├── test-client/ # x402 payment protocol test client
├── schema.sql # D1 database schema
├── seed.sql # Nonprofit seed data
├── deploy.sh # Test, tag, migrate, deploy (./deploy.sh)
└── wrangler.toml # Cloudflare Workers config
技术栈: Cloudflare Workers + D1 (SQLite) + Solana USDC + x402 协议 + 模型上下文协议 (MCP)
运行成本: Cloudflare 上约 5 美元/月。Coinbase 促进者免费层涵盖每月 1,000 笔交易。交易费用由捐赠者支付。
API 端点
| 端点 | 描述 |
|---|---|
GET /api/search?q=&cause=&country= | 搜索非营利组织 |
GET /api/nonprofits | 列出所有经认证的非营利组织 |
GET /api/nonprofits/:slug | 获取非营利组织详情 |
GET /api/causes | 列出事业领域 |
GET /api/stats | 目录统计 |
GET /api/donate/:slug?amount= | x402 捐赠(返回 402 及支付要求) |
POST /api/donate/:slug | 提交签名支付 |
GET /api/donations/:slug | 捐赠历史 |
GET /mcp | MCP 服务器清单 |
GET /.well-known/ai-plugin.json | AI 插件发现 |
GET /llms.txt | LLM 爬虫元数据 |
GET /agents.md | 代理发现指南 |
MCP 服务器
安装 MCP 服务器,让任何 AI 助手原生访问 GiveReady:
{
"mcpServers": {
"giveready": {
"command": "npx",
"args": ["giveready-mcp"]
}
}
}
工具:search_nonprofits、get_nonprofit、list_causes、submit_enrichment
捐赠小部件
用一行代码为任何非营利组织网站添加捐赠按钮:
<div id="giveready-donate" data-slug="your-nonprofit-slug"></div>
<script src="https://giveready.org/widget/donate.js"></script>
完整文档请参阅 public/widget/README.md。
运行自己的实例
git clone https://github.com/gswardman/giveready.git
cd giveready
npm install
wrangler d1 create giveready-db
# Copy database_id into wrangler.toml
wrangler d1 execute giveready-db --local --file=./schema.sql
wrangler d1 execute giveready-db --local --file=./seed.sql
npm run dev
完整生产部署说明请参阅 DEPLOY.md。
非营利组织入驻
完成列表只需不到 45 分钟:
- 设置钱包(3 分钟)——下载 Phantom (Solana) 或 Coinbase Wallet。复制 USDC 地址。
- 在 GiveReady 上注册(10 分钟)——组织名称、使命、项目、影响力数据、钱包地址。
- 可选:法币兑换出口(30 分钟)——连接到本地交易所(Coinbase、Luno 等),如需自动兑换为当地货币。
- 嵌入捐赠按钮(2 分钟)——在网站上添加一个脚本标签。
该非营利组织现在可被互联网上的每个 AI 代理发现,可通过 x402 收款,并在其网站上拥有一个免手续费的捐赠按钮。
联盟
资助牵头方:TestVentures.net。平台运营方:Clean Tactile Ventures UK Ltd。2026 年 Gates 申请的试点非营利组织:
City Kids Surfing — 英国青少年冲浪慈善机构。指定设计合作伙伴。终身免费使用 GiveReady 捐赠平台(通过 Stripe Connect 的法币和通过 x402 的 USDC)。真实捐赠流程的实时试点。
Finn Wardman World Explorer Fund — 青少年冒险资助。总部位于百慕大的捐赠基金。内部试点(自产自销)。finnwardman.com
关于
GiveReady 由 TestVentures.net 构建——为青少年非营利组织提供碎片化 AI 运营。GiveReady 实时目录的收入支持 Finn Wardman World Explorer Fund。
Finn Wardman 于 2023 年 4 月 8 日去世,年仅 20 岁。他是一名自由式滑雪者、冲浪者,也是任何房间里最有趣的人之一。World Explorer Fund 的存在是为了让其他年轻人能够拥有他所热爱的冒险经历。GiveReady 的存在是为了让该基金——以及数百个类似的小型非营利组织——能够从世界各地接收捐赠,而无需中间商抽成。
许可证
MIT。请参阅 LICENSE。