GivingFuel MCP by usefulapi

io.usefulapiPublished by usefulapi.ioOfficial publisherv1.15.4Updated Nov 7, 2026

Read GivingFuel forms, donations, transactions, recurring gifts and donors; manage coupons.

The publisher's own server: Ably MCP by usefulapi

VerifiedStreamable HTTPWeb executableFinanceData & AnalyticsBusiness & Commerce

Overview

AI-generated overview

Reads GivingFuel donation forms, orders, transactions, recurring gifts and donors, and manages discount coupons, from a hosted remote endpoint.

What you can do
  • List and inspect donation forms, including each form's field layout and limited-quantity inventory
  • List and fetch donation orders with donor billing details, totals and optional embedded payments
  • List and fetch payment transactions with amounts, deductible amounts, type, masked card and status
  • List and fetch recurring gifts with schedule, status and next payment date
  • List and fetch donor records with lifetime amounts, and list or fetch coupons
  • Create or permanently delete discount coupons in the live account
When to use it
Useful for fundraising and nonprofit teams that want to ask questions about GivingFuel data in plain language, such as how much was raised in a period and from which forms, which recurring gifts are due soon, or what a given donor has given. Also handy for looking up or issuing coupon codes.
Requirements
A remote MCP endpoint; no local package or runtime. Connect with the URL only and sign in through the server's OAuth flow, which asks for GivingFuel credentials. A GivingFuel API key, created in the GivingFuel dashboard under Account settings, is pasted on first connect. A paid plan is needed beyond the free monthly call allowance.
Before you install
Coupon creation and deletion act on the live GivingFuel account: a new coupon can be redeemed by donors immediately, deletion is permanent and not undoable, and creating twice makes two coupons. Donor names, emails, addresses and payment details are exposed to the assistant. The server meters usage and offers paid plans with payment links, so calls can lead to a subscription charge.

Installation

In SourceWeft

  1. Open GivingFuel MCP by usefulapi in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.usefulapi%2Fgivingfuel/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "givingfuel-by-usefulapi": {
      "type": "http",
      "url": "https://givingfuel.usefulapi.io/mcp"
    }
  }
}

README

GivingFuel MCP by usefulapi

Read GivingFuel forms, donations, transactions, recurring gifts and donors; manage coupons.

Live endpoint: https://givingfuel.usefulapi.io/mcp · Homepage: https://usefulapi.io/givingfuel

Connect

  • Claude (claude.ai, Desktop): open Customize → Connectors, click + Add → Add custom connector, and paste https://givingfuel.usefulapi.io/mcp.
  • Claude Code: claude mcp add --transport http givingfuel https://givingfuel.usefulapi.io/mcp, then run /mcp to log in.
  • VS Code: Add to VS Code.
  • Cursor and other clients: add the URL as a remote MCP server:
json
{  "mcpServers": {    "givingfuel": {      "url": "https://givingfuel.usefulapi.io/mcp"    }  }}

Add only the URL. Do not add an Authorization header or an API key to the client config: the server signs you in with OAuth, and the login page asks for your GivingFuel credentials.

Step-by-step setup, where to find your credentials, and FAQ: https://usefulapi.io/givingfuel/

On first connect you'll paste your GivingFuel API key (create it in your GivingFuel dashboard under Account settings → Integrations).

Tools

ToolTypeWhat it does
givingfuel_list_formsreadList donation forms
givingfuel_get_formreadGet donation form
givingfuel_get_form_inventoryreadGet form inventory
givingfuel_list_ordersreadList donation orders
givingfuel_get_orderreadGet donation order
givingfuel_list_transactionsreadList transactions
givingfuel_get_transactionreadGet transaction
givingfuel_list_subscriptionsreadList recurring gifts
givingfuel_get_subscriptionreadGet recurring gift
givingfuel_list_customersreadList donors
givingfuel_get_customerreadGet donor
givingfuel_list_couponsreadList coupons
givingfuel_get_couponreadGet coupon
givingfuel_create_couponwriteCreate coupon
givingfuel_delete_couponwriteDelete coupon
givingfuel_usage_statusmetaUsage status (free-tier meter)
givingfuel_request_featuremetaRequest a missing feature
givingfuel_upgrademetaUpgrade to Pro or Pro+
givingfuel_cancel_subscriptionmetaCancel the Pro subscription

read tools are read-only; write tools mutate data (clients should confirm them); meta tools report usage, manage your subscription or send a feature request.

Pricing

PlanPriceLimit
Free$050 tool calls / month
Pro (per user)$9/mo or $90/yr (2 months free)Unlimited*

*Pro has a fair use limit of 10,000 tool calls a month on this server. For more, write to [email protected].

Pro covers this server only. Subscribe with givingfuel_upgrade (it returns a Stripe Checkout link). Cancel any time with givingfuel_cancel_subscription: Pro continues to the end of the paid period, with no refund for the current period, and running givingfuel_upgrade before then undoes the cancel. Or write to [email protected].

License

MIT © usefulapi. Not affiliated with or endorsed by GivingFuel.

Source: servers/givingfuel/README.md at commit 4046075

Tools

15

givingfuel_list_forms

List donation forms

List the account's GivingFuel forms (donation / fundraising pages): id, name, status (open or closed), created and updated dates. Use the form ids to filter orders, transactions and subscriptions. GET /forms.

Parameterssortlimitcreated_afterupdated_aftercreated_beforestarting_afterupdated_before

givingfuel_get_form

Get donation form

One form by id: name, status, accounting reference, time zone and its field layout. GET /forms/{id}.

Parametersform_idrequired

givingfuel_get_form_inventory

Get form inventory

Inventory items of a form (limited-quantity items): path, name, sold and remaining quantity. GET /forms/{id}/inventory.

Parametersform_idrequired

givingfuel_list_orders

List donation orders

List donation orders (one per checkout): order number, donor billing name and address, form, total, currency and status, newest or oldest first. Filter by form, status, donor email, customer id, order number or dates. GET /search/orders.

Parameterssortemaillimitstatusform_idcustomer_idorder_numbercreated_afterupdated_aftercreated_beforestarting_afterupdated_before

givingfuel_get_order

Get donation order

One order by id with the donor's billing details, form, totals and status. Set include_transactions to embed the payments (charges and refunds) of the order. GET /search/orders/{id}.

Parametersorder_idrequiredinclude_transactions

givingfuel_list_transactions

List transactions

List payment transactions (money movements): amount, deductible amount, currency, type (charge, refund, voucher), payment method, masked card, status, form and donor email. Filter by type, method, form, order, donor or dates. GET /search/transactions.

Parameterssorttypeemaillimitstatusform_idorder_idreferencecustomer_idorder_numbercreated_afterupdated_after+4 more

givingfuel_get_transaction

Get transaction

One transaction by id: amounts, type, payment method, masked card, gateway message and status. GET /search/transactions/{id}.

Parameterstransaction_idrequired

givingfuel_list_subscriptions

List recurring gifts

List recurring donations (subscriptions): amount, schedule, status, last and next payment date, payments remaining, form and donor email. Filter by form, status, donor, or next/last payment date. GET /search/subscriptions.

Parameterssortemaillimitstatusform_idorder_idcustomer_idorder_numbercreated_afterupdated_aftercreated_beforestarting_after+3 more

givingfuel_get_subscription

Get recurring gift

One recurring donation by id: amount, schedule, status, last and next payment, payments remaining. GET /search/subscriptions/{id}.

Parameterssubscription_idrequired

givingfuel_list_customers

List donors

List customer records (donors): id, email, billing name and address, lifetime amount, created and updated dates. Filter by email or dates. New donors can take up to 5 minutes to appear. GET /search/customers.

Parameterssortemaillimitcreated_afterupdated_aftercreated_beforestarting_afterupdated_before

givingfuel_get_customer

Get donor

One donor (customer record) by id: email, billing details and total amount. GET /search/customers/{id}.

Parameterscustomer_idrequired

givingfuel_list_coupons

List coupons

List GivingFuel coupons: account-wide ones, or only those of one form when form_id is given. Shows discounts, codes, availability, redeemed count and expiry. GET /coupons/global or /coupons/forms/{id}.

Parameterscodesortlimitform_idstarting_after

givingfuel_get_coupon

Get coupon

One coupon by id with its discounts, codes, availability and redeemed counts. GET /coupons/{id}.

Parameterscoupon_idrequired

givingfuel_create_coupon

Create coupon

WRITE: create a discount coupon in the live GivingFuel account (it can be redeemed by donors right away). One discount (fixed amount or percent) and one or more codes; optionally limited to one form, to a number of uses, and to an expiry date. Not idempotent: calling it twice creates two coupons. POST /coupons.

Parametersnamerequiredcodesrequiredexpiresform_idcurrencyavailablediscount_typerequireddiscount_valuerequired

givingfuel_delete_coupon

Delete coupon

WRITE: permanently delete a coupon from the live GivingFuel account; its codes stop working immediately and this cannot be undone. Show the coupon (givingfuel_get_coupon) and get the user's approval first, then call with confirm: true. GET /coupons/{id}, then DELETE /coupons/{id}.

Parametersconfirmrequiredcoupon_idrequired

Version history

14
  1. v1.15.4LatestNov 7, 2026
  2. v1.14.3Nov 5, 2026
  3. v1.14.2Nov 5, 2026
  4. v1.14.1Nov 4, 2026
  5. v1.14.0Nov 3, 2026
  6. v1.13.1Nov 3, 2026
  7. v1.12.0Nov 1, 2026
  8. v1.10.0Oct 31, 2026
  9. v1.9.0Oct 31, 2026
  10. v1.8.2Oct 30, 2026
  11. v1.8.0Oct 30, 2026
  12. v1.3.0Oct 26, 2026
  13. v1.0.3Oct 25, 2026
  14. v1.0.0Oct 25, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Usefulapi integrations