# Qgiv MCP by usefulapi

> Qgiv MCP by usefulapi is an MCP server. Read Qgiv (Bloomerang Fundraising) donations, refunds, recurring gifts, P2P registrations, events. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Website:** https://usefulapi.io/qgiv/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/qgiv
- **MCP Registry name:** io.usefulapi/qgiv
- **Listing updated:** 2026-11-13

## About

Read Qgiv (Bloomerang Fundraising) donations, refunds, recurring gifts, P2P registrations, events.

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http qgiv https://qgiv.usefulapi.io/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://qgiv.usefulapi.io/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "qgiv": {
      "url": "https://qgiv.usefulapi.io/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "qgiv": {
      "type": "http",
      "url": "https://qgiv.usefulapi.io/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "qgiv": {
      "serverUrl": "https://qgiv.usefulapi.io/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "qgiv": {
      "type": "http",
      "url": "https://qgiv.usefulapi.io/mcp"
    }
  }
}
```

## Tools

- `qgiv_list_recent_transactions`: The most recent donations/transactions (newest first as Qgiv returns them): id, status, date, amount, fee, net, donor name and id, form, recurring link, payment type and last four card digits, fund. Donor contact details are left out unless include_contact is set; full card numbers are never returned. POST /reporting/transactions/last/{limit}.
- `qgiv_list_transactions_by_date`: Transactions between two dates (inclusive), at most 31 days per call, paged with offset/limit. Same fields as qgiv_list_recent_transactions. Qgiv has no server-side paging, so a busy range is fetched whole and sliced; use a shorter range if it is too large. POST /reporting/transactions/dates/{begin}:{end}.
- `qgiv_list_transactions_after_id`: Transactions with an id greater than the given one, sorted by id ascending and paged with limit; next_after_id is the cursor for the next call (use it as after_id). Handy for syncing new gifts. POST /reporting/transactions/after/{id}.
- `qgiv_get_transaction`: One transaction in full: donation lines, fund/restriction, dedication, custom-field answers, event packages, registrations, refunds. Contact details only with include_contact; card data is reduced to the last four digits. POST /reporting/transactions/{id}.
- `qgiv_list_recent_refunds`: The most recent refunds (read-only): id, original transaction, refund and settle dates, amount, payment type, last four digits, fund. POST /reporting/refunds/last/{limit}.
- `qgiv_list_refunds_by_date`: Refunds between two dates (inclusive), at most 31 days per call, paged with offset/limit. POST /reporting/refunds/dates/{begin}:{end}.
- `qgiv_get_refund`: One refund in full by id (read-only; this server never issues refunds). POST /reporting/refunds/{id}.
- `qgiv_list_recurring_schedules`: Recurring donation schedules (read-only): id, start/end date, next billing date, frequency, amount, state, donor name and id, plus Qgiv's 12-month forecast. Filter by status active, paused, expired or deleted. Paged with offset/limit. POST /reporting/recurring/list or /reporting/recurring/{status}.
- `qgiv_get_recurring_schedule`: One recurring donation schedule by id (read-only; schedules cannot be changed here). POST /reporting/recurring/{id}.
- `qgiv_list_statements`: Monthly fee/payout statements: id, date, amount contributed, fees, refunded, debited, credited and the summary totals (without the per-transaction rows; use qgiv_get_statement for those). Paged with offset/limit. POST /reporting/statements/list.
- `qgiv_get_latest_statements`: The latest statement(s) for the organization or form, with summary totals (per-transaction rows left out). POST /reporting/statements/latest.
- `qgiv_get_statement`: One statement by id with its transaction rows (first 100 shown; donor names only). POST /reporting/statements/{id}.
- `qgiv_list_recent_registrations`: The most recent peer-to-peer (Hobnob) event registrations: id, category, registrant name, team, fundraising goal and amount raised. Contact details only with include_contact. POST /reporting/registrations/last/{limit}.
- `qgiv_list_registrations_by_date`: Peer-to-peer registrations between two dates (inclusive), at most 31 days per call, paged with offset/limit. POST /reporting/registrations/dates/{begin}:{end}.
- `qgiv_get_registration`: One peer-to-peer registration in full (purchase history, team, totals, child registrations). Contact details only with include_contact. POST /reporting/registrations/{id}.
- `qgiv_list_events`: Events (ticketed/auction events) on the forms the token covers: id, dates and the top-level settings. Set include_details for packages, questions and promo codes. Notification e-mail addresses are never returned. POST /events/list.
- `qgiv_list_pledges`: Pledge options configured on the form(s) (title, value, frequency, begin date, iterations, state), not donors' pledge records. POST /pledges/list.
- `qgiv_get_pledge`: One pledge option by id. POST /pledges/{id} (no package is sent, so nothing is changed).
- `qgiv_list_custom_fields`: Custom (additional-question) fields configured on the form(s): id, reference, title, input type, required flags, display flags. POST /customFields/list.
- `qgiv_list_report_mappings`: Report mappings (accounting export mappings) on the form(s): id, identifier, mapping data, export service, type. POST /reporting/mappings/list.
- `qgiv_get_report_mapping`: One report mapping by id. POST /reporting/mappings/{id}.

## FAQ

### How do I add Qgiv MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http qgiv https://qgiv.usefulapi.io/mcp

---
Source: https://ai-powered.com/mcp/qgiv-mcp-by-usefulapi
