get_article
Retrieve specific knowledge articles from ServiceNow using their unique ID to access documented solutions and information.
Instructions
Get a specific knowledge article by ID
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| article_id | Yes | ID of the article to get |
Implementation Reference
- The handler function that implements the get_article tool logic. It makes a GET request to the ServiceNow API to fetch the article by ID, extracts and formats the response data.def get_article( config: ServerConfig, auth_manager: AuthManager, params: GetArticleParams, ) -> Dict[str, Any]: """ Get a specific knowledge article by ID. Args: config: Server configuration. auth_manager: Authentication manager. params: Parameters for getting the article. Returns: Dictionary with article details. """ api_url = f"{config.api_url}/table/kb_knowledge/{params.article_id}" # Build query parameters query_params = { "sysparm_display_value": "true", } # Make request try: response = requests.get( api_url, params=query_params, headers=auth_manager.get_headers(), timeout=config.timeout, ) response.raise_for_status() # Get the JSON response json_response = response.json() # Safely extract the result if isinstance(json_response, dict) and "result" in json_response: result = json_response.get("result", {}) else: logger.error("Unexpected response format: %s", json_response) return { "success": False, "message": "Unexpected response format", } if not result or not isinstance(result, dict): return { "success": False, "message": f"Article with ID {params.article_id} not found", } # Extract values safely article_id = result.get("sys_id", "") title = result.get("short_description", "") text = result.get("text", "") # Extract nested values safely knowledge_base = "" if isinstance(result.get("kb_knowledge_base"), dict): knowledge_base = result["kb_knowledge_base"].get("display_value", "") category = "" if isinstance(result.get("kb_category"), dict): category = result["kb_category"].get("display_value", "") workflow_state = "" if isinstance(result.get("workflow_state"), dict): workflow_state = result["workflow_state"].get("display_value", "") author = "" if isinstance(result.get("author"), dict): author = result["author"].get("display_value", "") keywords = result.get("keywords", "") article_type = result.get("article_type", "") views = result.get("view_count", "0") created = result.get("sys_created_on", "") updated = result.get("sys_updated_on", "") article = { "id": article_id, "title": title, "text": text, "knowledge_base": knowledge_base, "category": category, "workflow_state": workflow_state, "created": created, "updated": updated, "author": author, "keywords": keywords, "article_type": article_type, "views": views, } return { "success": True, "message": "Article retrieved successfully", "article": article, } except requests.RequestException as e: logger.error(f"Failed to get article: {e}") return { "success": False, "message": f"Failed to get article: {str(e)}", }
- Pydantic BaseModel defining the input parameters for the get_article tool, specifically requiring the article_id.class GetArticleParams(BaseModel): """Parameters for getting a knowledge article.""" article_id: str = Field(..., description="ID of the article to get")
- src/servicenow_mcp/utils/tool_utils.py:757-762 (registration)Registration of the get_article tool in the central tool definitions dictionary, linking the handler function, input schema, return type hint, description, and serialization method."get_article": ( get_article_tool, GetArticleParams, Dict[str, Any], # Expects dict "Get a specific knowledge article by ID", "raw_dict", # Tool returns raw dict
- src/servicenow_mcp/tools/__init__.py:53-53 (registration)Import of the get_article function in the tools package __init__.py, making it available for import.get_article,
- src/servicenow_mcp/tools/__init__.py:188-188 (registration)Inclusion of get_article in the __all__ list for the tools package, exposing it publicly."get_article",