Middesk

Agents and crawlers that fetch a page without a browser read only the HTML response. This check looks for the page’s main content in that response.

Found: The server HTML has 1,305 characters of main content; 250 are required.

Markdown is the cheapest format for an agent to read. This check looks for a Markdown version of this page and confirms that it is the same page.

Found: method: dom-alternate; 1,883 characters

• ✓ Markdown version of this page (10/10)
• ✓ Markdown matches the page (5/5)

Evidence: https://docs.middesk.com/home.md (opens in a new tab) · HTTP 200

Agent tools commonly cut off long responses. This check measures the text an agent receives from this page.

Found: The Markdown version has 1,883 characters.

AI search and user-triggered fetch agents read docs when a person asks a question. This check reads robots.txt rules for those agents.

Found: 0 of 11 AI search and user-triggered fetch agents are blocked in robots.txt.

llms.txt is an index that points agents to the documentation. This check validates it, measures it, and samples its links.

Found: 2 sections, 88 links; 36,456 characters; sampled links return Markdown

• ✓ Valid llms.txt index (7/7)
• ✓ llms.txt under 50,000 characters (4/4)
• ✓ llms.txt links return Markdown (4/4)

Evidence: https://docs.middesk.com/llms.txt (opens in a new tab) · HTTP 200

A sitemap lists every page, so crawlers do not depend on navigation to find them.

• ✓ robots.txt present (1/1)
• ✓ Sitemap declared (2/2)
• ✓ Sitemap valid XML (2/2)

Structured page metadata in the server HTML helps machines identify the page and its preferred address.

• ✓ JSON-LD in raw HTML (1.25/1.25)
• ✓ Canonical link (1.25/1.25)
• ✓ Meta description (1.25/1.25)
• ✓ Open Graph (1.25/1.25)

A Model Context Protocol server lets agents search or use the docs through tools.

Found: initialize handshake succeeded

Evidence: https://docs.middesk.com/mcp (opens in a new tab) · HTTP 200

A machine-readable API description lets coding agents build API calls without guessing from prose.

• ✓ OpenAPI document (3/3)
• ✓ API catalog (.well-known) (2/2)

Emerging standards that help agents discover and use a site.

• ✗ Content Signals (0/1, missing)
• ✗ Agent skills index (0/1, missing)
• ✗ OAuth discovery (0/1, missing)
• ✓ Link headers (1/1)
• ✗ Web Bot Auth directory (0/1, missing)
• ✗ MCP server card (0/1, missing)
• ✓ Agent login instructions (auth.md) (1/1)

llms-full.txt combines the docs into one file for tools that load a whole documentation set.

Found: 35.6 KB, ~9,115 tokens (approx)

Evidence: https://docs.middesk.com/llms.txt (opens in a new tab) · HTTP 200

An assistant on the docs site answers readers’ questions. It helps people, not external agents.

Found: Ask AI control (platform-native)