Skip to main content

Docs MCP Server

Overview

The Docs MCP server provides full-text search over all project documentation. It indexes every documentation page and exposes tools for searching, listing, and retrieving content. The search engine supports fuzzy matching and prefix search, making it effective for finding information even with partial or approximate queries.

PropertyValue
Server IDdocs
Tools4
Streamable HTTP/api/mcp/docs/mcp when the deployed MCP transport is published
SSE/api/mcp/docs/sse when the deployed MCP transport is published

Transport publication

The source-backed server ID and tool list are current. The exact APIM MCP transport paths still require live testing before they are treated as a public integration contract.

Tools

Tool IDDescription
docs-searchFull-text search over documentation, returning ranked sections
docs-listList all indexed pages with metadata, optionally filtered by domain
docs-get-pageRetrieve a single page by its logical path with all sections
docs-refresh-indexForce rebuild the search index

Search Capabilities

The docs-search tool performs full-text search across all indexed documentation. Key features:

  • Fuzzy matching -- Finds results even when the query contains typos or approximate terms.
  • Prefix search -- Matches pages where terms start with the query text, useful for partial queries.
  • Ranked results -- Results are ordered by relevance score.
  • Section-level granularity -- Returns individual sections (headings) within pages, not just whole pages.

Each search result includes:

  • Page title and description
  • Section heading where the match was found
  • Content excerpt with the matching text
  • Relevance score

Domain Filtering

Pass a domain parameter to docs-search or docs-list to restrict results to a specific domain (e.g., k12, sdac, tap, reasoning-engine). This is useful when you know which area of the documentation is relevant.


Tool Details

Search for information across all documentation. Returns a ranked list of matching sections.

Example uses:

  • Search for information about QRG generation workflows
  • Find documentation about agent profile configuration
  • Look up database schema details for a specific domain

docs-list

List all indexed documentation pages. Returns page titles, descriptions, and logical paths. Use the optional domain filter to narrow results to a specific area.

Example uses:

  • List all pages in the K12 domain
  • Browse available TAP documentation
  • Get an overview of all indexed content

docs-get-page

Retrieve the full content of a specific documentation page by its logical path. Returns all sections of the page with their headings and content.

Example uses:

  • Get the complete content of the EOP workflow documentation
  • Read the full agent architecture guide
  • Retrieve deployment instructions for a specific platform

docs-refresh-index

Force a rebuild of the search index from the documentation files on disk. The index is built automatically at startup, but this tool allows you to refresh it if documentation has been updated while the server is running.


When to Use This Server

Use the global Docs server when:

  • You need to search across all domains at once
  • You are not sure which domain contains the information you need
  • You want to compare documentation across different areas

If you already know which domain you are looking for, consider using a domain-scoped docs server instead. Domain-scoped servers return pre-filtered results without needing to specify a domain parameter.