> ## 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

> Search nonprofits and make a donation in under 5 minutes

# 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):

```bash theme={null}
npx giveready-mcp
```

Or add to your MCP client config:

```json theme={null}
{
  "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

```bash theme={null}
# 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:

```bash theme={null}
# 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

<CardGroup cols={2}>
  <Card title="API Reference" icon="code" href="/api/overview">
    Full endpoint documentation
  </Card>

  <Card title="MCP Tools" icon="plug" href="/mcp/tools">
    Available MCP tools and schemas
  </Card>

  <Card title="For AI Agents" icon="robot" href="/for-agents/discovery">
    How agents discover and use GiveReady
  </Card>

  <Card title="Onboard a Nonprofit" icon="heart" href="/for-nonprofits/onboarding">
    Claim your nonprofit
  </Card>
</CardGroup>