Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.giveready.org/llms.txt

Use this file to discover all available pages before exploring further.

​
Quickstart

GiveReady requires no API key for read operations. You can search nonprofits, view profiles, and list causes right now. If you’re connecting an AI agent (Claude, ChatGPT, Cursor, or any MCP-compatible client): 
npx giveready-mcp
Or add to your MCP client config: 
{
  "mcpServers": {
    "giveready": {
      "command": "npx",
      "args": ["giveready-mcp"]
    }
  }
}
Your agent now has access to search_nonprofits, get_nonprofit, and list_causes tools. Try it: Ask your agent “Find nonprofits working on mental health” or “Show me organizations focused on environmental conservation in the UK.”

​
Option 2: REST API

# Search for nonprofits
curl https://giveready.org/api/search?q=surfing

# Get a specific nonprofit
curl https://giveready.org/api/nonprofits/city-kids-surfing

# List all cause areas
curl https://giveready.org/api/causes

# Directory stats
curl https://giveready.org/api/stats

​
Option 3: Donate via x402

To initiate a donation, call the donate endpoint. The response includes payment instructions: 
# Step 1: Get payment instructions
curl https://giveready.org/api/donate/city-kids-surfing?amount=50

# Response: HTTP 402 with x402 payment details
# {
#   "x402": true,
#   "recipient": "<wallet_address>",
#   "amount": 50,
#   "currency": "USDC",
#   "network": "solana",
#   "nonprofit": "City Kids Surfing"
# }

# Step 2: Sign and submit the USDC transaction
curl -X POST https://giveready.org/api/donate/city-kids-surfing \
  -H "Content-Type: application/json" \
  -d '{"tx_signature": "<signed_transaction_hash>"}'

​
What’s Next

API Reference

Full endpoint documentation

MCP Tools

Available MCP tools and schemas

For AI Agents

How agents discover and use GiveReady

Onboard a Nonprofit

Claim your nonprofit