MCP Server and Resource Metrics

  • Server URL: https://<domain>/ecommreporting-mcp/mcp
  • Total Tools: 28
  • Total Error Codes: 11

Server Overview

The MCP server offers robust capabilities for managing collections, reports, caching, and user privileges, enabling streamlined data retrieval, updates, and secure operations through a suite of 28 specialized tools tailored for efficient business workflows.

Tools

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

Tool Name Tool Description Required Parameters Optional Parameters
getCollection This tool retrieves a collection using its identifier, with locale and businessId parameters, and provides responses based on operation success or errors.
  • x-auth-token
  • businessId
  • collectionId
  • x-api-key
  • x-version-id
  • locale
replaceCollection This tool updates a collection by its ID, requiring name, description, and status while disallowing updates to collectionId and businessId, with detailed response codes for various scenarios.
  • x-auth-token
  • businessId__query
  • collectionId
  • x-api-key
  • status
  • x-version-id
  • locale
  • id
  • name
  • description
  • businessId
  • properties
  • createdTime
  • createdBy
  • updatedTime
  • updatedBy
replaceCollectionProperties This tool updates collection properties for a specific collection ID, creating new ones and replacing existing ones based on the request.
  • x-auth-token
  • collectionId
  • businessId
  • x-api-key
  • locale
  • x-version-id
updateCollectionProperties This tool updates specified collection properties based on provided parameters, validating and modifying only the fields included in the request.
  • x-auth-token
  • collectionId
  • businessId
  • x-api-key
  • locale
  • x-version-id
refreshApi This tool updates secret keys without restarting, clears instance data for AWS calls, and requires `keyName` and `resetRequired` parameters.
  • x-auth-token
  • keyName
  • resetRequired
  • x-api-key
None
getReports This tool retrieves reports from a specified collection, with optional filters, pagination, and privileges for users with ‘view report’ access.
  • x-auth-token
  • x-api-key
  • x-version-id
  • locale
  • x-collection-id
  • page
  • size
  • filters
createReport This tool allows users with ‘create report’ privilege to generate a new report under a collection, returning success or error responses based on input validity.
  • x-auth-token
  • x-collection-id
  • x-api-key
  • name
  • x-version-id
  • locale
  • id
  • collectionId
  • description
  • reportProperties
  • reportParams
  • processorClassName
  • downloadable
  • createdBy
  • createdTime
  • updatedBy
  • updatedTime
cacheClear This tool clears cached data for specified cache names, supports string-type keys, and can clear the entire cache if no key or pattern is provided.
  • x-auth-token
  • cacheName
  • x-api-key
  • cacheKey
  • pattern
cacheClear_1 This tool clears cached data using dynamic cache keys and returns a JSON response with a code, message, and timestamp.
  • x-api-key
  • cacheNames
  • cacheKey
  • simpleKey
  • pattern
getCollections This tool retrieves Report service collections based on search terms and supports pagination, filtering, and locale-specific responses.
  • x-auth-token
  • businessId
  • x-api-key
  • x-version-id
  • locale
  • page
  • size
  • filters
createCollection This tool creates a collection with specified or default properties, disallowing new attributes, and provides locale-specific responses for various status codes.
  • x-auth-token
  • businessId__query
  • x-api-key
  • status
  • x-version-id
  • locale
  • id
  • name
  • description
  • businessId
  • properties
  • createdTime
  • createdBy
  • updatedTime
  • updatedBy
getReport This tool loads a report from a collection using report and collection IDs, accessible to users with ‘view report’ privilege.
  • x-auth-token
  • x-collection-id
  • reportId
  • x-api-key
  • x-version-id
  • locale
deleteReport This tool deletes a report from a collection using a report ID, requiring ‘delete report’ privilege, and returns various response codes based on the outcome.
  • x-auth-token
  • reportId
  • x-api-key
  • x-version-id
  • locale
  • x-collection-id
updateReport This tool allows users with ‘update report’ privileges to modify report attributes, including replacing the entire ReportParam model for updates, using a valid reportId.
  • x-auth-token
  • reportId
  • x-api-key
  • name
  • x-version-id
  • locale
  • x-collection-id
  • id
  • collectionId
  • description
  • reportProperties
  • reportParams
  • processorClassName
  • downloadable
  • createdBy
  • createdTime
  • updatedBy
  • updatedTime
refreshApi_1 This tool updates secret keys without restart, clears instance data, and requires `keyName` and `resetRequired` parameters.
  • x-auth-token
  • keyName
  • resetRequired
  • x-api-key
None
rabbitMQUpdateCredentials This tool updates RabbitMQ credentials, clears instance data for AWS calls, and requires `keyName` and `resetRequired` parameters.
  • x-auth-token
  • keyName
  • resetRequired
  • x-api-key
None
refreshApi_2 This tool updates secret keys without restart, clears instance data for AWS updates, requiring `keyName` and `resetRequired` parameters.
  • x-auth-token
  • keyName
  • resetRequired
  • x-api-key
None
getAllStandrdRoles This tool retrieves standard roles and privileges from `roles_privileges.json`, filters by `roleName`, but has been deprecated since Infosys Equinox Commerce Release 8.3.0.
  • x-auth-token
  • x-api-key
  • roleName
getReportData This tool retrieves report data by executing its associated query, requiring valid parameters and user privileges, with responses indicating success or specific errors.
  • x-auth-token
  • reportId
  • x-api-key
  • x-version-id
  • locale
  • x-collection-id
  • params
getReleaseDefinition This tool retrieves the release definition of a service with various response codes indicating success or errors.
  • x-auth-token
  • x-api-key
None
getAllPrivileges This tool retrieves all service privileges listed in `roles_privileges.json` and returns them as a JSON array upon success.
  • 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.
  • x-auth-token
  • x-api-key
  • privilegeGroupName
ping This tool checks the availability of the Report service and provides status responses.
  • x-api-key
None
getCacheValue This tool retrieves cached data for a service using a specified string-based cache name and cache key.
  • cacheName
  • cacheKey
  • x-auth-token
  • x-api-key
None
getCacheKeys This tool retrieves cache keys for a service using a specified Redis regex pattern, defaulting to ‘*’.
  • pattern
  • x-auth-token
  • x-api-key
None
getCollectionPropertyByName This tool retrieves a collection property by name using specified path and query parameters, returning responses based on success or error codes.
  • x-auth-token
  • businessId
  • collectionId
  • name
  • x-api-key
  • x-version-id
  • locale
getCollectionAttributes This tool retrieves collection attributes and their properties, with responses based on query parameters like businessId and locale.
  • x-auth-token
  • businessId
  • x-api-key
  • locale
deleteReportProperty This tool deletes a report property using the report ID and property name, requiring ‘delete report property’ privilege.
  • x-auth-token
  • reportId
  • name
  • x-api-key
  • x-version-id
  • locale
  • x-collection-id

Error Responses

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

Error Code Error Description
200 (Success): success
201 (Success): success
202 (Success): success
204 (Success): success
400 Bad request
401 Unauthorized
403 Forbidden
404 Not found
409 Conflict
422 Unprocessable Entity
500 Internal Server error

Useful Resources

Revision History
2025-09-29 | SD – Page created and content added