X thread — Agent Readiness Report: Linear
7 tweets. Tweet 1 leads with score + the inverted-narrative hook + tags. NO link in tweet 1 (X throttles link-leading threads). Link lands in tweet 7. Tags @linear on tweet 1.
Tweet 1 (278 chars)
@linear is the engineering-ergonomics canonical of 2026.
Agent Interaction Guidelines. Agent badges. Agent Sessions. The cleanest MCP integration of any planning tool.
60/100. Level 2.
And the 60 is overstated. The story is what an agent reading the public surface can’t see.
Tweet 2 (267 chars)
linear.app ships a real /llms.txt — text/plain, 9KB, every doc enumerated as a .md URL.
The homepage talks about MCP. The changelog mentions MCP 14 times this quarter.
If you’re reading the surface as a human, this is a Level 3 product.
Now check the rubric’s view.
Tweet 3 (276 chars)
developers.linear.app is a Next.js SPA.
/llms.txt → 200 OK, returns the HTML shell. /AGENTS.md → 200 OK, returns the HTML shell. /.well-known/mcp-server-card.json → 200 OK, returns the HTML shell.
Every agent-discovery probe is a coin flip dressed up as a green check.
Tweet 4 (276 chars)
npm view @linear/mcp → 404.
The first three results when an agent searches “linear mcp” are community wrappers — @hatcloud/linear-mcp, @mcp-devtools/linear, linear-mcp.
Linear’s official MCP exists. The canonical install handle on the public registry doesn’t.
Ship and Forget.
Tweet 5 (271 chars)
Fix #1: publish /.well-known/mcp-server-card.json on linear.app and link it from the developers hero.
30 lines of static JSON. Worth 30 points.
Linear runs the MCP server already. The breadcrumb that lets an agent discover it doesn’t exist.
Capability real. Signal isn’t.
Tweet 6 (270 chars)
Fix #2: Next.js rewrites for /llms.txt /AGENTS.md /openapi.json /.well-known/* /robots.txt /sitemap.xml so they return real artifacts, not the React shell.
A 200 OK on every URL is not a feature. It’s a Lazy Wrapper signal nobody intended to ship.
Tweet 7 (242 chars)
Bi-weekly Agent Readiness Reports. Scoring named products against the Agents First framework.
Full report — including the v0.1.3 rubric fix this surfaced — and the third top fix:
https://agentsfirst.dev/reports/linear/
Tweet count: 7. All tweets under 280 chars.
Tags: @linear on tweet 1; report URL only on tweet 7 (X throttles link-leading threads ~40%).
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.