GivingFuel MCP by usefulapi

io.usefulapi由 usefulapi.io 發布官方發布者v1.15.4更新於 Nov 7, 2026

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

發布方自己的服務:Ably MCP by usefulapi

已驗證Streamable HTTP可網頁執行金融資料與分析商業與電商

概覽

AI 產生的概覽

透過託管的遠端端點讀取 GivingFuel 的捐款表單、訂單、交易、定期捐款與捐款人,並可管理優惠券。

可以做什麼
  • 列出並檢視捐款表單,包含表單欄位配置與限量品項庫存
  • 列出並取得捐款訂單,含捐款人帳單資訊、總額及可選的關聯付款
  • 列出並取得付款交易,含金額、可抵扣金額、類型、遮罩卡號與狀態
  • 列出並取得定期捐款,含週期、狀態與下次付款日期
  • 列出並取得捐款人紀錄及終身金額,列出或取得優惠券
  • 在正式帳戶中建立或永久刪除折扣優惠券
適用情境
適合募款與非營利團隊用自然語言查詢 GivingFuel 資料,例如某段期間募到多少、來自哪些表單、哪些定期捐款即將扣款,或某位捐款人捐過什麼。也方便查詢或發放優惠碼。
執行需求
遠端 MCP 端點,不需本機套件或執行環境。僅填入網址連線,並透過伺服器的 OAuth 流程登入,登入頁會要求 GivingFuel 憑證。首次連線時需貼上在 GivingFuel 後台「帳戶設定」建立的 API 金鑰。超出免費每月呼叫額度後需付費方案。
安裝前請注意
建立與刪除優惠券會直接作用於正式 GivingFuel 帳戶:新優惠券可立即被捐款人使用,刪除無法復原,重複呼叫會產生兩張優惠券。捐款人姓名、電子郵件、地址與付款資訊會提供給助理。伺服器會統計呼叫次數並提供含付款連結的付費方案,呼叫可能導致訂閱扣款。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 GivingFuel MCP by usefulapi,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable,透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式,或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南,先向你展示發布者、端點和登入方式,經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.usefulapi%2Fgivingfuel/install.md,並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前,先告訴我它的發布者、端點和登入方式,等我確認。不要把 API 金鑰寫進命令或我會提交的檔案;問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "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.

來源:servers/givingfuel/README.md,提交 4046075

工具

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.

輸入參數sortlimitcreated_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}.

輸入參數form_id必填

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.

輸入參數form_id必填

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.

輸入參數sortemaillimitstatusform_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}.

輸入參數order_id必填include_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.

輸入參數sorttypeemaillimitstatusform_idorder_idreferencecustomer_idorder_numbercreated_afterupdated_after另有 4 個

givingfuel_get_transaction

Get transaction

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

輸入參數transaction_id必填

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.

輸入參數sortemaillimitstatusform_idorder_idcustomer_idorder_numbercreated_afterupdated_aftercreated_beforestarting_after另有 3 個

givingfuel_get_subscription

Get recurring gift

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

輸入參數subscription_id必填

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.

輸入參數sortemaillimitcreated_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}.

輸入參數customer_id必填

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

輸入參數codesortlimitform_idstarting_after

givingfuel_get_coupon

Get coupon

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

輸入參數coupon_id必填

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.

輸入參數name必填codes必填expiresform_idcurrencyavailablediscount_type必填discount_value必填

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

輸入參數confirm必填coupon_id必填

版本歷史

14
  1. v1.15.4最新Nov 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

評分

已滿足適用檢查項的 100%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

其他 Usefulapi 整合