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.

​

Examples

​

Find and Donate to a Surf Therapy Charity

User prompt: “I want to donate $50 to a surf therapy charity in the UK” Agent flow:

1. Calls search_nonprofits({cause: "surf-therapy", country: "United Kingdom"})
2. Returns City Kids Surfing and The Wave Project
3. Agent presents options with impact data
4. User selects City Kids Surfing
5. Agent calls REST API: GET /api/donate/city-kids-surfing?amount=50
6. Receives x402 payment instructions
7. Signs and submits USDC transaction

​

Research Nonprofits by Impact

User prompt: “Which youth charities serve the most beneficiaries?” Agent flow:

1. Calls search_nonprofits({cause: "youth-empowerment"})
2. Compares beneficiaries_per_year across results
3. For the top result, calls get_nonprofit({slug: "bridges-for-music"})
4. Returns detailed impact metrics: 250 students trained, 250 job placements annually

​

Explore the Directory

User prompt: “What types of nonprofits are on GiveReady?” Agent flow:

1. Calls list_causes()
2. Returns all 10 cause areas with descriptions and counts
3. Agent summarises: “GiveReady covers youth empowerment, surf therapy, music education, mental health, and more across 162+ nonprofits in 3 countries.”

​

Build a Giving Portfolio

User prompt: “I want to split $200 across three different youth charities” Agent flow:

1. Calls search_nonprofits({cause: "youth-empowerment"})
2. Returns multiple nonprofits across different countries
3. Agent recommends a balanced portfolio: Bridges for Music (SA), City Kids Surfing (UK), WEF (Bermuda)
4. Initiates three separate x402 donations of ~$67 each

​

Verify a Charity Before Donating

User prompt: “Is City Kids Surfing a real registered charity?” Agent flow:

1. Calls get_nonprofit({slug: "city-kids-surfing"})
2. Checks registrations array: UK Charity Commission #1182899
3. Confirms: “Yes, City Kids Surfing is registered with the UK Charity Commission (1182899), founded in 2017, supporting 30 young people annually.”