GiveReady

GiveReady

Infraestrutura de código aberto para agentes de IA descobrirem ONGs juvenis e enviarem dinheiro diretamente a elas. Sem intermediários. Sem taxas de plataforma. As ONGs ficam com 100%.

O Problema

Toda plataforma de doação — Every.org, The Giving Block, Endaoment — é um intermediário. O dinheiro vai primeiro para eles. Eles convertem, encaminham, ficam com uma parte. Para pequenas instituições de caridade juvenis na Cidade do Cabo, Bermudas ou Nairóbi, essa camada adiciona atrito, taxas e atrasos que corroem orçamentos já apertados.

Dentro de 12 meses, os doadores não acessarão um site para doar. Eles dirão a um assistente de IA "encontre uma instituição de caridade juvenil na Cidade do Cabo e envie $20 para eles". O agente precisa de dados estruturados para encontrar a organização certa e de um trilho de pagamento para enviar o dinheiro. Nenhuma plataforma existente oferece ambos.

O Que o GiveReady Faz

Descoberta. Um servidor MCP e uma API REST fornecem a agentes de IA acesso estruturado a mais de 41.000 ONGs verificadas em 29 áreas de atuação — programas, métricas de impacto, dados demográficos dos beneficiários, links de doação e endereços de carteira quando disponíveis. Quando um agente de IA precisa encontrar uma instituição de caridade, ele consulta o GiveReady.

Pagamento direto. O protocolo x402 permite que agentes de IA enviem USDC diretamente para a carteira da própria ONG. Nenhum intermediário detém os fundos. A ONG controla o dinheiro desde o momento em que ele chega. Liquidação em menos de um segundo na Solana.

Botão de doação incorporável. Cada ONG integrada recebe um widget JavaScript sem dependências para seu site. Uma tag de script. Gera um código QR Solana Pay ou link de transferência direta. Os doadores escaneiam com a Phantom ou Coinbase Wallet. Nenhum backend necessário. Nenhuma taxa de plataforma.

Descoberta sem pagamento é um mecanismo de busca. Pagamento sem descoberta é uma carteira. Um botão de doação que ninguém encontra é um widget. O GiveReady combina os três.

Por Que Isso Importa Fora dos EUA/Reino Unido/UE

As plataformas de doação tradicionais operam através da infraestrutura de pagamento dos EUA. Se você tem conta bancária nas Bermudas, na maior parte da África, no Caribe ou no Sudeste Asiático, você está excluído ou pagando taxas de conversão que tornam as pequenas doações inúteis.

USDC na Solana funciona em qualquer lugar. Uma ONG precisa de um smartphone e um aplicativo de carteira. Zero KYC para receber fundos. Off-ramp para moeda local através de uma exchange local, se necessário. Isso não é apenas infraestrutura para instituições de caridade ocidentais — é infraestrutura para qualquer ONG em qualquer país.

Arquitetura

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)

Custo de operação: ~$5/mês no Cloudflare. O nível gratuito do facilitador da Coinbase cobre 1.000 transações/mês. Taxas de transação pagas pelo doador.

Endpoints da API

Endpoint	Descrição
GET /api/search?q=&cause=&country=	Pesquisar ONGs
GET /api/nonprofits	Listar todas as ONGs verificadas
GET /api/nonprofits/:slug	Obter detalhes da ONG
GET /api/causes	Listar áreas de atuação
GET /api/stats	Estatísticas do diretório
GET /api/donate/:slug?amount=	Doação x402 (retorna 402 com requisitos de pagamento)
POST /api/donate/:slug	Enviar pagamento assinado
GET /api/donations/:slug	Histórico de doações
GET /mcp	Manifesto do servidor MCP
GET /.well-known/ai-plugin.json	Descoberta de plugin de IA
GET /llms.txt	Metadados para crawler de LLM
GET /agents.md	Guia de descoberta para agentes

Servidor MCP

Instale o servidor MCP para dar a qualquer assistente de IA acesso nativo ao GiveReady:

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

Ferramentas: search_nonprofits, get_nonprofit, list_causes, submit_enrichment

Widget de Doação

Adicione um botão de doação a qualquer site de ONG com uma linha:

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

Consulte public/widget/README.md para documentação completa.

Execute Sua Própria Instância

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

Consulte DEPLOY.md para instruções completas de implantação em produção.

Integração de ONGs

Ser listado leva menos de 45 minutos:

1. Configure uma carteira (3 min) — Baixe a Phantom (Solana) ou Coinbase Wallet. Copie o endereço USDC.
2. Registre-se no GiveReady (10 min) — Nome da organização, missão, programas, dados de impacto, endereço da carteira.
3. Opcional: off-ramp para moeda fiduciária (30 min) — Conecte-se a uma exchange local (Coinbase, Luno, etc.) se desejar conversão automática para moeda local.
4. Incorpore o botão de doação (2 min) — Uma tag de script no seu site.

A ONG agora é detectável por todos os agentes de IA na internet, pagável via x402 e tem um botão de doação sem taxas em seu site.

O Consórcio

Concessão principal: TestVentures.net. Operador da plataforma: Clean Tactile Ventures UK Ltd. ONGs piloto para a candidatura Gates 2026:

City Kids Surfing — Instituição de caridade de surfe juvenil do Reino Unido. Parceiro de design nomeado. Recebe acesso gratuito vitalício à plataforma de doação GiveReady (fiduciário via Stripe Connect e USDC via x402). Piloto ao vivo para fluxo de doação real.

Finn Wardman World Explorer Fund — Bolsas para aventuras juvenis. Fundo patrimonial sediado nas Bermudas. Piloto interno (comer sua própria comida). finnwardman.com

Sobre

O GiveReady é construído pela TestVentures.net — operações de IA fracionadas para ONGs juvenis. A receita do diretório ativo do GiveReady apoia o Finn Wardman World Explorer Fund.

Finn Wardman faleceu em 8 de abril de 2023. Ele tinha 20 anos. Era esquiador de freeride, surfista e uma das pessoas mais engraçadas em qualquer ambiente. O World Explorer Fund existe para que outros jovens possam ter o tipo de aventura pela qual ele viveu. O GiveReady existe para que esse fundo — e centenas de pequenas ONGs como ele — possam receber doações de qualquer lugar do mundo sem um intermediário ficar com uma parte.

Licença

MIT. Consulte LICENSE.