Giveready MCP server

GiveReady

Open-source infrastructure for AI agents to discover youth nonprofits and send them money directly. No intermediary. No platform fees. Nonprofits keep 100%.

The Problem

Every donation platform — Every.org, The Giving Block, Endaoment — is an intermediary. Money goes to them first. They convert it, route it, take a cut. For small youth charities in Cape Town or Bermuda or Nairobi, that layer adds friction, fees, and delays that eat into already thin budgets.

Within 12 months, donors won't go to a website to give. They'll tell an AI assistant "find me a youth charity in Cape Town and send them $20." The agent needs structured data to find the right org and a payment rail to send the money. No existing platform provides both.

What GiveReady Does

Discovery. An MCP server and REST API give AI agents structured access to 41,000+ verified nonprofits across 29 cause areas — programmes, impact metrics, beneficiary demographics, donation links, and wallet addresses where available. When an AI agent needs to find a charity, it queries GiveReady.

Direct payment. The x402 protocol lets AI agents send USDC straight to the nonprofit's own wallet. No intermediary holds the funds. The nonprofit controls the money from the moment it arrives. Settlement in under a second on Solana.

Embeddable donate button. Every onboarded nonprofit gets a zero-dependency JavaScript widget for their website. One script tag. Generates a Solana Pay QR code or direct transfer link. Donors scan with Phantom or Coinbase Wallet. No backend required. No platform fee.

Discovery without payment is a search engine. Payment without discovery is a wallet. A donate button nobody can find is a widget. GiveReady combines all three.

Why It Matters Outside the US/UK/EU

Traditional donation platforms route through US payment infrastructure. If you're banking in Bermuda, most of Africa, the Caribbean, or Southeast Asia, you're either excluded or paying conversion fees that make small donations pointless.

USDC on Solana works anywhere. A nonprofit needs a smartphone and a wallet app. Zero KYC to receive funds. Off-ramp to local currency through a local exchange if needed. This isn't just infrastructure for Western charities — it's infrastructure for any nonprofit in any country.

Architecture

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

Cost to run: ~$5/month on Cloudflare. Coinbase facilitator free tier covers 1,000 transactions/month. Transaction fees paid by donor.

API Endpoints

Shortened. The full README is on GitHub.