Skip to the content.

X thread — Agent Readiness Report: Notion

7 tweets. Tweet 1 leads with the variance + tag. NO link in tweet 1 (X throttles link-leading threads). Link lands in tweet 7. Tag @NotionHQ on tweet 1 only.


Tweet 1 (271 chars)

@NotionHQ scored 65/100. Level 3 — Agents First.

developers.notion.com is in the celebration tier alongside Vercel, Cursor, Browserbase.

notion.so scored 10/100. Level 0.

55-point gap. Largest spread in the public series.

The variance is the story.


Tweet 2 (272 chars)

developers.notion.com is the high water mark.

Real /AGENTS.md (2.8KB, written for the team itself).

Real /llms.txt (24KB index, linked from AGENTS.md).

Markdown content negotiation passes. OpenAPI discoverable. OAuth-PKCE.

Homepage hero references MCP. 10/10 on visibility.


Tweet 3 (267 chars)

notion.so robots.txt names 5 bots — BLEXBot, AhrefsBot, Amazonbot, SemrushBot, dotbot. All blocked.

Zero AI bots named. No GPTBot, ClaudeBot, anthropic-ai, Google-Extended, Perplexity.

The robots.txt has a position on SEO crawlers and stays silent on AI crawlers.


Tweet 4 (260 chars)

Surprising bit: notion.com/llms.txt actually returns 200. ~7KB.

Notion already ships /llms.txt at the marketing root.

But no /AGENTS.md, no MCP card, no per-bot rules, no homepage hero reference to MCP/SDK/API.

Cheapest 5 points shipped. The other 55 are not.


Tweet 5 (270 chars)

Notion runs an MCP server at mcp.notion.com. In production.

/.well-known/mcp-server-card on notion.so, notion.com, and developers.notion.com — all 404.

The server is real. The discovery breadcrumb is not. An agent fetching .well-known cannot find it.


Tweet 6 (273 chars)

Fix: copy developers.notion.com/AGENTS.md up to notion.so/AGENTS.md.

Add Content-Signal to the robots.txt. Name the AI bots.

Publish the MCP server card.

Reference mcp.notion.com from the homepage hero.

~30 minutes of work. ~30 points on the marketing root.


Tweet 7 (185 chars)

Latest in the bi-weekly Agent Readiness Reports series.

Full report — rubric, raw probe data, top fixes:

https://agentsfirst.dev/reports/notion/


Tweet count: 7. All tweets under 280 chars.

Tags: @NotionHQ on tweet 1; report URL only on tweet 7 (X throttles link-leading threads ~40%). Strong alt to add: @NotionAPI if @NotionHQ is too cold a target — it’s the developer-facing handle and the exact team that did the high-scoring work.

Note: tweet body is the text shown to the reader between > lines, including blank lines as \n chars. The > markdown markers and “Tweet N” labels are NOT part of the tweet.