> ## 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

> MCP tools exposed by the GiveReady server

# Available Tools

The GiveReady MCP server exposes 5 tools. Verify the live list at [`https://giveready.org/mcp`](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-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`](https://www.npmjs.com/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](/api/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.