• MISSING
  • ORPHANED
  • HIERARCHY
  • HUMAN

How to audit documentation site maps with your AI

Connect DeveloperHub to your agent to cross-reference your actual page list against your sitemap. It catches gaps in your documentation structure automatically.

Ask AI about this page

Short answer

Can my AI audit my documentation sitemap?

Yes. Your agent uses the sitemap and page list to identify missing files or structural errors. You'll get a clear report of where your documentation falls short.

Where every issue lands.

Audit outcomes

The AI compares your site structure to your actual content to find these specific results.

MISSING

Missing page alerts

The AI finds URLs present in your sitemap that don't exist in your actual page list. You'll know exactly which docs are gone.

ORPHANED

Orphaned page detection

It identifies pages that exist but aren't listed in your sitemap. This helps you clean up clutter or fix indexing issues.

HIERARCHY

Structure validation

The agent checks if your folder nesting matches your intended hierarchy. It flags logical breaks in your documentation tree.

HUMAN

Manual review needed

The AI flags suspicious paths or broken logic that require a human to decide if a page should be moved or deleted.

The workflow

What your AI does when the audit starts.

Your agent pulls the raw data from your docs and runs a comparison check.

  1. Fetch sitemap

    The agent pulls the complete list of intended URLs from your documentation structure.

    get_documentation_sitemap

  2. List existing pages

    It gathers a real-time list of every page currently live in your documentation.

    list_documentation_pages

  3. Compare lists

    The agent runs a diff between the sitemap and the live pages to find mismatches.

    get_documentation_sitemaplist_documentation_pages

  4. Report gaps

    The agent presents a list of missing or extra pages for you to review.

    list_documentation_pages

Try it

Copy these to start.

Use these prompts to kick off an audit immediately.

Starting points

Swap out the specific project names or URLs for your own documentation sets.

DeveloperHub Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_lNM8HW3yGgBMAOCibm2lC9s0P4itK6o9OZitJjZa/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — DeveloperHub capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "developerhub-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_lNM8HW3yGgBMAOCibm2lC9s0P4itK6o9OZitJjZa/mcp"
    }
  }
}
Copy into chat04

  • Compare the sitemap for the 'api-docs' project against the actual pages listed.

  • Find any pages in the 'user-guide' sitemap that are missing from the live page list.

  • Check the 'dev-portal' hierarchy for any orphaned pages not in the sitemap.

  • List all pages in the 'v2-docs' project and tell me if they match the sitemap.

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Start here

Connect DeveloperHub once, then ask.

Just link your account once. Your credentials stay encrypted, and you can start auditing right away in your preferred AI client.

Connect DeveloperHub to your AI

FAQ

How the audit works

  • 01

    Can the AI fix broken links automatically?

    No. The AI identifies where the gaps are, but you have to manually fix the links or files.

  • 02

    Will the AI delete any of my documentation pages?

    No. This MCP only reads data. It cannot modify, delete, or create any files in your documentation.

  • 03

    How does it know which pages are missing?

    It compares the list of URLs from the sitemap against the list of pages it finds in your documentation.

  • 04

    Can I audit a specific folder instead of the whole site?

    Yes, you can prompt your agent to only look at specific paths or project names.

  • 05

    Does it check the actual content of the pages?

    No. It only checks the existence and hierarchy of the pages based on the sitemap and page list.

  • More questions about DeveloperHub? The Connector page answers them. See everything the DeveloperHub Connector can do

Connect DeveloperHub to Claude, Cursor, ChatGPT & more