Your coding agent can scaffold a REST endpoint, write tests, and open a PR — all without you touching the keyboard. But can it write good API documentation? We ran the same task through three leading coding agents — Claude Code, Cursor, and Codex (OpenAI) — and asked each one to document a small API from source code alone. Here's what we found, and what it tells you about where AI-assisted documentation is heading.
The task
A Node.js Express API with six endpoints: auth, users (CRUD), and a webhook receiver. No OpenAPI file. No existing docs. Just source code and a one-line prompt:
"Read this codebase and document the API."
We measured: completeness (were all endpoints captured?), accuracy (did params, types, and response shapes match the code?), structure (was the output usable without heavy editing?), and MCP-readiness (could the output power an AI agent tool call?).
Claude Code
Completeness: ★★★★★ All six endpoints, all params, correct auth headers.
Accuracy: High.…