Skip to main content
Glama
gswardman

giveready-mcp

by gswardman

GiveReady

为 AI 智能体发现青年非营利组织并直接向其汇款的开源基础设施。无中介。无平台费用。非营利组织保留 100% 的捐款。

问题所在

每一个捐赠平台——Every.org、The Giving Block、Endaoment——都是中介。资金首先流向他们。他们进行转换、路由并抽取佣金。对于开普敦、百慕大或内罗毕的小型青年慈善机构来说,这一层增加了摩擦、费用和延迟,蚕食了本已微薄的预算。

在 12 个月内,捐赠者将不再通过访问网站来捐款。他们会告诉 AI 助手:“帮我找一家开普敦的青年慈善机构,并给他们汇 20 美元。”智能体需要结构化数据来找到合适的组织,并需要支付通道来汇款。目前没有任何平台能同时提供这两者。

Related MCP server: x402search

GiveReady 的功能

发现。 MCP 服务器和 REST API 为 AI 智能体提供对 162 家以上青年非营利组织的结构化访问权限——包括项目、影响力指标、受益人人口统计数据和钱包地址。当 AI 智能体需要寻找慈善机构时,它会查询 GiveReady。

直接支付。 x402 协议允许 AI 智能体将 USDC 直接发送到非营利组织自己的钱包。没有中介持有资金。非营利组织从资金到达的那一刻起就拥有控制权。在 Solana 上不到一秒即可完成结算。

可嵌入的捐赠按钮。 每个入驻的非营利组织都会获得一个零依赖的 JavaScript 小部件,可用于其网站。只需一个脚本标签。生成 Solana Pay 二维码或直接转账链接。捐赠者使用 Phantom 或 Coinbase Wallet 扫描即可。无需后端。无平台费用。

没有支付的发现只是搜索引擎。没有发现的支付只是钱包。没人能找到的捐赠按钮只是一个小部件。GiveReady 将这三者结合在一起。

为什么它在美国/英国/欧盟之外很重要

传统的捐赠平台通过美国的支付基础设施进行路由。如果你在百慕大、非洲大部分地区、加勒比海地区或东南亚进行银行业务,你要么被排除在外,要么支付高额的转换费用,这使得小额捐赠变得毫无意义。

Solana 上的 USDC 在任何地方都适用。非营利组织只需要一部智能手机和一个钱包应用程序。接收资金无需 KYC。如果需要,可以通过当地交易所兑换成当地货币。这不仅是西方慈善机构的基础设施,也是任何国家任何非营利组织的基础设施。

架构

giveready/
├── src/index.js              # Cloudflare Worker — API + x402 endpoint
├── mcp-server/               # MCP server for AI agents (Claude, etc.)
├── public/
│   ├── index.html            # Landing page (static, served by Cloudflare)
│   ├── widget/               # Embeddable donate button (zero dependencies)
│   ├── llms.txt              # LLM crawler metadata
│   ├── AGENTS.md             # Agent discovery guide
│   └── openapi.json          # OpenAPI spec for ai-plugin.json
├── test-client/              # x402 payment protocol test client
├── scripts/                  # Data import utilities
├── schema.sql                # D1 database schema
├── seed.sql                  # Nonprofit seed data
├── deploy.sh                 # Deployment script (./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 分钟:

  1. 设置钱包 (3 分钟) — 下载 Phantom (Solana) 或 Coinbase Wallet。复制 USDC 地址。

  2. 在 GiveReady 上注册 (10 分钟) — 组织名称、使命、项目、影响力数据、钱包地址。

  3. 可选:法币出金 (30 分钟) — 如果需要自动转换为当地货币,请连接到当地交易所(Coinbase、Luno 等)。

  4. 嵌入捐赠按钮 (2 分钟) — 在您的网站上添加一个脚本标签。

现在,该非营利组织可被互联网上的每个 AI 智能体发现,可通过 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 岁。他是一名自由式滑雪运动员、冲浪者,也是任何场合中最风趣的人之一。设立世界探险基金是为了让其他年轻人能够拥有他所追求的那种冒险经历。GiveReady 的存在是为了让该基金——以及数百个类似的小型非营利组织——能够从世界任何地方接收捐款,而无需中介抽取佣金。

许可

MIT。请参阅 LICENSE。

Related MCP Connectors

Related MCP Servers

  • F
    license
    A
    quality
    D
    maintenance
    Enables AI assistants to look up IRS nonprofit data, verify tax-deductible charity status, and search for organizations by name or location using the CharityAPI database.
    4
    3
    -
  • F
    license
    Not graded
    quality
    C
    maintenance
    GiveRadar's MCP server gives AI agents verified data on 7 million+ nonprofits across 65+ countries, sourced from official government registries. Tools let agents search charities, verify a charity by registration number or EIN, compare integrity scores, and find similar organizations.
    -