GiveReady

Infraestructura de código abierto para que los agentes de IA descubran organizaciones juveniles sin ánimo de lucro y les envíen dinero directamente. Sin intermediarios. Sin comisiones de plataforma. Las organizaciones sin ánimo de lucro se quedan con el 100%.

El problema

Cada plataforma de donación — Every.org, The Giving Block, Endaoment — es un intermediario. El dinero va primero a ellos. Lo convierten, lo redirigen y se llevan una parte. Para las pequeñas organizaciones benéficas juveniles en Ciudad del Cabo, Bermudas o Nairobi, esa capa añade fricción, comisiones y retrasos que merman unos presupuestos ya de por sí ajustados.

En 12 meses, los donantes no irán a un sitio web para donar. Le dirán a un asistente de IA: "encuéntrame una organización benéfica juvenil en Ciudad del Cabo y envíales 20 dólares". El agente necesita datos estructurados para encontrar la organización adecuada y una vía de pago para enviar el dinero. Ninguna plataforma existente proporciona ambas cosas.

Qué hace GiveReady

Descubrimiento. Un servidor MCP y una API REST ofrecen a los agentes de IA acceso estructurado a más de 162 organizaciones juveniles sin ánimo de lucro: programas, métricas de impacto, datos demográficos de los beneficiarios y direcciones de cartera. Cuando un agente de IA necesita encontrar una organización benéfica, consulta GiveReady.

Pago directo. El protocolo x402 permite a los agentes de IA enviar USDC directamente a la propia cartera de la organización sin ánimo de lucro. Ningún intermediario retiene los fondos. La organización sin ánimo de lucro controla el dinero desde el momento en que llega. Liquidación en menos de un segundo en Solana.

Botón de donación integrable. Cada organización sin ánimo de lucro incorporada obtiene un widget de JavaScript sin dependencias para su sitio web. Una etiqueta de script. Genera un código QR de Solana Pay o un enlace de transferencia directa. Los donantes escanean con Phantom o Coinbase Wallet. No requiere backend. Sin comisión de plataforma.

El descubrimiento sin pago es un motor de búsqueda. El pago sin descubrimiento es una cartera. Un botón de donación que nadie puede encontrar es un widget. GiveReady combina los tres.

Por qué es importante fuera de EE. UU./Reino Unido/UE

Las plataformas de donación tradicionales se dirigen a través de la infraestructura de pago de EE. UU. Si realizas operaciones bancarias en Bermudas, gran parte de África, el Caribe o el Sudeste Asiático, o bien estás excluido o pagas comisiones de conversión que hacen que las pequeñas donaciones no tengan sentido.

USDC en Solana funciona en cualquier lugar. Una organización sin ánimo de lucro necesita un teléfono inteligente y una aplicación de cartera. Cero KYC para recibir fondos. Salida a moneda local a través de un intercambio local si es necesario. Esto no es solo infraestructura para organizaciones benéficas occidentales, es infraestructura para cualquier organización sin ánimo de lucro en cualquier país.

Arquitectura

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

Coste de funcionamiento: ~5 $/mes en Cloudflare. El nivel gratuito del facilitador de Coinbase cubre 1.000 transacciones/mes. Las comisiones de transacción las paga el donante.

Endpoints de la API

Endpoint	Descripción
`GET /api/search?q=&cause=&country=`	Buscar organizaciones sin ánimo de lucro
`GET /api/nonprofits`	Listar todas las organizaciones verificadas
`GET /api/nonprofits/:slug`	Obtener detalles de la organización
`GET /api/causes`	Listar áreas de causa
`GET /api/stats`	Estadísticas del directorio
`GET /api/donate/:slug?amount=`	Donación x402 (devuelve 402 con requisitos de pago)
`POST /api/donate/:slug`	Enviar pago firmado
`GET /api/donations/:slug`	Historial de donaciones
`GET /mcp`	Manifiesto del servidor MCP
`GET /.well-known/ai-plugin.json`	Descubrimiento de plugins de IA
`GET /llms.txt`	Metadatos del rastreador LLM
`GET /agents.md`	Guía de descubrimiento de agentes

Servidor MCP

Instala el servidor MCP para dar a cualquier asistente de IA acceso nativo a GiveReady:

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

Herramientas: search_nonprofits, get_nonprofit, list_causes, donate_to_nonprofit, get_donation_history

Añade un botón de donación a cualquier sitio web de una organización sin ánimo de lucro con una línea:

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

Consulta public/widget/README.md para ver la documentación completa.

Ejecuta tu propia instancia

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

Consulta DEPLOY.md para obtener instrucciones completas de despliegue en producción.

Incorporación de organizaciones sin ánimo de lucro

Estar en la lista lleva menos de 45 minutos:

Configura una cartera (3 min) — Descarga Phantom (Solana) o Coinbase Wallet. Copia la dirección USDC.
Regístrate en GiveReady (10 min) — Nombre de la organización, misión, programas, datos de impacto, dirección de la cartera.
Opcional: salida a moneda fiduciaria (30 min) — Conéctate a un intercambio local (Coinbase, Luno, etc.) si deseas la conversión automática a moneda local.
Integra el botón de donación (2 min) — Una etiqueta de script en tu sitio web.

La organización sin ánimo de lucro ahora es descubrible por todos los agentes de IA en Internet, pagable a través de x402, y tiene un botón de donación sin comisiones en su sitio.

El consorcio

Construido con tres organizaciones piloto:

Bridges for Music — Reino Unido/EE. UU./Sudáfrica. Más de 250 estudiantes/año en el municipio de Langa, Ciudad del Cabo. Música, emprendimiento, mindfulness.

The Wave Project — Terapia de surf en el Reino Unido. 32 ubicaciones, más de 5.000 jóvenes atendidos. Primera organización benéfica en ofrecer surf bajo receta médica.

Finn Wardman World Explorer Fund — Becas de aventura para jóvenes. Fondo con sede en Bermudas. finnwardman.com

Acerca de

GiveReady ha sido creado por TestVentures.net — operaciones de IA fraccionada para organizaciones juveniles sin ánimo de lucro. Los ingresos del directorio en vivo de GiveReady apoyan al Finn Wardman World Explorer Fund.

Finn Wardman falleció el 8 de abril de 2023. Tenía 20 años. Era esquiador de freeride, surfista y una de las personas más divertidas en cualquier habitación. El World Explorer Fund existe para que otros jóvenes puedan tener el tipo de aventuras por las que él vivió. GiveReady existe para que ese fondo —y cientos de pequeñas organizaciones sin ánimo de lucro como él— puedan recibir donaciones de cualquier parte del mundo sin que un intermediario se lleve una parte.

Licencia

MIT. Consulta LICENSE.

giveready-mcp