Enable TechDocs MCP tools

Install the Model Context Protocol (MCP) server and its associated tool plugins to expose Red Hat Developer Hub portal capabilities, such as the Software Catalog and TechDocs, to your external AI assistant.

Enable TechDocs MCP tools to allow the AI to read and analyze internal documentation

Enable and use TechDocs MCP tools to allow the AI assistant to search, read, and analyze your internal technical documentation to resolve queries with accurate portal data.

The TechDocs MCP tool enables MCP clients to search and retrieve documentation from RHDH for use as context in AI applications.

The following table lists the TechDocs tools and parameters:

Tool Description Parameters

fetch-techdocs

Lists all entities with registered TechDocs. Includes metadata such as lastModified and build information.

entityType, namespace, owner, lifecycle, tags

analyze-techdocs-coverage

Calculates the percentage of entities with TechDocs configured to identify documentation gaps.

entityType, namespace, owner, lifecycle, tags

retrieve-techdocs-content

Retrieves the content of a specific TechDocs resource.

entityRef, pagePath

Retrieve TechDocs URLs and metadata

List all Backstage entities with TechDocs including URLs, metadata, timestamps, and build information using the fetch-techdocs tool.

The fetch-techdocs TechDocs MCP tool lists all Backstage entities with TechDocs. By default, the tool returns results in a JSON array format. Each entry includes entity details and TechDocs metadata, like last update timestamp and build information.

By default, each entry in the JSON array is an entity with the following fields: name, title, tags, description, owner, lifecycle, namespace, kind, techDocsUrl, matadataUrl, and metadata.

The following examples show common queries:

  • “Fetch all techdocs from the Backstage server”
  • “Fetch all techdocs of the default namespace”
  • “Fetch all techdocs created by user:john.doe”
Table 1. fetch-techdocs TechDocs MCP tool.
Name Description Example

entityType

Filters entities by their type.

"Component"

namespace

Filter entities by their namespace.

"default"

owner

Filters entities by owner.

"user:john.doe"

lifecycle

Filters entities by their lifecycle.

"development"

tags

Filters entities by their tags.

["genai, "ibm", "llm", "granite", "conversational", "task-text-generation"]

Measure documentation gaps

Calculate documentation coverage percentage and identify gaps using the analyze-techdocs-coverage tool with entity attribute filters.

The analyze-techdocs-coverage TechDocs MCP tool calculates the percentage of entities that have TechDocs configured. Use this tool to identify documentation gaps and improve overall documentation coverage.

You can filter results by the following entity attributes:

  • type
  • namespace
  • owner
  • lifecycle
  • tags
By default, analyze-techdocs-coverage returns a JSON entity that includes the totalEntities, entitiesWithDocs, and coveragePercentage fields.

The following examples show common queries:

  • “What is the coverage of techdocs in the backstage server”
  • “What is the coverage of techdocs in the default namespace”

The following table lists the parameters for the analyze-techdocs-coverage TechDocs MCP tool:

Name Description Example

entityType

Filters entities by their type.

"Component"

namespace

Filter entities by their namespace.

"default"

owner

Filters entities by owner.

"user:john.doe"

lifecycle

Filters entities by their lifecycle.

"development"

tags

Filters entities by their tags.

["genai, "ibm", "llm", "granite", "conversational", "task-text-generation"]

Find a specific TechDoc

Retrieve TechDocs content for specific Software Catalog entities using the retrieve-techdocs-content tool with entityRef, name, title, and content fields.

The retrieve-techdocs-content TechDocs MCP tool retrieves the content of a TechDocs resource, enabling AI clients to access documentation content for specific Software Catalog entities. By default, the tool returns a JSON entity with the following fields: entityRef, name, title, kind, namespace, content, path, contentType, lastModified, and metadata.

Note

If TechDocs indexing is empty or not yet configured, retrieve-techdocs-content returns no results. Use fetch-techdocs first to confirm that entities with TechDocs are available before calling this tool.

The following examples show common queries:

  • “Fetch techdoc with reference component:default/my-service”
  • “Fetch page about.html from techdoc with reference component:default/my-service”

The following table describes the parameters for the retrieve-techdocs-content TechDocs MCP tool.

Name Description Example

entityRef

Specifies the entity to retrieve using the kind:namespace/name format.

"component:default/my-service"

pagePath

Specifies the path to a specific documentation page. Defaults to index.html

"index.html"