MCP Server Tools

reference brazil Updated Sep 10, 2026 2 min read mcp-server-tools-reference.md
Raw file servicenow.com

Reference for the tools available in the HRSD MCP Server.

Tool name

Description

sn_hr_mcp_server.hrsd_case_initiate

Opens an HR case for an employee and returns the case number and state. For services backed by a record producer, it collects the required answers before creating a case.

sn_hr_mcp_server.hrsd_service_lookup

Browses the HR services a given employee is eligible to request and returns for each service: name, description, and Center of Excellence (COE).

sn_hr_mcp_server.hrsd_case_lookup

Finds and reports on the status of HR cases, including service-level agreement (SLA) and last activity. Users can look up cases by number, short description, or see a list of their cases.

sn_hr_mcp_server.hrsd_case_comment_add

Adds a comment or work note to an existing HR case. Comments are visible to employees; work notes are only visible to agents.

sn_hr_mcp_server.hrsd_case_advance

Progresses an existing HR case toward resolution or closure. Cases can only be advanced from the Work in progress state. The terminal returns a blocked transaction message if an HR agent attempts to advance a case that is in the following states: Draft, Awaiting Approval, Awaiting User Acceptance, Suspended, or Closed.

sn_hr_mcp_server.hrsd_knowledge_search

Finds and cites the official knowledge article that answers an HR policy question. This tool returns only the policy text; it does not compute balances or amounts.

sn_hr_mcp_server.hrsd_eligibility_check

Returns a yes or no answer to eligibility questions.

 

 

sn_hr_mcp_server.knowledge.search_profile

Specify the AI Search profile (ais_search_profile.name) that hrsd_knowledge_search queries use. Default: the profile used by Employee Center HR portal search (sn_hr_sp_esc_search_result_configuration)

Behavior:

  • With valid profile: Queries use the specified profile configuration
  • Unset or invalid: Search is unavailable; an error names this property and describes the issue

Note: There is no fallback engine. The tool requires an explicit, valid profile to operate.

sn_hr_mcp_server.knowledge.applicability_map

Declare which article fields encode applicability dimensions using a JSON mapping. This enables the tool to perform dimension-scoped result narrowing and generate facets beyond the knowledge structure hierarchy.Behavior:

  • With mapping: Result narrowing and faceting use both knowledge structure (bases, categories, taxonomy) and the specified applicability fields
  • Without mapping (default): Narrowing and faceting use knowledge structure only

Note: Invalid or non-existent field references will produce an error that names this property and the offending field.

Example:

JSON
{  "region": {    "field": "u_region"  }}

sn_hr_mcp_server.knowledge.authority_tiers

Map knowledge bases to authority tiers (1–4) to rank sources by authoritativeness and enable authority-based filtering.1. Official policy 2. Process documentation 3. FAQ 4. Informal (community, tips, etc.)

Behavior:

  • With mapping: Results rank by tier; users can filter by authority level.
  • Without mapping (default): Tier-neutral ranking; authority filtering is unavailable.

Note: Invalid or non-existent field references will produce an error that names this property and the offending field.

Example:

JSON
{  "HR Policies": 1,  "Onboarding Process": 2,  "Common Questions": 3,  "Team Tips": 4}
**Parent Topic:**[Reference for ServiceNow Otto for HR Service Delivery \(HRSD\)](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/brazil/markdown/employee-service-management/now-assist-for-hrsd/reference-now-assist-hrsd.md)
Search documentation
Search document titles and file paths on the brazil branch