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 mengonversinya, mengarahkannya, mengambil potongan. Bagi lembaga amal pemuda kecil di Cape Town atau Bermuda atau Nairobi, lapisan itu menambah gesekan, biaya, dan penundaan yang menggerogoti anggaran yang sudah tipis.

Dalam 12 bulan, para donatur tidak akan mengunjungi situs web untuk memberi. Mereka akan memberi tahu asisten AI "carikan saya lembaga amal pemuda di Cape Town dan kirimkan $20 untuk mereka." Agen tersebut membutuhkan data terstruktur untuk menemukan organisasi yang tepat dan jalur pembayaran untuk mengirimkan uang. Tidak ada platform yang ada saat ini yang menyediakan keduanya.

Apa yang Dilakukan GiveReady

Penemuan. Server MCP dan REST API memberi agen AI akses terstruktur ke lebih dari 41.000 organisasi nirlaba terverifikasi di 29 bidang kegiatan — program, metrik dampak, demografi penerima manfaat, tautan donasi, dan alamat dompet jika tersedia. Saat agen AI perlu menemukan lembaga amal, ia melakukan kueri ke 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 mengendalikan uang sejak dana itu 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. Donatur memindai dengan Phantom atau Coinbase Wallet. Tidak perlu backend. Tidak ada 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/UK/UE

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

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

Arsitektur

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

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 donatur.

Titik Akhir API

Titik Akhir	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 kegiatan
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 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 petunjuk penerapan produksi lengkap.

Pendaftaran Organisasi Nirlaba

Tercantum membutuhkan 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 bebas 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 — Lembaga 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 aliran donasi nyata.

Finn Wardman World Explorer Fund — Hibah petualangan pemuda. Dana abadi berbasis di 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. Ia berusia 20 tahun. Ia adalah pemain ski gaya bebas, peselancar, dan salah satu orang terlucu di ruangan mana pun. World Explorer Fund ada agar orang-orang muda lainnya dapat merasakan petualangan yang ia jalani. GiveReady ada agar dana tersebut — dan ratusan organisasi nirlaba kecil sepertinya — dapat menerima donasi dari mana saja di dunia tanpa perantara mengambil potongan.

Lisensi

MIT. Lihat LICENSE.