GiveReady

GiveReady

Infraestrutura de código aberto para agentes de IA descobrirem organizações sem fins lucrativos voltadas para jovens e enviarem dinheiro diretamente a elas. Sem intermediários. Sem taxas de plataforma. As organizações ficam com 100%.

O Problema

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

Em até 12 meses, doadores não vão a um site para doar. Eles vão dizer a um assistente de IA "encontre uma instituição de caridade juvenil na Cidade do Cabo e envie US$ 20 para ela". O agente precisa de dados estruturados para encontrar a organização certa e um canal de pagamento para enviar o dinheiro. Nenhuma plataforma existente oferece ambos.

O Que o GiveReady Faz

Descoberta. Um servidor MCP e uma API REST dão aos agentes de IA acesso estruturado a mais de 41.000 organizações sem fins lucrativos verificadas em 29 áreas de causa — 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 organização sem fins lucrativos. Nenhum intermediário retém os fundos. A organização 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. Toda organização sem fins lucrativos integrada recebe um widget JavaScript sem dependências para seu site. Uma única tag de script. Gera um código QR do Solana Pay ou um link de transferência direta. Doadores escaneiam com Phantom ou Coinbase Wallet. Sem necessidade de backend. Sem 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

Plataformas tradicionais de doação roteiam pela infraestrutura de pagamento dos EUA. Se você opera bancariamente 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 pequenas doações sem sentido.

USDC na Solana funciona em qualquer lugar. Uma organização sem fins lucrativos precisa de um smartphone e um aplicativo de carteira. Zero KYC para receber fundos. Saída para moeda local por meio de uma exchange local, se necessário. Isso não é apenas infraestrutura para instituições de caridade ocidentais — é infraestrutura para qualquer organização sem fins lucrativos em qualquer país.

Arquitetura

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

Custo para operar: ~US$ 5/mês na Cloudflare. O nível gratuito do facilitador 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=	Buscar organizações sem fins lucrativos
GET /api/nonprofits	Listar todas as organizações verificadas
GET /api/nonprofits/:slug	Obter detalhes da organização
GET /api/causes	Listar áreas de causa
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 do rastreador 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 organização sem fins lucrativos com uma linha:

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

Veja 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

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

Integração de Organizações Sem Fins Lucrativos

Ser listado leva menos de 45 minutos:

1. Configure uma carteira (3 min) — Baixe 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: saída para moeda fiduciária (30 min) — Conecte-se a uma exchange local (Coinbase, Luno, etc.) se quiser 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 organização 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

Líder da bolsa: TestVentures.net. Operador da plataforma: Clean Tactile Ventures UK Ltd. Organizações piloto para a candidatura Gates 2026:

City Kids Surfing — Instituição de caridade juvenil de surfe no Reino Unido. Parceira de design nomeada. Recebe acesso gratuito vitalício à plataforma de doação GiveReady (fiat via Stripe Connect e USDC via x402). Piloto ao vivo para fluxo real de doações.

Finn Wardman World Explorer Fund — Bolsas de aventura juvenil. Fundo sediado nas Bermudas. Piloto interno (comer da própria comida). finnwardman.com

Sobre

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

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

Licença

MIT. Veja LICENSE.