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 41,000+ verified nonprofits across 29 cause areas — programmes, impact metrics, beneficiary demographics, donation links, and wallet addresses where available. 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, 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

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

... View full README on GitHub