io.github.gswardman/giveready
Discover verified youth nonprofits with impact data, programmes, and donation links.
Ask AI about io.github.gswardman/giveready
Powered by Claude Β· Grounded in docs
I know everything about io.github.gswardman/giveready. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Reviews
Documentation
GiveReady
Open-source infrastructure for AI agents to discover youth nonprofits and send them money directly. No intermediary. No platform fees. Nonprofits keep 100%.
The Problem
Every donation platform β Every.org, The Giving Block, Endaoment β is an intermediary. Money goes to them first. They convert it, route it, take a cut. For small youth charities in Cape Town or Bermuda or Nairobi, that layer adds friction, fees, and delays that eat into already thin budgets.
Within 12 months, donors won't go to a website to give. They'll tell an AI assistant "find me a youth charity in Cape Town and send them $20." The agent needs structured data to find the right org and a payment rail to send the money. No existing platform provides both.
What GiveReady Does
Discovery. An MCP server and REST API give AI agents structured access to 162+ youth nonprofits β programmes, impact metrics, beneficiary demographics, wallet addresses. When an AI agent needs to find a charity, it queries GiveReady.
Direct payment. The x402 protocol lets AI agents send USDC straight to the nonprofit's own wallet. No intermediary holds the funds. The nonprofit controls the money from the moment it arrives. Settlement in under a second on Solana.
Embeddable donate button. Every onboarded nonprofit gets a zero-dependency JavaScript widget for their website. One script tag. Generates a Solana Pay QR code or direct transfer link. Donors scan with Phantom or Coinbase Wallet. No backend required. No platform fee.
Discovery without payment is a search engine. Payment without discovery is a wallet. A donate button nobody can find is a widget. GiveReady combines all three.
Why It Matters Outside the US/UK/EU
Traditional donation platforms route through US payment infrastructure. If you're banking in Bermuda, most of Africa, the Caribbean, or Southeast Asia, you're either excluded or paying conversion fees that make small donations pointless.
USDC on Solana works anywhere. A nonprofit needs a smartphone and a wallet app. Zero KYC to receive funds. Off-ramp to local currency through a local exchange if needed. This isn't just infrastructure for Western charities β it's infrastructure for any nonprofit in any country.
Architecture
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
Stack: Cloudflare Workers + D1 (SQLite) + Solana USDC + x402 protocol + Model Context Protocol (MCP)
Cost to run: ~$5/month on Cloudflare. Coinbase facilitator free tier covers 1,000 transactions/month. Transaction fees paid by donor.
API Endpoints
| Endpoint | Description |
|---|---|
GET /api/search?q=&cause=&country= | Search nonprofits |
GET /api/nonprofits | List all verified nonprofits |
GET /api/nonprofits/:slug | Get nonprofit detail |
GET /api/causes | List cause areas |
GET /api/stats | Directory statistics |
GET /api/donate/:slug?amount= | x402 donation (returns 402 with payment requirements) |
POST /api/donate/:slug | Submit signed payment |
GET /api/donations/:slug | Donation history |
GET /mcp | MCP server manifest |
GET /.well-known/ai-plugin.json | AI plugin discovery |
GET /llms.txt | LLM crawler metadata |
GET /agents.md | Agent discovery guide |
MCP Server
Install the MCP server to give any AI assistant native access to GiveReady:
{
"mcpServers": {
"giveready": {
"command": "npx",
"args": ["giveready-mcp"]
}
}
}
Tools: search_nonprofits, get_nonprofit, list_causes, submit_enrichment
Donate Widget
Add a donate button to any nonprofit website with one line:
<div id="giveready-donate" data-slug="your-nonprofit-slug"></div>
<script src="https://giveready.org/widget/donate.js"></script>
See public/widget/README.md for full documentation.
Run Your Own Instance
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
See DEPLOY.md for full production deployment instructions.
Nonprofit Onboarding
Getting listed takes under 45 minutes:
- Set up a wallet (3 min) β Download Phantom (Solana) or Coinbase Wallet. Copy the USDC address.
- Register on GiveReady (10 min) β Org name, mission, programmes, impact data, wallet address.
- Optional: fiat off-ramp (30 min) β Connect to a local exchange (Coinbase, Luno, etc.) if you want auto-conversion to local currency.
- Embed donate button (2 min) β One script tag on your website.
The nonprofit is now discoverable by every AI agent on the internet, payable via x402, and has a fee-free donation button on their site.
The Consortium
Grant lead: TestVentures.net. Platform operator: Clean Tactile Ventures UK Ltd. Pilot nonprofits for the 2026 Gates application:
City Kids Surfing β UK youth surf charity. Named design partner. Receives lifetime free access to the GiveReady donation platform (fiat via Stripe Connect and USDC via x402). Live pilot for real donation flow.
Finn Wardman World Explorer Fund β Youth adventure grants. Bermuda-based endowment. Internal pilot (eat-your-own-cooking). finnwardman.com
About
GiveReady is built by TestVentures.net β fractional AI ops for youth nonprofits. Revenue from GiveReady's live directory supports the Finn Wardman World Explorer Fund.
Finn Wardman died on April 8, 2023. He was 20. He was a freeride skier, a surfer, and one of the funniest people in any room. The World Explorer Fund exists so other young people get to have the kind of adventures he lived for. GiveReady exists so that fund β and hundreds of small nonprofits like it β can receive donations from anywhere in the world without an intermediary taking a cut.
Licence
MIT. See LICENSE.
