Skip to main content

​
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

ParameterTypeRequiredDescription
qstringNoKeyword search
causestringNoFilter by cause slug
countrystringNoFilter by country
ghd_alignedbooleanNoFilter 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

ParameterTypeRequiredDescription
slugstringYesThe nonprofit’s URL slug

​
Example

Agent: "Tell me about City Kids Surfing"
→ get_nonprofit({slug: "city-kids-surfing"})
Returns: name, mission, description, programmes, impact metrics, registrations, wallet address, donation links.

​
list_causes

List all cause areas with descriptions and nonprofit counts. No parameters.

​
Example

Agent: "What cause areas does GiveReady cover?"
→ list_causes()
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

ParameterTypeRequiredDescription
slugstringYesThe nonprofit’s URL slug
amount_usdcnumberYesDonation amount in USDC
notestringNoOptional 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})
Returns x402 payment instructions including the destination wallet address and recommended network (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

ParameterTypeRequiredDescription
slugstringYesThe nonprofit’s URL slug

​
Example

Agent: "Show me recent donations to City Kids Surfing"
→ get_donation_history({slug: "city-kids-surfing"})
Returns: 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.