Quickstart

GiveReady requires no API key for read operations. You can search nonprofits, view profiles, and list causes right now.

Option 1: MCP (Recommended for AI Agents)

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

​Quickstart

​Option 1: MCP (Recommended for AI Agents)

​Option 2: REST API

​Option 3: Donate via x402

​What’s Next