VTEX GiftCard Hub MCP connector

VTEX GiftCard Hub is VTEX's central platform for managing gift card providers and processing gift card operations across multiple providers in e-commerce environments. The VTEX GiftCard Hub MCP connector allows AI agents to configure and manage gift card providers, create and retrieve gift cards, and process transactions including purchases and cancellations. It also supports querying transaction histories and managing gift card balances across all connected providers in a VTEX account.

Authentication type

• API Key - Requires a static API key to be configured before the agent can connect to the service.

Uses

Use the VTEX GiftCard Hub MCP connector to perform the following actions:

• Activate and manage multiple gift card providers within a single platform instance
• Create and issue gift cards across different provider networks simultaneously
• Track gift card transactions, authorizations, and settlement activities in real time
• Process gift card cancellations and refunds through integrated provider systems
• Retrieve complete gift card transaction history for audit and reconciliation purposes
• Configure provider-specific settings and credentials without manual intervention
• Monitor gift card balances and transaction statuses across all active providers

Example prompts

Use the following example prompts to invoke VTEX GiftCard Hub MCP connector tools from your AI assistant or Boomi Connect workflow:

• Show me all gift card providers currently configured in VTEX GiftCard Hub.
• Create a new gift card in VTEX GiftCard Hub for provider Acme Cards.
• List all gift card transactions from the last 30 days in VTEX GiftCard Hub.
• Get the balance and transaction history for gift card ABC123 in VTEX GiftCard Hub.
• Process a cancellation transaction for gift card XYZ789 in VTEX GiftCard Hub.
• Find all settlement transactions completed this month in VTEX GiftCard Hub.
• Retrieve the authorization details for the most recent transaction in VTEX GiftCard Hub.
• Delete the inactive provider configuration from VTEX GiftCard Hub.
• Create a settlement batch for pending transactions in VTEX GiftCard Hub.
• Show me all cancellation requests submitted today in VTEX GiftCard Hub.

VTEX GiftCard Hub MCP connector tools

The VTEX GiftCard Hub MCP connector provides the following tools. Each tool maps to a specific action you can invoke from your AI agent or automation.

Tool	Description
ListAllGiftCardProviders	Retrieves a complete list of all registered gift card providers in the system.
DeleteGiftCardProviderbyID	Removes a gift card provider and its associated data from the system.
Create/UpdateGiftCardProviderbyID	Creates a new gift card provider or modifies an existing one by its identifier.
CreateGiftCardinGiftCardProvider	Generates a new gift card within a specified gift card provider.
GetGiftCardfromGiftCardProvider	Retrieves gift card details from a provider using search or filter criteria.
GetGiftCardfromGiftCardProviderbyID	Fetches information for a specific gift card by its unique identifier.
ListAllGiftCardTransactions	Displays all gift card transaction records in the system.
CreateGiftCardTransaction	Records a new gift card transaction such as a purchase or redemption.
ListAllGiftCardCancellationTransactions	Shows all cancellation transactions related to gift cards.
CreateGiftCardCancellationTransaction	Records a cancellation transaction for an existing gift card.
ListAllGiftCardSettlementTransactions	Displays all settlement transactions for gift card operations.
CreateGiftCardSettlementTransaction	Records a settlement transaction to finalize gift card financial activity.
GetGiftCardTransactionbyID	Retrieves details of a specific gift card transaction by its identifier.
GetGiftCardAuthorizationTransaction	Fetches authorization transaction records for gift card verification and approval.
GetGiftCardProviderbyID	Retrieves configuration and details for a specific gift card provider.