IBM Core Content Services MCP Server

Instructions

Implementation Reference

• src/cs_mcp_server/tools/documents.py:899-955 (handler)

  The core handler implementation for the 'delete_version_series' tool. It is decorated with @mcp.tool to register it and executes a GraphQL mutation to delete the specified version series.

  @mcp.tool(
      name="delete_version_series", annotations=ToolAnnotations(destructiveHint=True)
  )
  async def delete_version_series(
      version_series_id: str,
  ) -> Union[str, ToolError]:
      """
      Deletes an entire version series (all versions of a document) in the content repository.
  
      :param version_series_id: The version series ID (GUID) to delete. If you don't have the version series ID,
                               first call get_document_property on the document to get the version series ID.
  
      :returns: If successful, returns the deleted version series ID as a string.
               If unsuccessful, returns a ToolError with details about the failure.
      """
      method_name = "delete_version_series"
      try:
          # Prepare the mutation to delete the version series
          mutation = """
          mutation ($object_store_name: String!, $identifier: String!) {
            deleteVersionSeries(
              repositoryIdentifier: $object_store_name
              identifier: $identifier
            ) {
              id
              className
            }
          }
          """
  
          # Prepare variables for the GraphQL mutation
          variables = {
              "object_store_name": graphql_client.object_store,
              "identifier": version_series_id,
          }
  
          # Execute the GraphQL mutation
          logger.info("Executing version series deletion")
          response = await graphql_client.execute_async(
              query=mutation, variables=variables
          )
  
          # Handle errors
          if "errors" in response:
              logger.error("GraphQL error: %s", response["errors"])
              return ToolError(message=f"{method_name} failed: {response['errors']}")
  
          # Return just the id as a string
          return response["data"]["deleteVersionSeries"]["id"]
  
      except Exception as e:
          logger.error("%s failed: %s", method_name, str(e))
          logger.error(traceback.format_exc())
          return ToolError(
              message=f"{method_name} failed: {str(e)}. Trace available in server logs."
          )

• src/cs_mcp_server/mcp_server_main.py:200-247 (registration)

  The register_server_tools function calls register_document_tools (which defines the tool) for CORE and FULL server types, effectively registering the delete_version_series tool with the MCP server.

  def register_server_tools(
      graphql_client: GraphQLClient,
      metadata_cache: MetadataCache,
      server_type: ServerType,
  ) -> None:
      """
      Register tools based on the server type.
  
      Args:
          graphql_client: The initialized GraphQL client
          metadata_cache: The metadata cache instance
          server_type: The type of server (ServerType enum)
      """
      # Ensure mcp is initialized (type narrowing for type checker)
      assert mcp is not None
  
      logger.info("Registering tools for %s server", server_type.value)
  
      # Register tools based on server type
      if server_type == ServerType.CORE:
          register_document_tools(mcp, graphql_client, metadata_cache)
          register_folder_tools(mcp, graphql_client)
          register_class_tools(mcp, graphql_client, metadata_cache)
          register_search_tools(mcp, graphql_client, metadata_cache)
          register_annotation_tools(mcp, graphql_client)
          logger.info("Core tools registered")
  
      elif server_type == ServerType.VECTOR_SEARCH:
          register_vector_search_tool(mcp, graphql_client)
          logger.info("Vector search tools registered")
  
      elif server_type == ServerType.LEGAL_HOLD:
          register_legalhold(mcp, graphql_client)
          logger.info("Legal hold tools registered")
  
      elif server_type == ServerType.FULL:
          register_document_tools(mcp, graphql_client, metadata_cache)
          register_folder_tools(mcp, graphql_client)
          register_class_tools(mcp, graphql_client, metadata_cache)
          register_search_tools(mcp, graphql_client, metadata_cache)
          register_annotation_tools(mcp, graphql_client)
          register_vector_search_tool(mcp, graphql_client)
          register_legalhold(mcp, graphql_client)
          logger.info("All tools registered")
  
      else:
          raise ValueError(f"Unknown server type: {server_type}")