Audited October 16, 2026 · scoring 100-point-v4

Plaid

B+

Plaid’s public docs score 88.0% (B+): content delivery 50/50, discovery 21/25, agent capabilities 16/25. 7 of 10 checks earn full points. Largest gap: API description.

Plaid Custom Next.js · audited
B+

88.0% · 88/100 · AI Agent Readiness Score

llms.txt 11/15 PARTIAL
Page metadata 5/5 PASS
MCP server 15/15 PARTIAL
API description 0/5 FAIL
llms-full.txt 1/1 PASS

docs platform: Custom Next.js (unscored) · scoring 100-point-v4

What to fix first

3 checks lose points. They are ranked by the points a fix would add back.

  1. 1

    Publish an OpenAPI description at a discoverable address when the product has an API.

  2. 2

    Add agent discovery signals such as Content Signals, an agent skills index, or an MCP server card.

  3. 3

    Publish an llms.txt index under 50,000 characters whose links point to Markdown pages.

Every check, with evidence

Each check shows what the audit found and the points it earned. Evidence links open the exact URL the audit requested.

Content delivery · 50/50

Content in server HTML

15/15 PASS

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 4,171 characters of main content; 250 are required.

Markdown mirror

15/15 PASS

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: accept-negotiation; 3,755 characters

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

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

Page fits one agent fetch

10/10 PASS

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

Found: The Markdown version has 3,755 characters.

AI crawler access

10/10 PASS

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.

Discovery · 21/25

llms.txt

11/15 PARTIAL

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

Found: 9 sections, 85 links; over 130,802 characters; sampled links return Markdown

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

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

Sitemap and robots.txt

5/5 PASS

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)

Page metadata

5/5 PASS

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)

Agent capabilities · 16/25

MCP server

15/15 PARTIAL

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

Found: present, auth required: Bearer realm="plaid_mcp", resource_metadata="https://mcp.plaid.com/.well-known/oauth-protected-resource/mcp", scope="mcp:developer", error="invalid_request", error_description="missing Bearer token"

Evidence: https://mcp.plaid.com/mcp (opens in a new tab) · HTTP 401

API description

0/5 FAIL

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

  • OpenAPI document (0/3, missing)
  • API catalog (.well-known) (0/2, missing)

Agent interoperability signals

1/5 PARTIAL

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) (0/1, missing)

Extra credit · 1/2

Extra credit can restore lost points. It cannot raise the score above 100.

llms-full.txt

1/1 PASS

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

Found: 512.0 KB, ~131,072 tokens (approx)

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

Docs AI assistant

0/1 FAIL

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

Found: none detected

Archived reading test

Plaid had a reading test on 2026-09-22, under the method the series used until October 16, 2026. Three AI models read the docs and attempted five first-hour developer jobs. It scored 93.8% (A). That score is not comparable with this one.

Read the archived reading test report

Show the score

AI Agent Readiness Score 88.0%, grade B+

Paste this into a readme:

[![AI Agent Readiness Score 88.0%](https://docsforagents.com/badge/plaid.svg)](https://docsforagents.com/reports/plaid-docs-ai-agent-readiness/)

Method note

This audit requested the public Plaid docs on October 16, 2026 and scored what the server returned. No AI model read the docs or scored anything. The audit did not run JavaScript, sign in, or create an account. Scoring version 100-point-v4.

Read the full methodology

Audit another docs site.

Nominate a docs site