GiveReady

Send a small USDC donation to a verified nonprofit on the GiveReady directory, signed and broadcast directly from this MCP server's configured Solana keypair via the x402 protocol.

AUTHORISATION & SAFETY (read carefully — the user is trusting you with funds):

• Only fires if the MCP server has SOLANA_PRIVATE_KEY set in its environment. Otherwise the tool throws a clear error and no transaction is built.
• Hard caps: max $1 USDC per single call, max $5 USDC per day across all calls. The caps are enforced server-side; you cannot exceed them by retrying.
• Wallet balance check happens before signing. If insufficient USDC, the tool fails fast.
• Every successful donation appends a receipt to ~/.giveready/donations.log on the host machine.
• The keypair MUST be a dedicated test wallet provisioned for this purpose, not the user's main wallet. The MCP user is responsible for that pre-commitment.

WHAT THIS TOOL DOES:

1. Hits GET /api/donate/{slug}?amount=N — server returns HTTP 402 with payment requirements (recipient wallet, USDC mint, network).
2. Builds an SPL token transfer for the exact atomic amount, signs with the configured keypair.
3. POSTs the signed transaction back as the X-PAYMENT header. Server broadcasts to Solana mainnet via its own RPC, confirms, and writes to the donations table.
4. Returns the on-chain transaction hash and a Solscan link.

WHEN TO USE: Use only when the user has clearly asked you to donate, named the recipient nonprofit (slug), and named an amount. Never default a donation. Never round up. If the user says "donate something" without an amount, ask for one before calling — this tool is not the place for guesses.

Get detailed information about a specific nonprofit including full description, programmes, impact metrics, registrations, and donation links. Use this when someone wants to learn more about a specific organisation before donating.

List all cause areas in the GiveReady directory. Use this to help someone explore what kinds of youth organisations are available before searching.

Search 41,000+ verified nonprofits across 29 cause areas by keyword, cause, or country. Returns organisations with impact data and donation links. Use this when someone wants to find charities to support, discover mission-aligned programmes, or explore giving options.

Cause IDs include: 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. Call list_causes for the live set with nonprofit counts.

Countries: any country name (e.g. "South Africa", "United Kingdom", "United States", "Bermuda").

Contribute missing data back to a nonprofit profile. Use this when get_nonprofit or search_nonprofits returns a profile with an empty high-value field and you have a well-sourced value to suggest.

Auto-promotion rules (server-enforced):

• STRUCTURED fields auto-promote when 2+ distinct agents submit the same normalised value. Fields: website, city, region, founded_year, contact_email. Submit canonical form — lowercase hostnames, no trailing slashes, lowercase emails, 4-digit year.
• PROSE fields (mission, description, tagline) do NOT auto-promote yet — submissions queue for committee review. Still worth submitting; you get credit retroactively when review ships.
• The server NEVER overwrites an existing non-empty value. Only empty fields can be promoted.

Always provide a source_url that backs the value. Always pass a stable agent_id and a human-readable agent_name — these drive the public leaderboard at https://giveready.org/agents.