GiveReady

Open-Source-Infrastruktur für KI-Agenten, um Jugend-Non-Profit-Organisationen zu entdecken und ihnen direkt Geld zu senden. Kein Zwischenhändler. Keine Plattformgebühren. Non-Profit-Organisationen 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 und behalten einen Teil ein. Für kleine Jugendhilfswerke in Kapstadt, auf den Bermudas oder in Nairobi bedeutet diese Ebene Reibungsverluste, Gebühren und Verzögerungen, die bereits knappe Budgets belasten.

Innerhalb von 12 Monaten werden Spender nicht mehr auf eine Website gehen, um zu spenden. Sie werden ihrem KI-Assistenten sagen: „Finde mir ein Jugendhilfswerk in Kapstadt und sende ihnen 20 $.“ Der Agent benötigt strukturierte Daten, um die richtige Organisation zu finden, und einen Zahlungskanal, 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 162 Jugend-Non-Profit-Organisationen — Programme, Wirkungsmetriken, demografische Daten der Begünstigten, Wallet-Adressen. 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 das eigene Wallet der Non-Profit-Organisation zu senden. Kein Zwischenhändler hält die Gelder. Die Non-Profit-Organisation kontrolliert das Geld ab dem Moment, in dem es eintrifft. Abwicklung in unter einer Sekunde auf Solana.

Einbettbarer Spenden-Button. Jede registrierte Non-Profit-Organisation erhält ein abhängigkeitsfreies JavaScript-Widget für ihre Website. Ein Skript-Tag. Generiert einen Solana Pay QR-Code oder einen Direktüberweisungslink. Spender scannen mit Phantom oder Coinbase Wallet. Kein Backend erforderlich. Keine Plattformgebühr.

Entdeckung ohne Zahlung ist eine Suchmaschine. Zahlung ohne Entdeckung ist ein 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 Bankgeschäfte auf den Bermudas, in weiten Teilen Afrikas, der Karibik oder Südostasiens tätigen, sind Sie entweder ausgeschlossen oder zahlen Umrechnungsgebühren, die kleine Spenden sinnlos machen.

USDC auf Solana funktioniert überall. Eine Non-Profit-Organisation benötigt nur ein Smartphone und eine Wallet-App. Kein KYC erforderlich, um Gelder zu empfangen. Bei Bedarf Auszahlung in Lokalwährung über eine lokale Börse. Dies ist nicht nur Infrastruktur für westliche Wohltätigkeitsorganisationen — es ist Infrastruktur für jede Non-Profit-Organisation in jedem Land.

Architektur

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

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

API-Endpunkte

Endpunkt	Beschreibung
`GET /api/search?q=&cause=&country=`	Non-Profit-Organisationen suchen
`GET /api/nonprofits`	Alle verifizierten Non-Profit-Organisationen auflisten
`GET /api/nonprofits/:slug`	Details zur Non-Profit-Organisation abrufen
`GET /api/causes`	Zweckbereiche 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`	Leitfaden zur Agenten-Entdeckung

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, donate_to_nonprofit, get_donation_history

Fügen Sie mit einer Zeile einen Spenden-Button zu jeder Website einer Non-Profit-Organisation 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 ausführen

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 Anweisungen zur Produktionsbereitstellung.

Onboarding für Non-Profit-Organisationen

Die Aufnahme dauert weniger als 45 Minuten:

Wallet einrichten (3 Min.) — Laden Sie Phantom (Solana) oder Coinbase Wallet herunter. Kopieren Sie die USDC-Adresse.
Bei GiveReady registrieren (10 Min.) — Name der Organisation, Mission, Programme, Wirkungsdaten, Wallet-Adresse.
Optional: Fiat-Auszahlung (30 Min.) — Verbinden Sie sich mit einer lokalen Börse (Coinbase, Luno, etc.), wenn Sie eine automatische Umrechnung in Lokalwährung wünschen.
Spenden-Button einbetten (2 Min.) — Ein Skript-Tag auf Ihrer Website.

Die Non-Profit-Organisation ist nun für jeden KI-Agenten im Internet auffindbar, über x402 bezahlbar und verfügt über einen gebührenfreien Spenden-Button auf ihrer Website.

Das Konsortium

Aufgebaut mit drei Pilot-Non-Profit-Organisationen:

Bridges for Music — UK/US/SA. Über 250 Schüler/Jahr im Township Langa, Kapstadt. Musik, Unternehmertum, Achtsamkeit.

The Wave Project — UK Surftherapie. 32 Standorte, über 5.000 junge Menschen betreut. Erste Wohltätigkeitsorganisation, die Surfen auf Rezept anbietet.

Finn Wardman World Explorer Fund — Zuschüsse für Jugendabenteuer. Auf den Bermudas ansässige Stiftung. finnwardman.com

Über

GiveReady wurde von TestVentures.net entwickelt — fraktionierte KI-Operationen für Jugend-Non-Profit-Organisationen. Einnahmen aus dem Live-Verzeichnis von GiveReady unterstützen den Finn Wardman World Explorer Fund.

Finn Wardman starb am 8. April 2023. Er war 20 Jahre alt. 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 Non-Profit-Organisationen wie dieser — Spenden von überall auf der Welt erhalten können, ohne dass ein Zwischenhändler einen Teil einbehält.

Lizenz

MIT. Siehe LICENSE.

giveready-mcp