# Gift Up! MCP by usefulapi

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

- **Kind:** MCP server
- **Website:** https://usefulapi.io/gift-up/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/gift-up
- **MCP Registry name:** io.usefulapi/gift-up
- **Listing updated:** 2026-11-13

## About

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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://gift-up.usefulapi.io/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "gift-up": {
      "url": "https://gift-up.usefulapi.io/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

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

## 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

---
Source: https://ai-powered.com/mcp/gift-up-mcp-by-usefulapi
