by ·
ai, tools, web

Every few weeks someone tells me to install Context7. Your model is a year stale, libraries move, so bolt on an MCP server that pipes it fresh docs. Fine. I ran it, deleted it, and wrote one line in my CLAUDE.md instead:

Check official docs BEFORE setting up or using any tool/library/framework; fetch the versioned docs page matching the installed version, don’t hand-roll configs or guess APIs from memory.

The line wins, and it isn’t close.


Look at what you actually bought. The agent calls resolve-library-id, hands over “drizzle”, and gets a menu back: the real repo, a mirror, a fork, someone’s tutorial with a similar name. It guesses. Then it calls query-docs and receives snippets that a crawler scraped off that repo at some point, ranked against your question. The README says it plainly: the parsing and crawling engines are closed.

Two round trips, one guess, and an answer with no version stamped on it. You are on v3, main is v4 with a rewritten API, and nothing in the reply tells you which one you are holding. Ask for a specific tag and it may tell you the docs aren’t there. Wrong-version code compiles and dies at runtime, which is the worst possible place to learn this.

Then, the API key. An API key. For documentation. The free plan is 1,000 calls a month, every lookup burns two of them, so that is 500 questions before Pro at $10 a seat and overage at $10 per thousand. You are paying by the call for chopped-up copies of pages Drizzle gives away and updates faster than any crawler walks them. The free tier was quietly cut in January, because of course it was.


Your agent can fetch a URL. That is the entire alternative. Send it to orm.drizzle.team for the version in the lockfile and it reads the real page, deprecation banner and migration note attached, edited this morning, for zero dollars and zero tool definitions riding along in every request you make all day.

The line fires on every task instead of whenever a model remembers some server exists, and it works on the library nobody bothered to index.

If your agent has no network access, sure, Context7 is a real adapter for a real problem. Everyone else is paying rent on a fetch.

this page is dedicated to The Apostle Paul by Rembrandt van Rijn, c. 1657