retail-industry/rahi-retail-mcp-server-access-control.md
On this page
— title: Retail MCP Server roles and data access description: Access to the Retail MCP Server is controlled at two levels: roles determine who can invoke each tool, and the caller’s own record access determines what data each tool returns or changes. locale: en-US canonical_url: www.servicenow.com/docs/r/australia/retail-industry/rahi-retail-mcp-server-access-control.html release: australia topic_type: reference last_updated: “2026-09-23” reading_time_minutes: 2 keywords: [Retail MCP Server, roles, ACL, invoke_from_ai, data visibility]
breadcrumb: [Retail MCP Server, Configure, Retail]
Retail MCP Server roles and data access
Access to the Retail MCP Server is controlled at two levels: roles determine who can invoke each tool, and the caller’s own record access determines what data each tool returns or changes.
Roles that can invoke the tools
The Retail MCP Server creates no roles. Each tool has an access control of type flow_action with the invoke_from_ai operation, named after the tool. A caller without one of the listed roles is denied, and the tool doesn’t run.
These roles aren’t granted, by design:
-
sn_retail.support_agent. A support agent assists retail customers and partners rather than working in a store. An administrator can add this role to the access control if needed.
-
Store Services HQ agent roles, such as sn_rtl_stre_servcs.agent and sn_rtl_stre_servcs.breakfix_agent, and their manager variants. HQ agents work cases in the agent workspace; these tools expose only store-side actions.
Data visibility
Each tool runs as the calling user and reads and writes data through secure queries, so the platform’s existing access controls apply to the caller. A tool returns only the stores, devices, and cases the caller can read in the platform, and a write is refused if the caller can’t write the case. The Retail MCP Server adds no record-level access controls of its own. Store and case tools identify the caller from the session, never from an identifier the assistant supplies.
What the update tool can change
Update store services case is the only tool that changes existing records. It supports these actions, and nothing else:
Action Effect Allowed when the case isget_actions
None (read only)
Any state
comment
Adds a comment
New, Open, or Awaiting Info
accept_resolution
Adds a comment and sets the case to Closed
Resolved
reject_resolution
Adds a comment and sets the case to Open
Resolved
close
Sets the case to Closed with a resolution code and close notes chosen by the system
New, Open, or Awaiting Info
Callers can’t set the state directly, or the priority, assignee, assignment group, or resolution code. Closed and Cancelled cases reject every action. The rules match the ones the portal and mobile app apply.
Parent Topic:Retail MCP Server
Related topics
Keep exploring.
Find another answer, or bring this documentation into your own tools.