giveready

GiveReady

为 AI Agent 提供开源基础设施，帮助它们发现青少年非营利组织并直接向其汇款。没有中间方。没有平台费用。非营利组织保留 100% 的款项。

问题

每个捐赠平台——Every.org、The Giving Block、Endaoment——都是中间方。资金会先流向这些平台。它们负责兑换、转账并抽取佣金。对于开普敦、百慕大或内罗毕的小型青少年慈善机构来说，这一环节会增加阻力、费用和延迟，进一步挤压本就捉襟见肘的预算。

在未来 12 个月内，捐赠者将不再访问网站进行捐赠。他们会对 AI 助手说：“帮我在开普敦找一家青少年慈善机构，并向其捐赠 20 美元。”Agent 需要结构化数据来找到合适的组织，还需要支付通道来汇款。目前没有任何平台能同时提供这两者。

GiveReady 的功能

发现。 MCP 服务和 REST API 为 AI Agent 提供结构化访问渠道，可查询 29 个事业领域中超过 41,000 家经过验证的非营利组织，包括项目、影响指标、受益人群体信息、捐赠链接，以及可用的钱包地址。当 AI Agent 需要查找慈善机构时，就会查询 GiveReady。

直接付款。 x402 协议让 AI Agent 能够直接将 USDC 发送到非营利组织自己的钱包。没有中间方持有资金。资金到账后，非营利组织便能自行掌控。Solana 上的结算时间不到 1 秒。

可嵌入的捐赠按钮。 每家入驻的非营利组织都会获得一个零依赖的 JavaScript 小组件，可用于其网站。只需添加一个脚本标签，即可生成 Solana Pay QR 码或直接转账链接。捐赠者可使用 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 协议 + Model Context Protocol（MCP）

运行成本： 在 Cloudflare 上每月约 5 美元。Coinbase Facilitator 免费套餐每月可处理 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	大模型爬虫元数据
GET /agents.md	Agent 发现指南

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 分钟即可完成上架：

1. 设置钱包（3 分钟）— 下载 Phantom（Solana）或 Coinbase Wallet。复制 USDC 地址。
2. 在 GiveReady 注册（10 分钟）— 填写组织名称、使命、项目、影响数据和钱包地址。
3. 可选：法币提现（30 分钟）— 连接本地交易所（Coinbase、Luno 等），即可自动兑换为本地货币。
4. 嵌入捐赠按钮（2 分钟）— 在网站中添加一个 script 标签。

现在，互联网上的每个 AI Agent 都能发现这个非营利组织；它可通过 x402 收款，网站上也有一个免手续费的捐赠按钮。

联盟

资助负责人：TestVentures.net。平台运营方：Clean Tactile Ventures UK Ltd。2026 年盖茨申请的试点非营利组织：

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。