ServiceNow MCP Server

Instructions

Implementation Reference

• src/servicenow_mcp/tools/knowledge_base.py:397-455 (handler)

  The handler function that implements the core logic for creating a knowledge article by making a POST request to the ServiceNow 'kb_knowledge' table API endpoint.

  def create_article(
      config: ServerConfig,
      auth_manager: AuthManager,
      params: CreateArticleParams,
  ) -> ArticleResponse:
      """
      Create a new knowledge article.
  
      Args:
          config: Server configuration.
          auth_manager: Authentication manager.
          params: Parameters for creating the article.
  
      Returns:
          Response with the created article details.
      """
      api_url = f"{config.api_url}/table/kb_knowledge"
  
      # Build request data
      data = {
          "short_description": params.short_description,
          "text": params.text,
          "kb_knowledge_base": params.knowledge_base,
          "kb_category": params.category,
          "article_type": params.article_type,
      }
  
      if params.title:
          data["short_description"] = params.title
      if params.keywords:
          data["keywords"] = params.keywords
  
      # Make request
      try:
          response = requests.post(
              api_url,
              json=data,
              headers=auth_manager.get_headers(),
              timeout=config.timeout,
          )
          response.raise_for_status()
  
          result = response.json().get("result", {})
  
          return ArticleResponse(
              success=True,
              message="Article created successfully",
              article_id=result.get("sys_id"),
              article_title=result.get("short_description"),
              workflow_state=result.get("workflow_state"),
          )
  
      except requests.RequestException as e:
          logger.error(f"Failed to create article: {e}")
          return ArticleResponse(
              success=False,
              message=f"Failed to create article: {str(e)}",
          )

• src/servicenow_mcp/tools/knowledge_base.py:50-60 (schema)

  Pydantic BaseModel defining the input parameters and validation schema for the create_article tool.

  class CreateArticleParams(BaseModel):
      """Parameters for creating a knowledge article."""
  
      title: str = Field(..., description="Title of the article")
      text: str = Field(..., description="The main body text for the article. Field supports html formatting and wiki markup based on the article_type. HTML is the default.")
      short_description: str = Field(..., description="Short description of the article")
      knowledge_base: str = Field(..., description="The knowledge base to create the article in")
      category: str = Field(..., description="Category for the article")
      keywords: Optional[str] = Field(None, description="Keywords for search")
      article_type: Optional[str] = Field("html", description="The type of article. Options are 'text' or 'wiki'. text lets the text field support html formatting. wiki lets the text field support wiki markup.")

• src/servicenow_mcp/utils/tool_utils.py:729-735 (registration)

  Tool registration in the central tool_definitions dictionary, associating the tool name 'create_article' with its handler function, input schema, description, and serialization details.

  "create_article": (
      create_article_tool,
      CreateArticleParams,
      str,  # Expects JSON string
      "Create a new knowledge article",
      "json_dict",  # Tool returns Pydantic model
  ),

• src/servicenow_mcp/tools/__init__.py:184-184 (registration)

  Exposes the create_article function in the tools package __all__ list for easy import.

  "create_article",

• src/servicenow_mcp/utils/tool_utils.py:157-157 (helper)

  Import alias for the create_article handler used in tool registration.

  create_article as create_article_tool,