ServiceNow MCP Server

Instructions

Implementation Reference

• src/servicenow_mcp/tools/change_tools.py:860-958 (handler)

  The main handler function that implements the reject_change tool logic. It validates input parameters using RejectChangeParams, queries for the approval record associated with the change request, updates the approval state to 'rejected' with the rejection reason, and updates the change request state to 'canceled' adding work notes.
  def reject_change( auth_manager: AuthManager, server_config: ServerConfig, params: Dict[str, Any], ) -> Dict[str, Any]: """ Reject a change request in ServiceNow. Args: auth_manager: The authentication manager. server_config: The server configuration. params: The parameters for rejecting a change request. Returns: The result of the rejection. """ # Unwrap and validate parameters result = _unwrap_and_validate_params( params, RejectChangeParams, required_fields=["change_id", "rejection_reason"] ) if not result["success"]: return result validated_params = result["params"] # Get the instance URL instance_url = _get_instance_url(auth_manager, server_config) if not instance_url: return { "success": False, "message": "Cannot find instance_url in either server_config or auth_manager", } # Get the headers headers = _get_headers(auth_manager, server_config) if not headers: return { "success": False, "message": "Cannot find get_headers method in either auth_manager or server_config", } # First, find the approval record approval_query_url = f"{instance_url}/api/now/table/sysapproval_approver" query_params = { "sysparm_query": f"document_id={validated_params.change_id}", "sysparm_limit": 1, } try: approval_response = requests.get(approval_query_url, headers=headers, params=query_params) approval_response.raise_for_status() approval_result = approval_response.json() if not approval_result.get("result") or len(approval_result["result"]) == 0: return { "success": False, "message": "No approval record found for this change request", } approval_id = approval_result["result"][0]["sys_id"] # Now, update the approval record to rejected approval_update_url = f"{instance_url}/api/now/table/sysapproval_approver/{approval_id}" headers["Content-Type"] = "application/json" approval_data = { "state": "rejected", "comments": validated_params.rejection_reason, } approval_update_response = requests.patch(approval_update_url, json=approval_data, headers=headers) approval_update_response.raise_for_status() # Finally, update the change request state to "canceled" change_url = f"{instance_url}/api/now/table/change_request/{validated_params.change_id}" change_data = { "state": "canceled", # This may vary depending on ServiceNow configuration "work_notes": f"Change request rejected: {validated_params.rejection_reason}", } change_response = requests.patch(change_url, json=change_data, headers=headers) change_response.raise_for_status() return { "success": True, "message": "Change request rejected successfully", } except requests.exceptions.RequestException as e: logger.error(f"Error rejecting change: {e}") return { "success": False, "message": f"Error rejecting change: {str(e)}", }
• src/servicenow_mcp/tools/change_tools.py:99-105 (schema)

  Pydantic BaseModel defining the input schema for the reject_change tool, including required fields change_id and rejection_reason, and optional approver_id.
  class RejectChangeParams(BaseModel): """Parameters for rejecting a change request.""" change_id: str = Field(..., description="Change request ID or sys_id") approver_id: Optional[str] = Field(None, description="ID of the approver") rejection_reason: str = Field(..., description="Reason for rejection")
• src/servicenow_mcp/utils/tool_utils.py:539-545 (registration)

  Tool registration in the get_tool_definitions dictionary, mapping 'reject_change' to its handler (reject_change_tool alias), schema (RejectChangeParams), return type (str), description, and serialization method ('str').
  "reject_change": ( reject_change_tool, RejectChangeParams, str, "Reject a change request", "str", # Tool returns simple message ),
• src/servicenow_mcp/utils/tool_utils.py:81-82 (registration)

  Import and alias of the reject_change handler function as reject_change_tool for use in tool registration.
  reject_change as reject_change_tool, )
• src/servicenow_mcp/tools/__init__.py:29-29 (registration)

  Re-export of reject_change function from change_tools.py in the tools package __init__ for convenient access.
  reject_change,