MCP server
Gift Up! MCP by usefulapi
Read Gift Up! gift cards, orders, items, promotions and transactions (read-only, codes…
- 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/mcpAdd to Settings → Connectors → Add custom connector
https://gift-up.usefulapi.io/mcpInstall 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