MCP Azure DevOps Server

Instructions

Implementation Reference

• mcp_azure_devops/azure_devops_client.py:438-454 (handler)

  Core handler function that lists wiki pages, matches the title by extracting from path, fetches and returns the full matching page or None if not found.

  def get_wiki_page_by_title(self, project, wiki_identifier, title):
      """
      Find wiki page by title instead of exact path.
      """
      pages = self.list_wiki_pages(project, wiki_identifier)
      
      for page in pages:
          # Extract title from path (last part after /)
          page_title = page["path"].split("/")[-1].replace("-", " ").replace("_", " ")
          if title.lower() in page_title.lower() or page_title.lower() in title.lower():
              try:
                  full_page = self.get_wiki_page(project, wiki_identifier, page["path"])
                  return full_page
              except Exception:
                  continue
      
      return None

• mcp_azure_devops/server.py:708-730 (schema)

  Input schema definition for the get_wiki_page_by_title tool, specifying parameters: project, wiki_identifier, title.

  types.Tool(
      name="get_wiki_page_by_title",
      description="Find a wiki page by title instead of exact path - useful for navigation.",
      inputSchema={
          "type": "object",
          "properties": {
              "project": {
                  "type": "string", 
                  "description": "The name or ID of the project."
              },
              "wiki_identifier": {
                  "type": "string", 
                  "description": "The name or ID of the wiki."
              },
              "title": {
                  "type": "string", 
                  "description": "Title or partial title of the page to find."
              },
          },
          "required": ["project", "wiki_identifier", "title"],
          "additionalProperties": False
      }
  ),

• mcp_azure_devops/server.py:1027-1036 (registration)

  Server-side dispatch and response formatting for the get_wiki_page_by_title tool call, invoking the client method and formatting the output.

  elif name == "get_wiki_page_by_title":
      page = self.client.get_wiki_page_by_title(**arguments)
      if page:
          return {
              "path": page.page.path,
              "url": page.page.url,
              "content": page.page.content,
          }
      else:
          return {"message": f"No page found with title '{arguments['title']}'"}