Skip to content
MCP server

Gift Up! MCP by usefulapi

Read Gift Up! gift cards, orders, items, promotions and transactions (read-only, codes…

Install
Runs
Remotely
Version
1.27.0
Listing updated
4 days ago

About Gift Up! MCP by usefulapi

Gift Up! MCP by usefulapi is an MCP server. It runs as a hosted remote server, so there is nothing to install locally.

Read Gift Up! gift cards, orders, items, promotions and transactions (read-only, codes masked).

Install

Run in a terminal

claude mcp add --transport http gift-up https://gift-up.usefulapi.io/mcp

Add to Settings → Connectors → Add custom connector

https://gift-up.usefulapi.io/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "gift-up": {
      "url": "https://gift-up.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": {
    "gift-up": {
      "type": "http",
      "url": "https://gift-up.usefulapi.io/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "gift-up": {
      "serverUrl": "https://gift-up.usefulapi.io/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

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

Tools this server provides (13)

Read directly from the server.

giftup_get_company
The Gift Up account this API key belongs to: id, name, currency, whether onboarding is complete and whether the checkout is live. GET /company.
giftup_list_gift_cards
List gift cards with balance, status flags (canBeRedeemed, hasExpired, notYetValid, isVoided), title, recipient, expiry and the order they came from. Codes are MASKED (at least 6 characters stay hidden); to see one card in full (code and ledger) use giftup_get_gift_card with its code. Filter by state, creation/update time, order, SKU, recipient/purchaser email or payment transaction id. GET /gift-
giftup_get_gift_card
One gift card by its code: balance (remainingValue / remainingUnits), status flags, expiry, recipient, order, fulfilment and the full ledger of events (created, redeemed, topped up, voided). Returns the code in full because you asked for this card by code; do not repeat it elsewhere. Read-only: it never redeems or changes the card. GET /gift-cards/{code}.
giftup_list_orders
List orders (the purchases that created gift cards), newest first: order number, purchaser, revenue, tip, fees, discount, applied promotions, source, notes, metadata and payment provider. Filter by creation time, purchaser email or source. GET /orders.
giftup_get_order
One order by id: totals, purchaser, promotions, custom fields, sales taxes, notes, metadata and payment provider. GET /orders/{id}.
giftup_list_items
List the gift card products on sale (items): name, price, value, price type, availability window, group, stock level, per-order limit, SKU and terms. Pre-generated codes are reduced to a count and masked tails. Optionally only one group. GET /items.
giftup_get_item
One item (gift card product) by id. Pre-generated codes are reduced to a count and masked tails. GET /items/{id}.
giftup_list_item_groups
List item groups (the sections that organize items in the checkout): id, name, description, sort order, auto-expand. GET /groups.
giftup_get_item_group
One item group by id. GET /groups/{id}.
giftup_list_locations
List the locations (stores) of the account; their ids filter and label report transactions. GET /locations.
giftup_list_promotions
List promotions (checkout discounts and bonus credit): name, published/stopped dates, benefits (percentage and fixed discounts, extra credit), usage counts and revenue, limitations and triggers (items, groups, spend and quantity thresholds, promo code). Read-only. GET /promotions.
giftup_list_transactions
The immutable financial transaction log: OrderPlaced (income, fees, tip), GiftCardCreated, CreditAdded, Redeemed, Expired, Unexpired, Voided, Reactivated, with who, where, reason, Gift Up fee and the value change. Gift card codes are MASKED (at least 6 characters stay hidden). Filter by time range, event type, user email, location id or one gift card code. GET /reports/transactions.
giftup_get_transaction
One report transaction by id. The gift card code inside is MASKED (at least 6 characters stay hidden). GET /reports/transactions/{id}.

Gift Up! MCP by usefulapi FAQ

How do I add Gift Up! MCP by usefulapi to Claude Code?

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