GiveReady

GiveReady

Infrastruktur sumber terbuka bagi agen AI untuk menemukan organisasi nirlaba pemuda dan mengirimkan uang langsung kepada mereka. Tanpa perantara. Tanpa biaya platform. Organisasi nirlaba menerima 100%.

Masalahnya

Setiap platform donasi — Every.org, The Giving Block, Endaoment — adalah perantara. Uang masuk ke mereka terlebih dahulu. Mereka mengonversi, merutekan, dan mengambil potongan. Bagi badan amal pemuda kecil di Cape Town, Bermuda, atau Nairobi, lapisan ini menambah gesekan, biaya, dan penundaan yang menggerogoti anggaran yang sudah tipis.

Dalam 12 bulan, donor tidak akan pergi ke situs web untuk memberi. Mereka akan memberi tahu asisten AI "carikan saya badan amal pemuda di Cape Town dan kirimkan $20." Agen membutuhkan data terstruktur untuk menemukan organisasi yang tepat dan jalur pembayaran untuk mengirim uang. Tidak ada platform yang ada yang menyediakan keduanya.

Apa yang GiveReady Lakukan

Penemuan. Server MCP dan REST API memberi agen AI akses terstruktur ke 41.000+ organisasi nirlaba terverifikasi di 29 bidang penyebab — program, metrik dampak, demografi penerima manfaat, tautan donasi, dan alamat dompet jika tersedia. Saat agen AI perlu menemukan badan amal, ia menanyakan GiveReady.

Pembayaran langsung. Protokol x402 memungkinkan agen AI mengirim USDC langsung ke dompet organisasi nirlaba itu sendiri. Tidak ada perantara yang memegang dana. Organisasi nirlaba mengontrol uang sejak saat tiba. Penyelesaian dalam waktu kurang dari satu detik di Solana.

Tombol donasi yang dapat disematkan. Setiap organisasi nirlaba yang terdaftar mendapatkan widget JavaScript tanpa dependensi untuk situs web mereka. Satu tag skrip. Menghasilkan kode QR Solana Pay atau tautan transfer langsung. Donor memindai dengan Phantom atau Coinbase Wallet. Tanpa backend yang diperlukan. Tanpa biaya platform.

Penemuan tanpa pembayaran adalah mesin pencari. Pembayaran tanpa penemuan adalah dompet. Tombol donasi yang tidak dapat ditemukan siapa pun adalah widget. GiveReady menggabungkan ketiganya.

Mengapa Ini Penting di Luar AS/Inggris/UE

Platform donasi tradisional merutekan melalui infrastruktur pembayaran AS. Jika Anda memiliki rekening di Bermuda, sebagian besar Afrika, Karibia, atau Asia Tenggara, Anda dikecualikan atau membayar biaya konversi yang membuat donasi kecil menjadi tidak berarti.

USDC di Solana berfungsi di mana saja. Organisasi nirlaba hanya perlu smartphone dan aplikasi dompet. Tanpa KYC untuk menerima dana. Off-ramp ke mata uang lokal melalui bursa lokal jika diperlukan. Ini bukan hanya infrastruktur untuk badan amal Barat — ini infrastruktur untuk organisasi nirlaba mana pun di negara mana pun.

Arsitektur

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

Tumpukan: Cloudflare Workers + D1 (SQLite) + Solana USDC + protokol x402 + Model Context Protocol (MCP)

Biaya operasional: ~$5/bulan di Cloudflare. Tingkat gratis fasilitator Coinbase mencakup 1.000 transaksi/bulan. Biaya transaksi dibayar oleh donor.

Endpoint API

Endpoint	Deskripsi
GET /api/search?q=&cause=&country=	Cari organisasi nirlaba
GET /api/nonprofits	Daftar semua organisasi nirlaba terverifikasi
GET /api/nonprofits/:slug	Dapatkan detail organisasi nirlaba
GET /api/causes	Daftar bidang penyebab
GET /api/stats	Statistik direktori
GET /api/donate/:slug?amount=	Donasi x402 (mengembalikan 402 dengan persyaratan pembayaran)
POST /api/donate/:slug	Kirim pembayaran yang ditandatangani
GET /api/donations/:slug	Riwayat donasi
GET /mcp	Manifes server MCP
GET /.well-known/ai-plugin.json	Penemuan plugin AI
GET /llms.txt	Metadata perayap LLM
GET /agents.md	Panduan penemuan agen

Server MCP

Instal server MCP untuk memberikan akses asli ke GiveReady kepada asisten AI mana pun:

{
  "mcpServers": {
    "giveready": {
      "command": "npx",
      "args": ["giveready-mcp"]
    }
  }
}

Alat: search_nonprofits, get_nonprofit, list_causes, submit_enrichment

Widget Donasi

Tambahkan tombol donasi ke situs web organisasi nirlaba mana pun dengan satu baris:

<div id="giveready-donate" data-slug="your-nonprofit-slug"></div>
<script src="https://giveready.org/widget/donate.js"></script>

Lihat public/widget/README.md untuk dokumentasi lengkap.

Jalankan Instans Anda Sendiri

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

Lihat DEPLOY.md untuk instruksi penerapan produksi lengkap.

Onboarding Organisasi Nirlaba

Terdaftar memakan waktu kurang dari 45 menit:

1. Siapkan dompet (3 menit) — Unduh Phantom (Solana) atau Coinbase Wallet. Salin alamat USDC.
2. Daftar di GiveReady (10 menit) — Nama organisasi, misi, program, data dampak, alamat dompet.
3. Opsional: off-ramp fiat (30 menit) — Hubungkan ke bursa lokal (Coinbase, Luno, dll.) jika Anda ingin konversi otomatis ke mata uang lokal.
4. Sematkan tombol donasi (2 menit) — Satu tag skrip di situs web Anda.

Organisasi nirlaba kini dapat ditemukan oleh setiap agen AI di internet, dapat dibayar melalui x402, dan memiliki tombol donasi tanpa biaya di situs mereka.

Konsorsium

Pemimpin hibah: TestVentures.net. Operator platform: Clean Tactile Ventures UK Ltd. Organisasi nirlaba percontohan untuk aplikasi Gates 2026:

City Kids Surfing — Badan amal selancar pemuda Inggris. Mitra desain yang ditunjuk. Menerima akses gratis seumur hidup ke platform donasi GiveReady (fiat melalui Stripe Connect dan USDC melalui x402). Percontohan langsung untuk alur donasi nyata.

Finn Wardman World Explorer Fund — Hibah petualangan pemuda. Endowment berbasis Bermuda. Percontohan internal (makan masakan sendiri). finnwardman.com

Tentang

GiveReady dibangun oleh TestVentures.net — operasi AI fraksional untuk organisasi nirlaba pemuda. Pendapatan dari direktori langsung GiveReady mendukung Finn Wardman World Explorer Fund.

Finn Wardman meninggal pada 8 April 2023. Usianya 20 tahun. Dia adalah pemain ski freeride, peselancar, dan salah satu orang paling lucu di ruangan mana pun. World Explorer Fund ada agar orang muda lainnya bisa mendapatkan petualangan seperti yang dia jalani. GiveReady ada agar dana itu — dan ratusan organisasi nirlaba kecil seperti itu — dapat menerima donasi dari mana saja di dunia tanpa perantara mengambil potongan.

Lisensi

MIT. Lihat LICENSE.