MCP Server and Resource Metrics

  • Server URL: https://<domain>/loyalty/mcp
  • Total Tools: 59
  • Total Error Codes: 11

Server Overview

The MCP server provides a robust suite of 59 tools designed to manage and optimize rule engines, loyalty programs, collections, campaigns, transactions, caching, and privileges, offering comprehensive solutions for business automation, data handling, and operational efficiency.

Tools

The following table lists the available MCP tools for Loyalty service along with their descriptions and required/optional parameters:

Tool Name Tool Description Required Parameters Optional Parameters
getRuleEngineModel This tool retrieves the rule engine configuration based on provided query parameters and returns detailed responses for various statuses.
  • x-auth-token
  • x-collection-id
  • eventId
  • x-api-key
  • x-version
  • rewardType
  • locale
  • groupId
  • loyaltyId
updateDroolsRule This tool updates Drools rules for a specified collection, with various response codes indicating success or errors.
  • x-auth-token
  • x-collection-id
  • x-api-key
  • x-version
  • locale
getRuleSetById This tool loads a rule set using a unique ID, supports locale-based responses, and provides detailed success or error information.
  • x-auth-token
  • x-collection-id
  • ruleSetId
  • x-api-key
  • x-version
  • locale
replaceRuleSet This tool updates an existing rule set based on request data, with responses indicating success or various error conditions.
  • x-auth-token
  • x-collection-id
  • ruleSetId
  • x-api-key
  • name
  • startTime
  • endTime
  • status
  • x-version
  • locale
  • id
  • priority
  • createdOn
  • createdBy
  • updatedOn
  • updatedBy
  • collectionId
deleteRuleSet This tool deletes a rule set based on the provided identifier and supports various response codes for success or errors.
  • x-auth-token
  • x-collection-id
  • ruleSetId
  • x-api-key
  • x-version
  • locale
  • isHardDelete
getRuleByRuleId This tool loads a rule using specified path and query parameters, returning responses based on success or error conditions.
  • x-auth-token
  • x-collection-id
  • ruleSetId
  • ruleId
  • x-api-key
  • x-version
  • locale
replaceRuleByRuleSetId This tool updates a rule within a specified rule set and provides detailed responses for various outcomes.
  • x-auth-token
  • x-collection-id
  • ruleSetId__path
  • ruleId
  • x-api-key
  • name
  • startTime
  • endTime
  • status
  • event
  • x-version
  • locale
  • priority
  • createdBy
  • updatedBy
  • id
  • ruleSetId
  • accumulationFields
  • conditionData
  • actions
  • ruleInformation
  • stopFurtherProcessing
  • stopConditionData
  • ruleType
  • actionType
  • updatedOn
  • createdOn
deleteRuleByRuleSetId This tool deletes an existing rule based on request data, requiring `ruleSetId` and `ruleId` as path parameters, with various response codes indicating success or errors.
  • x-auth-token
  • x-collection-id
  • ruleSetId
  • ruleId
  • x-api-key
  • x-version
  • locale
  • isHardDelete
getRewardBank This tool fetches Rewards Bank details (ACTIVE or INACTIVE) using collection ID and user ID, with customizable query parameters and detailed response formats.
  • x-auth-token
  • x-collection-id
  • userId
  • x-api-key
  • x-version
  • locale
  • x-user-info
  • fullProfile
  • isUpdateTier
replaceRewardBank This tool updates all fields in the Rewards Bank based on the provided LoyaltyRequest object and returns detailed responses for success or various error scenarios.
  • x-auth-token
  • x-collection-id
  • userId
  • x-api-key
  • x-version
  • locale
  • x-user-info
updateRewardBank This tool updates specified fields in a Rewards Bank based on the provided request object and returns responses for success or various error conditions.
  • x-auth-token
  • x-collection-id
  • userId
  • x-api-key
  • x-version
  • locale
  • x-user-info
getLoyaltyEvent This tool retrieves event details using event and collection identifiers, with responses based on status codes.
  • x-auth-token
  • x-collection-id
  • id
  • x-api-key
  • x-version
  • locale
putUpdateLoyaltyEvent This tool updates an event using its unique identifier and collection ID, with responses ranging from success to various error codes.
  • x-auth-token
  • x-collection-id
  • id
  • x-api-key
  • x-version
  • locale
deleteLoyaltyEvent This tool deletes an event using event and collection identifiers, with options for locale and permanent deletion, returning various status codes and error details.
  • x-auth-token
  • x-collection-id
  • id
  • x-api-key
  • x-version
  • locale
  • isHardDelete
updateLoyaltyEvent This tool updates event fields using event and collection identifiers, with responses ranging from success to various error codes.
  • x-auth-token
  • x-collection-id
  • id
  • x-api-key
  • x-version
  • locale
getCollection This tool retrieves a collection’s details using its unique collection ID and associated parameters.
  • x-auth-token
  • id
  • businessId
  • x-api-key
  • x-version
  • locale
replaceCollection This tool updates all fields in a collection based on the provided request, using path and query parameters for identification and configuration.
  • x-auth-token
  • businessId
  • id
  • x-api-key
  • x-version
  • locale
replaceCollectionProperties This tool updates all properties of a specified collection within a microservice, with responses based on operation success or errors.
  • x-auth-token
  • id
  • businessId
  • x-api-key
  • x-version
  • locale
updateCollectionProperties This tool updates properties of an existing collection within a microservice based on provided identifiers and parameters.
  • x-auth-token
  • businessId
  • id
  • x-api-key
  • x-version
  • locale
getTransactions This tool retrieves all transactions of a loyalty collection, supports filtering, sorting, pagination, and returns detailed responses for various statuses.
  • x-auth-token
  • x-collection-id
  • x-api-key
  • x-version
  • locale
  • x-user-info
  • sort
  • filters
  • page
  • size
createTransaction This tool facilitates transaction creation with detailed parameters and response handling.
  • x-auth-token
  • x-collection-id
  • x-api-key
  • x-version
  • locale
  • mode
  • x-user-info
  • userId
  • identifier
  • userInfo
  • type
  • parentTransactionId
  • rewardType
  • voucherName
  • expiryTime
  • notes
  • eventId
  • rewardValue
  • storeId
  • channel
  • orderId
  • industryTransactionId
  • industryTransactionReference
  • industryTransactionCode
  • merchantId
  • merchantName
  • merchantCity
  • merchantState
  • merchantZipcode
  • merchantClientID
  • redemptionType
  • redemptionKey
  • redemptionValue
  • redemptionVendor
  • redemptionMethod
  • redemptionVendorId
  • effectiveDate
  • properties
  • createdOn
  • status
  • rewardModelType
  • voucher
  • userName
  • sourceSystemUniqueId
  • voucherRedemptionIds
  • rewardPointsBreakup
  • voucherProperties
  • collection_id
refreshApi This tool updates secret keys without restart, clears instance data for AWS calls, and requires `keyName` and `resetRequired` parameters.
  • x-auth-token
  • keyName
  • resetRequired
  • x-api-key
None
getAllRuleSets This tool retrieves all rule sets with support for filtering, sorting, pagination, and detailed response/error handling.
  • x-auth-token
  • x-collection-id
  • x-api-key
  • x-version
  • locale
  • sort
  • filters
  • page
  • size
createRuleSet This tool creates a rule set with detailed response properties and error handling codes.
  • x-auth-token
  • x-collection-id
  • x-api-key
  • name
  • startTime
  • endTime
  • status
  • x-version
  • locale
  • id
  • priority
  • createdOn
  • createdBy
  • updatedOn
  • updatedBy
  • collectionId
getRulesByRuleSetId This tool retrieves all rules based on specified parameters and returns responses for various statuses.
  • x-auth-token
  • x-collection-id
  • ruleSetId
  • x-api-key
  • x-version
  • locale
  • sort
  • filters
  • page
  • size
createRuleByRuleSetId This tool creates a rule using specified parameters and provides detailed responses for various outcomes.
  • x-auth-token
  • x-collection-id
  • ruleSetId__path
  • x-api-key
  • name
  • startTime
  • endTime
  • status
  • event
  • x-version
  • locale
  • priority
  • createdBy
  • updatedBy
  • id
  • ruleSetId
  • accumulationFields
  • conditionData
  • actions
  • ruleInformation
  • stopFurtherProcessing
  • stopConditionData
  • ruleType
  • actionType
  • updatedOn
  • createdOn
findAllRewards This tool retrieves rewards for a collection based on filters, pagination, and sorting parameters, with detailed response codes and examples.
  • x-auth-token
  • x-collection-id
  • x-api-key
  • x-version
  • locale
  • page
  • size
  • sort
  • filters
createLoyaltyReward This tool creates a reward within a collection, with locale-based responses and detailed error handling.
  • x-auth-token
  • x-collection-id
  • x-api-key
  • x-version
  • locale
getRewardsBanks This tool retrieves all Rewards Banks (ACTIVE or INACTIVE) from a specified collection with support for filtering, sorting, pagination, and locale-based responses.
  • x-auth-token
  • x-collection-id
  • x-api-key
  • x-version
  • locale
  • sort
  • filters
  • page
  • size
createRewardBank This tool creates a Rewards Bank based on the provided request and returns detailed responses for success or errors.
  • x-auth-token
  • x-collection-id
  • x-api-key
  • x-version
  • locale
  • x-user-info
getLoyaltyRewards This tool retrieves reward values for items matching rule-based criteria, with responses detailing rewards, errors, or statuses.
  • x-auth-token
  • x-collection-id
  • processMode
  • x-api-key
  • x-version
  • x-store-id
  • locale
  • previewTime
getLoyaltyEvents This tool retrieves events from a collection based on filters, pagination, sorting, and locale parameters, returning results or error codes.
  • x-auth-token
  • x-collection-id
  • x-api-key
  • x-version
  • locale
  • page
  • size
  • sort
  • filters
createLoyaltyEvent This tool creates an event within a collection, supports locale customization, and provides detailed success or error responses.
  • x-auth-token
  • x-collection-id
  • x-api-key
  • x-version
  • locale
cacheClear This tool clears cached data by cache name(s), supports string-type keys, and provides detailed response codes for success or errors.
  • x-auth-token
  • cacheName
  • x-api-key
  • cacheKey
  • pattern
cacheClear_1 This tool clears cached data using dynamic cache keys and provides detailed response codes and messages for various statuses.
  • x-api-key
  • cacheNames
  • cacheKey
  • simpleKey
  • pattern
getCollections This tool retrieves collections with query parameters for filtering, pagination, sorting, and locale, returning detailed responses based on the request’s success or error status.
  • x-auth-token
  • x-api-key
  • x-version
  • businessId
  • locale
  • page
  • size
  • sort
  • filters
createCollection This tool creates a collection based on the provided collection request and returns detailed responses for success or various error conditions.
  • x-auth-token
  • businessId
  • x-api-key
  • x-version
  • locale
getCampaigns This tool retrieves campaigns from a collection based on filters, pagination, sorting, and locale settings, with detailed response codes for success or errors.
  • x-auth-token
  • x-collection-id
  • x-api-key
  • x-version
  • locale
  • page
  • size
  • sort
  • filters
createCampaign This tool creates a campaign under a collection, with detailed response codes and properties for success or errors.
  • x-auth-token
  • x-collection-id
  • x-api-key
  • x-version
  • locale
processLoyaltyDiscount This tool calculates loyalty discounts for a cart using the storefront orchestration service and provides detailed error responses.
  • x-auth-token
  • x-collection-id
  • x-api-key
  • locale
  • x-version
cacheClear_2 This tool clears cached data using specified parameters and provides detailed response codes for various outcomes.
  • x-auth-token
  • x-collection-id
  • x-api-key
  • x-version
  • locale
  • cacheKey
findLoyaltyReward This tool retrieves reward details using a reward and collection identifier, with responses based on success or error codes.
  • x-auth-token
  • x-collection-id
  • identifier
  • x-api-key
  • x-version
  • locale
deleteLoyaltyReward This tool deletes a reward using its unique identifier and collection identifier, with options for locale and permanent deletion.
  • x-auth-token
  • x-collection-id
  • identifier
  • x-api-key
  • x-version
  • locale
  • isHardDelete
updateLoyaltyReward This tool updates reward fields using a reward and collection identifier, with responses indicating success or various errors.
  • x-auth-token
  • x-collection-id
  • identifier
  • x-api-key
  • x-version
  • locale
getCampaign This tool retrieves campaign details based on collection and campaign identifiers, with various response codes for success or errors.
  • x-auth-token
  • x-collection-id
  • id
  • x-api-key
  • x-version
  • locale
updateCampaign This tool updates campaign fields based on provided campaign and collection identifiers, with detailed responses for success or errors.
  • x-auth-token
  • x-collection-id
  • id
  • x-api-key
  • x-version
  • locale
getTransaction This tool retrieves transaction details using a unique transaction ID and provides responses based on success or error scenarios.
  • x-auth-token
  • x-collection-id
  • id
  • x-api-key
  • x-version
  • locale
  • x-user-info
refreshApi_1 This tool updates secret keys without a restart, cleans instance data for AWS calls, and uses `keyName` and `resetRequired` parameters with detailed response codes.
  • x-auth-token
  • keyName
  • resetRequired
  • x-api-key
None
rabbitMQUpdateCredentials This tool updates RabbitMQ credentials, cleans instance data for AWS calls, and requires `keyName` and `resetRequired` parameters with detailed response codes.
  • x-auth-token
  • keyName
  • resetRequired
  • x-api-key
None
validateDroolsRule This tool validates Drools rules in a collection, returning incorrect rules with error details or appropriate error responses.
  • x-auth-token
  • x-collection-id
  • x-api-key
  • x-version
  • locale
getAllStandrdRoles This tool retrieves and filters standard roles and privileges but has been deprecated since Infosys Equinox Commerce Release 8.3.0.
  • x-auth-token
  • x-api-key
  • roleName
getReleaseDefinition This tool retrieves the release definition of a service and provides detailed response codes and messages for various statuses.
  • x-auth-token
  • x-api-key
None
getAllPrivileges This tool retrieves service privileges from `roles_privileges.json` and provides various response codes for success or errors.
  • x-auth-token
  • x-api-key
None
getAllPrivilegeGroups This tool retrieves and filters privilege groups and privileges from `roles_privileges.json` based on the `privilegeGroupName` parameter, with detailed response codes for various outcomes.
  • x-auth-token
  • x-api-key
  • privilegeGroupName
getLoyalties This tool provides the current timestamp to check the operational status of the Loyalty service, with various response codes indicating success or errors.
  • x-api-key
None
getCacheValue This tool retrieves cached data for a service using a string-based cache name and key, with various response codes indicating success or errors.
  • cacheName
  • cacheKey
  • x-auth-token
  • x-api-key
None
getCacheKeys This tool retrieves cache keys for a service based on a specified Redis regex pattern, defaulting to ‘*’.
  • pattern
  • x-auth-token
  • x-api-key
None
getCollectionPropertiesByName This tool retrieves a collection property based on the provided identifiers and parameters.
  • x-auth-token
  • businessId
  • id
  • name
  • x-api-key
  • x-version
  • locale
getCollectionAttributes This tool retrieves all collection attributes with detailed response codes and descriptions for various outcomes.
  • x-auth-token
  • x-api-key
  • x-version
  • businessId
  • locale

Error Responses

The table below lists standard error codes with their corresponding descriptions for API responses:

Error Code Error Description
200 (Success): OK
201 (Success): Created
202 (Success): Accepted
204 No Content
400 Bad Request
401 Unauthorized
403 Forbidden
404 Not Found
409 Conflict
422 Unprocessable Entity
500 Internal Server Error

Useful Resources

Revision History
2025-11-19 | JP – Updated domain
2025-09-29 | SD – Page created and content added