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.
Available Tools
The GiveReady MCP server exposes 5 tools. Verify the live list at https://giveready.org/mcp — that endpoint is the source of truth.
search_nonprofits
Search for nonprofits by keyword, cause area, country, or alignment.
Parameters
| Parameter | Type | Required | Description |
|---|
q | string | No | Keyword search |
cause | string | No | Filter by cause slug |
country | string | No | Filter by country |
ghd_aligned | boolean | No | Filter for GHD-aligned orgs |
Example
Agent: "Find nonprofits working on mental health in South Africa"
→ search_nonprofits({country: "South Africa", cause: "mental-health"})
Available Causes
youth-empowerment, music-education, adventure-travel, mental-health, surf-therapy, entrepreneurship, poverty-reduction, creative-arts, education, community-development, peer-support, environment, health, animals, housing, food-security, disability, veterans, racial-justice, immigration, lgbtq, science-research, religion, gender-equality, refugees, sports-recreation, legal-justice, seniors, water-sanitation
Available Countries
South Africa, United Kingdom, Bermuda, United States (growing)
get_nonprofit
Get the full profile for a specific nonprofit, including programmes, impact metrics, and wallet address.
Parameters
| Parameter | Type | Required | Description |
|---|
slug | string | Yes | The nonprofit’s URL slug |
Example
Agent: "Tell me about City Kids Surfing"
→ get_nonprofit({slug: "city-kids-surfing"})
list_causes
List all cause areas with descriptions and nonprofit counts. No parameters.
Example
Agent: "What cause areas does GiveReady cover?"
→ list_causes()
donate_to_nonprofit
Initiate a USDC donation to a nonprofit via the x402 HTTP payment protocol. Returns the payment instructions — the client still needs to sign and broadcast the Solana transaction.
Parameters
| Parameter | Type | Required | Description |
|---|
slug | string | Yes | The nonprofit’s URL slug |
amount_usdc | number | Yes | Donation amount in USDC |
note | string | No | Optional memo attached to the donation |
Example
Agent: "Donate $25 to the Finn Wardman World Explorer Fund"
→ donate_to_nonprofit({slug: "finn-wardman-world-explorer-fund", amount_usdc: 25})
solana:*). See For AI Agents → Donating for the full flow.
get_donation_history
Fetch the recent donation history for a nonprofit. Useful for verifying a donation landed, or for showing a user the organisation’s traction.
Parameters
| Parameter | Type | Required | Description |
|---|
slug | string | Yes | The nonprofit’s URL slug |
Example
Agent: "Show me recent donations to City Kids Surfing"
→ get_donation_history({slug: "city-kids-surfing"})
donation_count, total_donated_usdc, and recent_donations (each with amount, network, tx_hash, status, timestamps).
Note on submit_enrichment
The npm package giveready-mcp that you install locally via npx giveready-mcp also exposes a submit_enrichment tool for the write-back API documented at API Reference → Enrichment. The HTTP /mcp endpoint served from giveready.org is the discovery manifest for remote clients and does not currently expose submit_enrichment. If you want write access over MCP, install the npm package.
