GiveReady

GiveReady

Open-Source-Infrastruktur für KI-Agenten, um Jugend-Nonprofits zu entdecken und ihnen direkt Geld zu senden. Kein Zwischenhändler. Keine Plattformgebühren. Nonprofits behalten 100 %.

Das Problem

Jede Spendenplattform – Every.org, The Giving Block, Endaoment – ist ein Zwischenhändler. Das Geld geht zuerst an sie. Sie konvertieren es, leiten es weiter, nehmen einen Anteil. Für kleine Jugend-Wohltätigkeitsorganisationen in Kapstadt, Bermuda oder Nairobi bringt diese Ebene Reibung, Gebühren und Verzögerungen, die bereits dünne Budgets weiter aufzehren.

Innerhalb von 12 Monaten werden Spender nicht mehr auf eine Website gehen, um zu spenden. Sie werden einem KI-Assistenten sagen: „Finde mir eine Jugend-Wohltätigkeitsorganisation in Kapstadt und sende ihr 20 $.“ Der Agent benötigt strukturierte Daten, um die richtige Organisation zu finden, und eine Zahlungsschiene, um das Geld zu senden. Keine bestehende Plattform bietet beides.

Was GiveReady tut

Entdeckung. Ein MCP-Server und eine REST-API geben KI-Agenten strukturierten Zugriff auf über 41.000 verifizierte Nonprofits in 29 Themenbereichen – Programme, Wirkungskennzahlen, Begünstigtendemografie, Spendenlinks und Wallet-Adressen, wo verfügbar. Wenn ein KI-Agent eine Wohltätigkeitsorganisation finden muss, fragt er GiveReady ab.

Direktzahlung. Das x402-Protokoll ermöglicht es KI-Agenten, USDC direkt an die eigene Wallet des Nonprofits zu senden. Kein Zwischenhändler hält die Gelder. Der Nonprofit kontrolliert das Geld ab dem Moment, in dem es ankommt. Abwicklung in unter einer Sekunde auf Solana.

Einbettbarer Spenden-Button. Jeder onboardete Nonprofit erhält ein abhängigkeitsfreies JavaScript-Widget für seine Website. Ein Script-Tag. Generiert einen Solana-Pay-QR-Code oder einen direkten Überweisungslink. Spender scannen mit Phantom oder Coinbase Wallet. Kein Backend erforderlich. Keine Plattformgebühr.

Entdeckung ohne Zahlung ist eine Suchmaschine. Zahlung ohne Entdeckung ist eine Wallet. Ein Spenden-Button, den niemand finden kann, ist ein Widget. GiveReady kombiniert alle drei.

Warum es außerhalb der USA/UK/EU wichtig ist

Traditionelle Spendenplattformen laufen über die US-Zahlungsinfrastruktur. Wenn Sie in Bermuda, in den meisten Teilen Afrikas, der Karibik oder Südostasiens Bankgeschäfte betreiben, sind Sie entweder ausgeschlossen oder zahlen Konvertierungsgebühren, die kleine Spenden sinnlos machen.

USDC auf Solana funktioniert überall. Ein Nonprofit benötigt ein Smartphone und eine Wallet-App. Kein KYC, um Gelder zu empfangen. Off-Ramp in lokale Währung über eine lokale Börse, falls erforderlich. Dies ist nicht nur Infrastruktur für westliche Wohltätigkeitsorganisationen – es ist Infrastruktur für jeden Nonprofit in jedem Land.

Architektur

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-Protokoll + Model Context Protocol (MCP)

Betriebskosten: ~5 $/Monat auf Cloudflare. Der kostenlose Coinbase-Facilitator-Tarif deckt 1.000 Transaktionen/Monat ab. Transaktionsgebühren werden vom Spender bezahlt.

API-Endpunkte

Endpunkt	Beschreibung
GET /api/search?q=&cause=&country=	Nonprofits durchsuchen
GET /api/nonprofits	Alle verifizierten Nonprofits auflisten
GET /api/nonprofits/:slug	Nonprofit-Details abrufen
GET /api/causes	Themenbereiche auflisten
GET /api/stats	Verzeichnisstatistiken
GET /api/donate/:slug?amount=	x402-Spende (gibt 402 mit Zahlungsanforderungen zurück)
POST /api/donate/:slug	Signierte Zahlung einreichen
GET /api/donations/:slug	Spendenhistorie
GET /mcp	MCP-Server-Manifest
GET /.well-known/ai-plugin.json	KI-Plugin-Entdeckung
GET /llms.txt	LLM-Crawler-Metadaten
GET /agents.md	Agenten-Entdeckungsleitfaden

MCP-Server

Installieren Sie den MCP-Server, um jedem KI-Assistenten nativen Zugriff auf GiveReady zu geben:

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

Tools: search_nonprofits, get_nonprofit, list_causes, submit_enrichment

Spenden-Widget

Fügen Sie mit einer Zeile einen Spenden-Button zu jeder Nonprofit-Website hinzu:

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

Siehe public/widget/README.md für die vollständige Dokumentation.

Eigene Instanz betreiben

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

Siehe DEPLOY.md für vollständige Produktionsbereitstellungsanweisungen.

Nonprofit-Onboarding

Die Auflistung dauert unter 45 Minuten:

1. Wallet einrichten (3 Min.) – Phantom (Solana) oder Coinbase Wallet herunterladen. Die USDC-Adresse kopieren.
2. Bei GiveReady registrieren (10 Min.) – Organisationsname, Mission, Programme, Wirkungsdaten, Wallet-Adresse.
3. Optional: Fiat-Off-Ramp (30 Min.) – Mit einer lokalen Börse (Coinbase, Luno usw.) verbinden, wenn Sie eine automatische Konvertierung in lokale Währung wünschen.
4. Spenden-Button einbetten (2 Min.) – Ein Script-Tag auf Ihrer Website.

Der Nonprofit ist nun für jeden KI-Agenten im Internet auffindbar, über x402 zahlbar und hat einen gebührenfreien Spenden-Button auf seiner Website.

Das Konsortium

Förderleitung: TestVentures.net. Plattformbetreiber: Clean Tactile Ventures UK Ltd. Pilot-Nonprofits für den Gates-Antrag 2026:

City Kids Surfing – Britische Jugend-Surf-Wohltätigkeitsorganisation. Benannter Designpartner. Erhält lebenslangen kostenlosen Zugang zur GiveReady-Spendenplattform (Fiat über Stripe Connect und USDC über x402). Live-Pilot für den echten Spendenfluss.

Finn Wardman World Explorer Fund – Jugend-Abenteuerstipendien. Bermuda-basierte Stiftung. Interner Pilot (Eigenes Kochbuch). finnwardman.com

Über

GiveReady wird von TestVentures.net gebaut – fraktionale KI-Operationen für Jugend-Nonprofits. Einnahmen aus dem Live-Verzeichnis von GiveReady unterstützen den Finn Wardman World Explorer Fund.

Finn Wardman starb am 8. April 2023. Er wurde 20. Er war Freeride-Skifahrer, Surfer und einer der lustigsten Menschen in jedem Raum. Der World Explorer Fund existiert, damit andere junge Menschen die Art von Abenteuern erleben können, für die er lebte. GiveReady existiert, damit dieser Fonds – und Hunderte kleiner Nonprofits wie ihn – Spenden von überall auf der Welt erhalten können, ohne dass ein Zwischenhändler einen Anteil nimmt.

Lizenz

MIT. Siehe LICENSE.