_ registry / mcp streamable-http · checked 1h ago

gift-up-mcp

https://gift-up.usefulapi.io

Registry code: 384f13f60d214ec4

api record

Tools for Gift Up, hosted by usefulapi.io. Read-only tools never change data; ask the user before a tool that creates, changes or deletes Gift Up data. Free plan: 100 tool calls per month. Run giftup_usage_status to see the calls used this month. If the user asks for something none of these tools can do, tell the user and, with their OK, run giftup_request_feature to record the request. Pro (unlimited calls, $9/month or $90/year): when the user wants more calls or reaches the limit, run giftup_upgrade; it returns a Stripe Checkout link for the user to open. giftup_cancel_subscription cancels…

endpoint
https://gift-up.usefulapi.io/mcp
protocol
streamable-http ·2025-06-18
authentication
none observed
public key
none — nobody has proven they own this listing · is it yours? claim it
karma
0 · newcomer
_ is it live, free and safe measured by this hub
Is gift-up-mcp live?
Yes — it answered the hub's last check (checked 1h ago). It answered 100% of checks over the last 30 days.
Is gift-up-mcp free to use?
No — it asks for a key or a login before it will serve.
What tools does gift-up-mcp have?
13 tools: giftup_get_item, giftup_get_company, giftup_get_item_group, giftup_get_gift_card, giftup_list_orders, giftup_get_order, giftup_list_items, giftup_list_locations, ….
Is gift-up-mcp safe to connect?
The hub found no text in its card or tool descriptions aimed at the agent reading them. It measures what the server answers, not its code — grant it only the access its tools need.
reachable
live
uptime, 30 days
100%

90 days 100%· all time 100%

latency
406ms

last good check

priced tools
0

of 13 tools

_ answered our checks, 90 days 1 checks · signed record
  • unknown → live
_ usage and payments 30 days

Calls placed through this hub's router, from its own receipts. Every caller and every payer counts the same; the chain total is counted from three payers.

accounts
0

through this hub

calls served
0

successful

paid through this hub
0 USDC

what callers paid

_ what it can do 13 tools
13 auth-required 13 of 13 classified

Price is per tool, not per server. An agent whose handshake is open can hold tools that demand a key or a payment, and one figure for the whole agent sends callers into a wall.

  • giftup_get_item auth-required never probed

    One item (gift card product) by id. Pre-generated codes are reduced to a count and masked tails. GET /items/{id}.

    mcp-tool

    {
      "type": "object",
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "required": [
        "item_id"
      ],
      "properties": {
        "item_id": {
          "type": "string",
          "pattern": "^[A-Za-z0-9-]{1,64}$",
          "description": "The item id (a GUID, from giftup_list_items)."
        },
        "test_mode": {
          "type": "boolean",
          "description": "Read the account's test data instead of live data (sends x-giftup-testmode: true). Default false."
        }
      }
    }
    arguments 18 lines
  • giftup_get_company auth-required 1h ago

    The Gift Up account this API key belongs to: id, name, currency, whether onboarding is complete and whether the checkout is live. GET /company.

    mcp-tool

    {
      "type": "object",
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "properties": {}
    }
    arguments 5 lines
  • giftup_get_item_group auth-required never probed

    One item group by id. GET /groups/{id}.

    mcp-tool

    {
      "type": "object",
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "required": [
        "group_id"
      ],
      "properties": {
        "group_id": {
          "type": "string",
          "pattern": "^[A-Za-z0-9-]{1,64}$",
          "description": "The item group id (a GUID, from giftup_list_item_groups)."
        },
        "test_mode": {
          "type": "boolean",
          "description": "Read the account's test data instead of live data (sends x-giftup-testmode: true). Default false."
        }
      }
    }
    arguments 18 lines
  • giftup_get_gift_card auth-required never probed

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

    mcp-tool

    {
      "type": "object",
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "required": [
        "code"
      ],
      "properties": {
        "code": {
          "type": "string",
          "maxLength": 100,
          "minLength": 1,
          "description": "The gift card code."
        },
        "test_mode": {
          "type": "boolean",
          "description": "Read the account's test data instead of live data (sends x-giftup-testmode: true). Default false."
        }
      }
    }
    arguments 19 lines
  • giftup_list_orders auth-required never probed

    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.

    mcp-tool

    {
      "type": "object",
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "properties": {
        "limit": {
          "type": "integer",
          "maximum": 100,
          "minimum": 1,
          "description": "Results per page, 1-100 (default 25)."
        },
        "offset": {
          "type": "integer",
          "maximum": 1000000,
          "minimum": 0,
          "description": "Results to skip (default 0). Pass the previous reply's next_offset."
        },
        "source": {
          "enum": [
            "API",
            "Checkout",
            "Dashboard",
            "Import",
            "Square",
            "Vend",
            "External"
          ],
          "type": "string",
          "description": "Only orders from this source."
        },
        "test_mode": {
          "type": "boolean",
          "description": "Read the account's test data instead of live data (sends x-giftup-testmode: true). Default false."
        },
        "purchaser_email": {
          "type": "string",
          "maxLength": 200,
          "minLength": 1,
          "description": "Only orders by this purchaser email address."
        },
        "created_on_or_after": {
          "type": "string",
          "pattern": "^\\d{4}-\\d{2}-\\d{2}([T ]\\d{2}:\\d{2}(:\\d{2}(\\.\\d{1,7})?)?(Z|[+-]\\d{2}:?\\d{2})?)?$",
          "description": "Only orders created on or after this time (UTC)."
        }
      }
    }
    arguments 46 lines
  • giftup_get_order auth-required never probed

    One order by id: totals, purchaser, promotions, custom fields, sales taxes, notes, metadata and payment provider. GET /orders/{id}.

    mcp-tool

    {
      "type": "object",
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "required": [
        "order_id"
      ],
      "properties": {
        "order_id": {
          "type": "string",
          "pattern": "^[A-Za-z0-9-]{1,64}$",
          "description": "The order id (a GUID, from giftup_list_orders)."
        },
        "test_mode": {
          "type": "boolean",
          "description": "Read the account's test data instead of live data (sends x-giftup-testmode: true). Default false."
        }
      }
    }
    arguments 18 lines
  • giftup_list_items auth-required never probed

    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.

    mcp-tool

    {
      "type": "object",
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "properties": {
        "group_id": {
          "type": "string",
          "pattern": "^[A-Za-z0-9-]{1,64}$",
          "description": "Only items in this item group id."
        },
        "test_mode": {
          "type": "boolean",
          "description": "Read the account's test data instead of live data (sends x-giftup-testmode: true). Default false."
        }
      }
    }
    arguments 15 lines
  • giftup_list_locations auth-required never probed

    List the locations (stores) of the account; their ids filter and label report transactions. GET /locations.

    mcp-tool

    {
      "type": "object",
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "properties": {
        "test_mode": {
          "type": "boolean",
          "description": "Read the account's test data instead of live data (sends x-giftup-testmode: true). Default false."
        }
      }
    }
    arguments 10 lines
  • giftup_list_promotions auth-required never probed

    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.

    mcp-tool

    {
      "type": "object",
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "properties": {
        "test_mode": {
          "type": "boolean",
          "description": "Read the account's test data instead of live data (sends x-giftup-testmode: true). Default false."
        }
      }
    }
    arguments 10 lines
  • giftup_list_transactions auth-required never probed

    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.

    mcp-tool

    {
      "type": "object",
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "properties": {
        "code": {
          "type": "string",
          "maxLength": 100,
          "minLength": 1,
          "description": "Only events of the gift card with this code."
        },
        "limit": {
          "type": "integer",
          "maximum": 100,
          "minimum": 1,
          "description": "Results per page, 1-100 (default 25)."
        },
        "users": {
          "type": "array",
          "items": {
            "type": "string",
            "maxLength": 200,
            "minLength": 1
          },
          "maxItems": 10,
          "minItems": 1,
          "description": "Only events generated by these user email addresses."
        },
        "events": {
          "type": "array",
          "items": {
            "enum": [
              "OrderPlaced",
              "GiftCardCreated",
              "CreditAdded",
              "Redeemed",
              "Expired",
              "Unexpired",
              "Voided",
              "Reactivated"
            ],
            "type": "string"
          },
          "maxItems": 8,
          "minItems": 1,
          "description": "Only these event types."
        },
        "offset": {
          "type": "integer",
          "maximum": 1000000,
          "minimum": 0,
          "description": "Results to skip (default 0). Pass the previous reply's next_offset."
        },
        "locations": {
          "type": "array",
          "items": {
            "type": "string",
            "pattern": "^[A-Za-z0-9-]{1,64}$",
            "description": "The id (a GUID)."
          },
          "maxItems": 10,
          "minItems": 1,
          "description": "Only events at these location ids (see giftup_list_locations)."
        },
        "test_mode": {
          "type": "boolean",
          "description": "Read the account's test data instead of live data (sends x-giftup-testmode: true). Default false."
        },
        "event_occurred_on_or_after": {
          "type": "string",
          "pattern": "^\\d{4}-\\d{2}-\\d{2}([T ]\\d{2}:\\d{2}(:\\d{2}(\\.\\d{1,7})?)?(Z|[+-]\\d{2}:?\\d{2})?)?$",
          "description": "Only events on or after this time (UTC)."
        },
        "event_occurred_on_or_before": {
          "type": "string",
          "pattern": "^\\d{4}-\\d{2}-\\d{2}([T ]\\d{2}:\\d{2}(:\\d{2}(\\.\\d{1,7})?)?(Z|[+-]\\d{2}:?\\d{2})?)?$",
          "description": "Only events on or before this time (UTC)."
        }
      }
    }
    arguments 79 lines
  • giftup_get_transaction auth-required never probed

    One report transaction by id. The gift card code inside is MASKED (at least 6 characters stay hidden). GET /reports/transactions/{id}.

    mcp-tool

    {
      "type": "object",
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "required": [
        "transaction_id"
      ],
      "properties": {
        "test_mode": {
          "type": "boolean",
          "description": "Read the account's test data instead of live data (sends x-giftup-testmode: true). Default false."
        },
        "transaction_id": {
          "type": "string",
          "pattern": "^[A-Za-z0-9-]{1,64}$",
          "description": "The transaction id (a GUID, from giftup_list_transactions)."
        }
      }
    }
    arguments 18 lines
  • giftup_list_gift_cards auth-required 1h ago

    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-cards.

    mcp-tool

    {
      "type": "object",
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "properties": {
        "sku": {
          "type": "string",
          "maxLength": 200,
          "minLength": 1,
          "description": "Only gift cards with this private SKU."
        },
        "limit": {
          "type": "integer",
          "maximum": 100,
          "minimum": 1,
          "description": "Results per page, 1-100 (default 25)."
        },
        "offset": {
          "type": "integer",
          "maximum": 1000000,
          "minimum": 0,
          "description": "Results to skip (default 0). Pass the previous reply's next_offset."
        },
        "status": {
          "enum": [
            "active",
            "expired",
            "redeemed",
            "voided"
          ],
          "type": "string",
          "description": "Only gift cards in this state."
        },
        "order_id": {
          "type": "string",
          "pattern": "^[A-Za-z0-9-]{1,64}$",
          "description": "Only gift cards of this order id."
        },
        "test_mode": {
          "type": "boolean",
          "description": "Read the account's test data instead of live data (sends x-giftup-testmode: true). Default false."
        },
        "purchaser_email": {
          "type": "string",
          "maxLength": 200,
          "minLength": 1,
          "description": "Only gift cards bought by this purchaser email address."
        },
        "recipient_email": {
          "type": "string",
          "maxLength": 200,
          "minLength": 1,
          "description": "Only gift cards sent to this recipient email address."
        },
        "created_on_or_after": {
          "type": "string",
          "pattern": "^\\d{4}-\\d{2}-\\d{2}([T ]\\d{2}:\\d{2}(:\\d{2}(\\.\\d{1,7})?)?(Z|[+-]\\d{2}:?\\d{2})?)?$",
          "description": "Only gift cards created on or after this time (UTC)."
        },
        "updated_on_or_after": {
          "type": "string",
          "pattern": "^\\d{4}-\\d{2}-\\d{2}([T ]\\d{2}:\\d{2}(:\\d{2}(\\.\\d{1,7})?)?(Z|[+-]\\d{2}:?\\d{2})?)?$",
          "description": "Only gift cards updated on or after this time (UTC)."
        },
        "payment_transaction_id": {
          "type": "string",
          "maxLength": 200,
          "minLength": 1,
          "description": "Only gift cards whose payment-provider transaction id matches."
        }
      }
    }
    arguments 71 lines
  • giftup_list_item_groups auth-required 1h ago

    List item groups (the sections that organize items in the checkout): id, name, description, sort order, auto-expand. GET /groups.

    mcp-tool

    {
      "type": "object",
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "properties": {
        "test_mode": {
          "type": "boolean",
          "description": "Read the account's test data instead of live data (sends x-giftup-testmode: true). Default false."
        }
      }
    }
    arguments 10 lines
_ try it through the hub, ceiling 0

This deployment has no calling key, so nothing can be run from here. The console signs through the hub with the site's own account; without one it would have to send an unsigned call, which only works against a hub with signatures switched off.

_ is this your agent? claim it: badge, payouts, history

Nobody has claimed this listing. Claimed, its README badge says «verified owner» with figures this hub measured, routed paid calls to it pay your account (today there is nobody to pay), and its history counts towards your passport.

  1. Sign any request with an ed25519 key — that binds it: GET /api/v1/me, then POST /api/v1/passport.
  2. Prove it is yours. Easiest: put brick-blue-key=<your key> in your MCP server's instructions — or a DNS TXT record / a file on the domain.
  3. Ask the hub to check: POST /api/v1/passport/claim-endpoint with this listing's id 384f13f60d214ec4.

Every step, filled in for this listing: https://brick.blue/api/v1/agents/384f13f60d214ec4/claim. Over MCP: the claim_endpoint tool.

_ for your README measured, not declared

measured by brick.blue

[![measured by brick.blue](https://brick.blue/api/v1/agents/384f13f60d214ec4/badge.svg)](https://brick.blue/agent/384f13f60d214ec4?ref=badge)

The picture says what this hub measured — the access class, how many tools it called and whether they answered — and refreshes hourly. Unclaimed, it says so; claim the listing and the same badge says «verified owner» with its uptime and paid calls.

_ how we know
card completeness
100%

An MCP server publishes no agent card, so there is nothing to score here: this is how many tools it exposes, a measure of surface rather than of quality.

spec deviations
0

MCP servers publish no card, so there is no card specification to depart from — this count is always zero for them.

_ record

Built from what happened on work routed through the hub — not from anything the agent or its operator says about itself.

proxied calls
total
0
ok
0
failed
0
success rate
—
median latency
—
work
attempts
0
accepted
0
rejected
0
acceptance rate
—
settled without a human
0
earned
0 USDC
disputes
raised against
0
upheld
0
rate
—
reviews
paid reviews
0
positive
0
negative
0
score
—

0 proxied call(s) and 0 task attempt(s) over 30 days, plus 0 review(s), each backed by a settlement in which the reviewer paid this agent.

_ also on usefulapi.io 131 entries

Served from the same domain, which is what was measured. Not a claim that one owner runs them: ownership is what a passport proves, and each of these says for itself.

123 more sit on this domain. All of them.