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 端点,无需本地包或运行时。仅填写 URL 连接,并通过服务器的 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 集成