DOP 363: Is Your Website Agent-Ready?

Episode 363

Show Notes

#363: Three waves of the web, and you are late for the third one. The 90s were about getting a browser to render your page at all. The early 2000s were about SEO, or as Darin puts it, sell me all the ads ready. Now it is agent ready, and Cloudflare built a scoreboard for it at isitagentready.com. The devopsparadox.com site scored about 70 out of 100 and then went down when Cloudflare added new checks. Run yours. You will be sad.

Viktor thinks the framing is slightly off, though, and the correction is the good part. Optimizing for agents that browse your site is aiming at the wrong thing, because most requests never touch your server. Agent asks the model, model answers, agent shows you. So the target is not the crawler, it is the training data - and if the model does go looking, the question becomes whether you are the first answer or one of the five sites it was told to go analyze. Same game as Google. Different index. It is not Google index anymore, it is model training now.

Then the practical part. Five things Cloudflare scores you on: discoverability, content, bot access control, API, Auth, MCP & Skill Discovery, and Commerce. Content accessibility is where most of you are losing, because agents want Markdown and you are serving them a pile of HTML tags to strip. Both DOP and Viktor’s site are Hugo, so the Markdown is already sitting on disk next to the HTML - serve one or the other based on what the request asks for. Almost no effort. If you are still shipping a JavaScript-rendered site, Darin says it is game over, and humans do not like those either. On the blocking side, both of them are baffled by the same thing: if you do not want agents reading it, do not publish it. robots.txt is a suggestion at best. If you really want to block, actually block.

The API argument is the one that will annoy people. Viktor says CLIs and MCP servers are both auto-generated from a schema, so the real work is having a good API, and most companies do not. But who your audience is decides the wrapper - developers already have Bash, so give them a CLI and get out of the way. Everyone else needs MCP, because Viktor’s mom is not installing your binary. And somewhere in the middle of all this Darin asks whether documentation should live in the code now more than ever, and Viktor says no, less than ever - he wants it separate so he can review it, because agents made everything cheap to produce and review is now the only thing standing between him and 5,000 features a day. Also: WordPress should be the last thing you consider, not the first.

Frequently Asked Questions

How do I make my website agent-ready for AI crawlers and assistants?

Darin Pope breaks it into four parts on DevOps Paradox episode 363: discoverability through robots.txt and sitemaps, content accessibility, bot access control, and capabilities such as APIs and MCP servers. He points at Cloudflare’s isitagentready.com as a way to score a site, noting devopsparadox.com sat around 70 out of 100. Getting structured data right with schema.org markup sits alongside all of that.

Should you serve Markdown instead of HTML to AI agents?

Darin Pope’s answer on DevOps Paradox episode 363 is to serve both, chosen by content negotiation: HTML when a browser asks for it, Markdown when the request carries text/markdown. That means fewer tokens to parse and no headers, image tags, or markup to strip out. Viktor Farcic adds that Markdown is genuinely more compact, since italics cost two characters and a heading costs one, where HTML costs more.

Should you block AI crawlers from your website?

Viktor Farcic’s position on DevOps Paradox episode 363 is that if you do not want to be found, you should not be public in the first place. Making the site private is simpler than fighting crawlers. Darin Pope adds that robots.txt was only ever a suggestion, so anyone serious about blocking has to do it at the firewall, with friction real enough that crawling stops being worth paying for.

Do you need an MCP server, or is a good API enough?

Viktor Farcic argues on DevOps Paradox episode 363 that it depends entirely on who your users are. Developers work through agents whose primary tool is a shell, so a CLI covers them. Everyone else needs an MCP server, because a non-technical user is never going to install a command line tool. His larger point is that both are generated from the API, which makes the API the real work.

Is being agent-ready just SEO again?

Viktor Farcic says on DevOps Paradox episode 363 that the optimisation framing carries over but the game does not. Where people once browsed for information, they now work through an intermediary that acts on their behalf. The two questions worth asking are whether your content is the first answer the model gives, and failing that, whether you are among the handful of sites it goes off to read.

Should documentation live in the code?

Viktor Farcic says on DevOps Paradox episode 363 that he writes less documentation inside code now than he ever did before. Two years ago he wanted it next to the function so it stood a chance of being updated. Now that agents produce the first pass, he wants tests, code, and documentation kept separate so each can be reviewed on its own. Documentation gets the most of his review attention.

What is the DevOps Paradox podcast?

DevOps Paradox is a weekly podcast co-hosted by Darin Pope and Viktor Farcic, covering DevOps, platform engineering, and modern software delivery. Episode 363 works through what it takes to make a website agent-ready, from serving Markdown by content negotiation to deciding whether you need an MCP server or just a better API. Every episode page carries audio, video, and a full transcript.

Share and Download

Hosts

Viktor Farcic

Viktor Farcic

Viktor Farcic is a member of the Google Developer Experts and Docker Captains groups, and published author.

His big passions are DevOps, Containers, Kubernetes, Microservices, Continuous Integration, Delivery and Deployment (CI/CD) and Test-Driven Development (TDD).

He often speaks at community gatherings and conferences.

He has published DevOps Paradox and Test-Driven Java Development.

His random thoughts and tutorials can be found in his blog The DevOps Toolkit.