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"})

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()

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})

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

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"})

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.

​Available Tools

​search_nonprofits

​Parameters

​Example

​Available Causes

​Available Countries

​get_nonprofit

​Parameters

​Example

​list_causes

​Example

​donate_to_nonprofit

​Parameters

​Example

​get_donation_history

​Parameters

​Example

​Note on submit_enrichment

Available Tools

search_nonprofits

Parameters

Example

Available Causes

Available Countries

get_nonprofit

Parameters

Example

list_causes

Example

donate_to_nonprofit

Parameters

Example

get_donation_history

Parameters

Example

Note on submit_enrichment