MCP server
GivingFuel MCP by usefulapi
Read GivingFuel forms, donations, transactions, recurring gifts and donors; manage…
- Runs
- Remotely
- Version
- 1.19.0
- Listing updated
- 4 days ago
About GivingFuel MCP by usefulapi
GivingFuel MCP by usefulapi is an MCP server. It runs as a hosted remote server, so there is nothing to install locally.
Read GivingFuel forms, donations, transactions, recurring gifts and donors; manage coupons.
Install
Run in a terminal
claude mcp add --transport http givingfuel https://givingfuel.usefulapi.io/mcpAdd to Settings → Connectors → Add custom connector
https://givingfuel.usefulapi.io/mcpInstall in CursorOpens Cursor, which asks you to confirm. Or add it by hand:
Add to ~/.cursor/mcp.json
{
"mcpServers": {
"givingfuel": {
"url": "https://givingfuel.usefulapi.io/mcp"
}
}
}Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:
Add to .vscode/mcp.json
{
"servers": {
"givingfuel": {
"type": "http",
"url": "https://givingfuel.usefulapi.io/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"givingfuel": {
"serverUrl": "https://givingfuel.usefulapi.io/mcp"
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"givingfuel": {
"type": "http",
"url": "https://givingfuel.usefulapi.io/mcp"
}
}
}Tools this server provides (15)
Read directly from the server.
- givingfuel_list_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.
- givingfuel_get_form
- One form by id: name, status, accounting reference, time zone and its field layout. GET /forms/{id}.
- givingfuel_get_form_inventory
- Inventory items of a form (limited-quantity items): path, name, sold and remaining quantity. GET /forms/{id}/inventory.
- givingfuel_list_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.
- givingfuel_get_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}.
- givingfuel_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.
- givingfuel_get_transaction
- One transaction by id: amounts, type, payment method, masked card, gateway message and status. GET /search/transactions/{id}.
- givingfuel_list_subscriptions
- 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.
- givingfuel_get_subscription
- One recurring donation by id: amount, schedule, status, last and next payment, payments remaining. GET /search/subscriptions/{id}.
- givingfuel_list_customers
- 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.
- givingfuel_get_customer
- One donor (customer record) by id: email, billing details and total amount. GET /search/customers/{id}.
- givingfuel_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}.
- givingfuel_get_coupon
- One coupon by id with its discounts, codes, availability and redeemed counts. GET /coupons/{id}.
- givingfuel_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.
- givingfuel_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}.
GivingFuel MCP by usefulapi FAQ
How do I add GivingFuel MCP by usefulapi to Claude Code?
Run this command in your terminal: claude mcp add --transport http givingfuel https://givingfuel.usefulapi.io/mcp