Gift up MCP server

Connect Gift up to Claude, ChatGPT, Cursor, Claude Code, Codex, Gemini, GitHub Copilot and any other MCP client, for your whole team. Metorial adds security, governance, and tracing, and gives everyone one Magic MCP URL to connect.

What you can do with the Gift up MCP server

Ask your agent in plain language. Each of these maps to a real tool on the server.

  • Use the list item groups tool in Gift up
  • Use the top up gift card tool in Gift up
  • Use the reactivate gift card tool in Gift up
  • Use the list transactions tool in Gift up
  • Use the undo redemption tool in Gift up
  • Use the get company tool in Gift up

Supported Tools

list_item_groups

List Item Groups

List all item groups configured in the account. Item groups organize items in the checkout.

top_up_gift_card

Top Up Gift Card

Add credit or units to an existing gift card's balance.

reactivate_gift_card

Reactivate Gift Card

Reactivate a previously voided gift card, restoring it to an active state so it can be redeemed again.

list_transactions

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

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

Get Company

Identify the company/account authorized by the API key, including its ID, name, currency, and onboarding status.

get_gift_card

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

List all items (products) available for sale in the Gift Up! checkout. Optionally filter by item group.

list_gift_cards

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 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 or Update Item Group

Create a new item group or update an existing one. Item groups organize items in the checkout.

delete_item

Delete Item

Permanently delete an item (product) from the Gift Up! checkout. This action cannot be undone.

void_gift_card

Void Gift Card

Void a gift card, preventing it from being redeemed. The card can be reactivated later if needed.

delete_item_group

Delete Item Group

Permanently delete an item group. This action cannot be undone.

manage_item

Create or Update 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

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

List all physical locations configured in the account. Locations are used for tracking where gift cards are sold or redeemed.

get_order

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

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

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

Get Shipping Settings

Discover delivery methods and shipping option IDs, prices, and country restrictions for create_order.

get_item_group

Get Item Group

Retrieve an item group by ID. Call list_item_groups to discover group IDs.

get_item

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 Promotions

List checkout promotions with their benefits, triggers, usage, and limitations.

list_orders

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.

Connect Gift up to your AI client

Every client uses the same Magic MCP URL, and so does any other MCP client. Add it once and sign in with SSO.

  1. Enable Gift up in Metorial. In your Metorial portal, enable the Gift up MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
  2. Add a custom connector. Open Customize, then Connectors. Select Add, then Custom, then Web.
  3. Paste your Metorial MCP URL. Name it Metorial, paste your Magic MCP URL (<your-magic-mcp-url>) and continue.
  4. Sign in. Select Add and sign in to load Gift up tools.

Run Gift up through the Metorial gateway

One governed layer for every app your agents reach, not a separate connector per tool.

  • Give Gift up and every other app to your whole team through one MCP gateway, behind your SSO.
  • Scope which teams and agents can use Gift up tools with role-based access control, and trace every call.
  • Prefer to run it yourself? Metorial is open source and self-hostable.

More integrations teams use with Gift up

Mailchimp

Manage email marketing audiences, campaigns, and automations. Create, send, schedule, and track email campaigns with detailed reporting on opens, clicks, and bounces. Add, update, and organize audience contacts with tags, segments, and interest groups. Set up and manage automation workflows triggered by subscriber activity or events. Connect e-commerce stores to manage customers, products, orders, and carts. Create and manage reusable email templates and landing pages. Upload and organize files for use in campaigns. Send transactional emails via the Mandrill API. Post custom events to trigger targeted automations. Configure webhooks to track subscribe, unsubscribe, profile updates, and email delivery events.

Zoho

Manage Zoho CRM, Bigin, Books, Inventory, Invoice, Desk, Mail, People, and Projects from one connection. Discover organizations and accounts, manage records and financial documents, work with support tickets and email, and organize employee and project data.

Quickbooks

Manage business finances and accounting in QuickBooks Online. Create, send, and track invoices. Manage bills and accounts payable, record bill payments. Create and update customer and vendor records with contact details and hierarchies. Record payments against invoices and credit memos. Create estimates, sales receipts, and journal entries. Track expenses and categorize against the chart of accounts. Manage items, products, services, and inventory levels. Query entities using SQL-like syntax and sync incremental changes via Change Data Capture. Generate financial reports including profit and loss, balance sheet, and cash flow. Process credit card and bank account (ACH) payments via the Payments API. Manage the chart of accounts for tracking income, expenses, assets, and liabilities.

Square

Process payments, manage orders, and handle invoices for online, in-app, and in-person commerce. Create and manage customer profiles, catalog items, inventory counts, and locations. Issue refunds, manage disputes, and track payouts. Create bookings and appointments, manage team members and timecards, handle gift cards and loyalty programs, and manage subscriptions. Save cards on file, generate checkout links, connect and control Square Terminal devices, and manage vendor/supplier information. Extend Square objects with custom attributes. Receive webhook notifications for payments, orders, customers, inventory, invoices, bookings, disputes, team changes, and more.

Gumroad

Manage digital and physical product sales on Gumroad. View and update product metadata, create and manage variant categories and options, and configure discount offer codes. Retrieve and filter sales data by date range for reporting. Manage subscribers and subscription lifecycles for recurring products. Refund sales, revoke or restore buyer access, and track payouts. Verify, enable, disable, and decrement license keys for purchase validation. Draft, schedule, and send audience emails to customers and followers. Read product reviews and access authenticated user profile information.

Stripe

Process payments, manage subscriptions, and handle invoices. Create and manage customers, payment methods, and product catalogs. Issue refunds, handle disputes, and submit chargeback evidence. Create checkout sessions and payment links. Manage connected accounts and platform fund flows via Stripe Connect. Configure payouts to bank accounts and debit cards. Apply coupons and promotion codes to subscriptions and invoices. Calculate and collect taxes automatically. Access balance information and transaction history. Upload files for dispute evidence and identity verification. Create and manage virtual and physical payment cards via Issuing. Receive real-time webhook notifications for payment, subscription, invoice, and account events.

Technical notes for Gift up

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.

Frequently asked questions

Common questions about connecting Gift up to AI agents with Metorial.

  1. How many tools does the Gift up MCP server have?
    The Gift up MCP server exposes 27 tools, including List Item Groups, Top Up Gift Card, Reactivate Gift Card. Each one is governed and traced through Metorial.
  2. Gift up exposes tools your agents call on demand; it does not publish event triggers yet. Everything still runs through one governed MCP URL.
  3. Any MCP client, including VS Code, Windsurf, Zed, OpenCode and Grok. Each one reaches the Gift up MCP server through the same Metorial URL.
  4. Use role-based access control to decide which teams, users, and agents can use Gift up and which of its tools they can call.
  5. Yes. Metorial is open source, so you can run the Gift up MCP server yourself or use the hosted gateway.

Connect Gift up to production AI agents

See how Metorial gives your team governed access to Gift up, with tracing and security controls built in.