# HubSpot

[developers.hubspot.com/doc](https://developers.hubspot.com/doc)

- **Overall score:** 59/100 (Grade F)
- **Checks passed:** 12 / 29
- **Last computed:** 2026-05-12

## Components

### Content Discoverability

- **Score:** 41/100 · **Status:** fail
- **Summary:** 1 failed and 4 skipped across 6 AFDocs checks.
- **Rationale:** Agents need a clear entry point and crawl map before they can reliably discover the right pages.
- **Reference:** [AFDocs reference](https://afdocs.dev)

**Checks**

- ❌ **LLMS TXT Exists** — No llms.txt found at any candidate location (https://developers.hubspot.com/doc/llms.txt, https://developers.hubspot.com/llms.txt, https://developers.hubspot.com/docs/llms.txt) Create an llms.txt file at your site root containing an H1 title, a blockquote summary, and markdown links to your key documentation pages. This is the single highest-impact improvement for agent access to your docs.
- ⏭️ **LLMS TXT Valid** — Skipped: dependency check did not pass
- ⏭️ **LLMS TXT Size** — Skipped: dependency check did not pass
- ⏭️ **LLMS TXT Links Resolve** — Skipped: dependency check did not pass
- ⏭️ **LLMS TXT Links Markdown** — Skipped: dependency check did not pass
- ✅ **LLMS TXT Directive** — llms.txt directive found in all 1 pages, near the top of content

**Evidence**

- **Score cap:** 59 (No llms.txt found. Agents lose primary navigation.)

### Markdown Availability

- **Score:** 36/100 · **Status:** fail
- **Summary:** 1 failed across 2 AFDocs checks.
- **Rationale:** When markdown is available directly, agents spend less effort stripping presentation markup and guessing structure.
- **Reference:** [AFDocs reference](https://afdocs.dev)

**Checks**

- ❌ **Markdown Url Support** — No pages support .md URLs (0/1 tested) Your pages don't return markdown when .md is appended to the URL. Configure your docs platform to serve .md variants for all documentation pages.
- ✅ **Content Negotiation** — 1/1 pages support content negotiation (100%)

### Page Size and Truncation Risk

- **Score:** 75/100 · **Status:** fail
- **Summary:** 1 failed across 4 AFDocs checks.
- **Rationale:** Large pages and delayed primary content increase truncation risk and make retrieval less reliable.
- **Reference:** [AFDocs reference](https://afdocs.dev)

**Checks**

- ✅ **Rendering Strategy** — All 1 pages contain server-rendered content
- ✅ **Page Size Markdown** — All 1 pages under 50K chars (median 11K, max 11K)
- ❌ **Page Size Html** — 1 of 1 pages convert to over 100K chars (max 2900K, -2% boilerplate) 1 of 1 pages convert to over 100K characters of markdown. Reduce inline CSS/JS, break large pages, or provide markdown versions as a smaller alternative.
- ✅ **Content Start Position** — Content starts within first 10% on all 1 pages (median 3%)

### Content Structure

- **Score:** 100/100 · **Status:** partial
- **Summary:** 1 skipped across 3 AFDocs checks.
- **Rationale:** Predictable sections, valid code fences, and serialized tabs make the content easier for agents to parse correctly.
- **Reference:** [AFDocs reference](https://afdocs.dev)

**Checks**

- ✅ **Tabbed Content Serialization** — 2 tab group(s) across 1 of 1 pages; all serialize under 50K chars
- ⏭️ **Section Header Quality** — 1 page(s) with tabs found, but no section headers inside tab panels to evaluate
- ✅ **Markdown Code Fence Validity** — All 0 code fences properly closed across 1 pages

### URL Stability and Redirects

- **Score:** 100/100 · **Status:** pass
- **Summary:** 2 AFDocs checks pass.
- **Rationale:** Stable URLs and sane redirect behavior prevent retrieval drift and broken tool references.
- **Reference:** [AFDocs reference](https://afdocs.dev)

**Checks**

- ✅ **Http Status Codes** — All 1 pages return proper error codes for bad URLs
- ✅ **Redirect Behavior** — All 1 redirect(s) across 1 pages are same-host HTTP redirects

### Observability and Content Health

- **Score:** 100/100 · **Status:** partial
- **Summary:** 1 skipped across 3 AFDocs checks.
- **Rationale:** Coverage, parity, and cache behavior determine whether agents can trust the content they retrieve.
- **Reference:** [AFDocs reference](https://afdocs.dev)

**Checks**

- ⏭️ **LLMS TXT Freshness** — Skipped: dependency check did not pass
- ✅ **Markdown Content Parity** — All 1 pages have equivalent markdown and HTML content (avg 0% missing)
- ✅ **Cache Header Hygiene** — All 1 endpoints have appropriate cache headers

### Authentication and Access

- **Score:** 100/100 · **Status:** partial
- **Summary:** 1 skipped across 2 AFDocs checks.
- **Rationale:** Agents need either public access or a clear alternative path when documentation is gated behind auth.
- **Reference:** [AFDocs reference](https://afdocs.dev)

**Checks**

- ✅ **Auth Gate Detection** — All 1 pages are publicly accessible
- ⏭️ **Auth Alternative Access** — All docs pages are publicly accessible; no alternative access paths needed

### Full Content Discoverability

- **Score:** 0/100 · **Status:** fail
- **Summary:** llms-full.txt has 1 failing check.
- **Rationale:** A full-document snapshot gives long-context agents a single canonical corpus to ingest without repeated crawling.
- **Reference:** [llms-full.txt guide](https://www.mintlify.com/docs/ai/llmstxt#llms-full-txt)

**Checks**

- ❌ **LLMS Full Exists** — No llms-full.txt file was discovered.
- ⏭️ **LLMS Full Size** — Skipped because llms-full.txt was not found.
- ⏭️ **LLMS Full Valid** — Skipped because llms-full.txt was not found.
- ⏭️ **LLMS Full Links Resolve** — Skipped because llms-full.txt was not found.

### Agent Skills

- **Score:** 0/100 · **Status:** fail
- **Summary:** skill.md has 1 failing check.
- **Rationale:** Agent skills provide product-specific operating guidance that plain documentation pages do not encode on their own.
- **Reference:** [skill.md guide](https://www.mintlify.com/docs/ai/skillmd)

**Checks**

- ❌ **Skill MD** — No agent skill definition was discovered.

### MCP Server

- **Score:** 0/100 · **Status:** fail
- **Summary:** MCP has 1 failing check.
- **Rationale:** A discoverable MCP server lets agents use first-class tools instead of scraping pages and inferring behavior.
- **Reference:** [MCP guide](https://www.mintlify.com/docs/ai/model-context-protocol)

**Checks**

- ❌ **MCP Server Discoverable** — No MCP server was discovered at the expected endpoints.
- ⏭️ **MCP Tool Count** — Skipped because the MCP server was not discoverable.