list_item_groups
List Item Groups
List all item groups configured in the account. Item groups organize items in the checkout.
Ask your agent in plain language. Each of these maps to a real tool on the server.
list_item_groups
List all item groups configured in the account. Item groups organize items in the checkout.
top_up_gift_card
Add credit or units to an existing gift card's balance.
reactivate_gift_card
Reactivate a previously voided gift card, restoring it to an active state so it can be redeemed again.
list_transactions
Retrieve financial transactions for orders and gift cards. Filter by occurrence dates, events, user emails, gift card code, and locations. Returns full financial details and pagination state.
undo_redemption
Reverse a previous gift card redemption using its transaction ID. Restores the redeemed amount/units back to the gift card balance.
get_company
Identify the company/account authorized by the API key, including its ID, name, currency, and onboarding status.
get_gift_card
Retrieve a gift card by its code. Returns the full gift card details including balance, status, recipient info, and redemption eligibility.
create_order
Create a new order containing one or more gift cards. Supports recipient details with scheduled email delivery, custom fields, sales taxes, discounts, tips, and metadata.
list_items
List all items (products) available for sale in the Gift Up! checkout. Optionally filter by item group.
list_gift_cards
Search and list gift cards with flexible filtering by status, dates, email, SKU, or order. Supports pagination for large result sets.
update_gift_card
Update properties of a gift card such as title, expiry date, valid-from date, recipient details, SKU, and terms. Only provide the fields you want to change.
manage_item_group
Create a new item group or update an existing one. Item groups organize items in the checkout.
delete_item
Permanently delete an item (product) from the Gift Up! checkout. This action cannot be undone.
void_gift_card
Void a gift card, preventing it from being redeemed. The card can be reactivated later if needed.
delete_item_group
Permanently delete an item group. This action cannot be undone.
manage_item
Create a new item (product) for sale in the Gift Up! checkout, or update an existing item. Items define the gift card products available for purchase, including pricing, value, stock, and expiry settings.
update_order
Update order details, add notes, or mark a postal order as posted. Supports updating purchaser info, adding annotations, and marking physical gift cards as shipped.
redeem_gift_card
Redeem a gift card either partially (by specifying an amount or units) or in full. Returns the transaction ID and remaining balance. Use the **redeemInFull** flag to redeem the entire balance, or specify an **amount**/**units** for a partial redemption.
list_locations
List all physical locations configured in the account. Locations are used for tracking where gift cards are sold or redeemed.
get_order
Retrieve full order details by order ID, including gift cards, purchaser info, revenue, custom fields, notes, and download links.
transfer_balances
Transfer balances from one or more source gift cards to a single destination gift card. The source cards will be emptied and the destination card will receive the combined balance.
get_transaction
Retrieve a financial transaction by ID, including its order, gift card, financial changes, actor, and metadata. IDs are returned by list_transactions and balance operations.
get_shipping_settings
Discover delivery methods and shipping option IDs, prices, and country restrictions for create_order.
get_item_group
Retrieve an item group by ID. Call list_item_groups to discover group IDs.
get_item
Retrieve an item and its pricing, balances, stock, codes, availability, and expiry settings. Call list_items to discover item IDs.
list_promotions
List checkout promotions with their benefits, triggers, usage, and limitations.
list_orders
Find orders by creation date, purchaser email, or source. Returns order IDs and full details for get_order and update_order, with pagination state.
Every client uses the same Magic MCP URL, and so does any other MCP client. Add it once and sign in with SSO.
{"mcpServers": {"metorial": {"url": "<your-magic-mcp-url>"}}}
claude mcp add --transport http metorial <your-magic-mcp-url>
codex mcp add metorial --url <your-magic-mcp-url>codex mcp login metorial
One governed layer for every app your agents reach, not a separate connector per tool.
Create, manage, redeem, and track Gift Up! gift cards and orders. Manage checkout items and item groups, transfer and top up balances, inspect financial transactions and promotions, and discover company, location, and shipping details.
Common questions about connecting Gift up to AI agents with Metorial.