update_catalog_item
Modify service catalog items in ServiceNow by updating details like name, description, category, price, and availability status.
Instructions
Update a service catalog item.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| item_id | Yes | ||
| name | No | ||
| short_description | No | ||
| description | No | ||
| category | No | ||
| price | No | ||
| active | No | ||
| order | No |
Implementation Reference
- The handler function that executes the tool: performs a PATCH request to update the specified catalog item with the provided fields.def update_catalog_item( config: ServerConfig, auth_manager: AuthManager, params: UpdateCatalogItemParams ) -> Dict: """ Update a catalog item. Args: config: The server configuration auth_manager: The authentication manager params: The parameters for updating the catalog item Returns: A dictionary containing the result of the update operation """ logger.info(f"Updating catalog item: {params.item_id}") try: # Build the request body with only the provided parameters body = {} if params.name is not None: body["name"] = params.name if params.short_description is not None: body["short_description"] = params.short_description if params.description is not None: body["description"] = params.description if params.category is not None: body["category"] = params.category if params.price is not None: body["price"] = params.price if params.active is not None: body["active"] = str(params.active).lower() if params.order is not None: body["order"] = str(params.order) # Make the API request url = f"{config.instance_url}/api/now/table/sc_cat_item/{params.item_id}" headers = auth_manager.get_headers() headers["Content-Type"] = "application/json" response = requests.patch(url, headers=headers, json=body) response.raise_for_status() return { "success": True, "message": "Catalog item updated successfully", "data": response.json()["result"], } except Exception as e: logger.error(f"Error updating catalog item: {e}") return { "success": False, "message": f"Error updating catalog item: {str(e)}", "data": None, }
- Pydantic model defining the input schema/parameters for the update_catalog_item tool.class UpdateCatalogItemParams(BaseModel): """Parameters for updating a catalog item.""" item_id: str name: Optional[str] = None short_description: Optional[str] = None description: Optional[str] = None category: Optional[str] = None price: Optional[str] = None active: Optional[bool] = None order: Optional[int] = None
- src/servicenow_mcp/tools/__init__.py:6-9 (registration)Imports the update_catalog_item handler into the tools module for registration in the MCP server.from servicenow_mcp.tools.catalog_optimization import ( get_optimization_recommendations, update_catalog_item, )
- src/servicenow_mcp/tools/__init__.py:133-134 (registration)Lists update_catalog_item in __all__ for easy import and tool discovery."get_optimization_recommendations", "update_catalog_item",