Making APIs ready for agents

Bill Doerrfeld | June 25, 2025

My latest for The New Stack explores how to position APIs for AI agents

How do you make an API ready for AI agents to use? I posed this question to a handful of API experts and put together a comprehensive guide for The New Stack — published today.


The key takeaway: making RESTful APIs agent-ready takes way more than just wrapping them in MCP (although that's helpful). 


It'll require having a well-defined spec, setting new traffic controls, comprehensive error responses with next steps, documenting common workflows, and having monetization in place (when applicable), and more...


There are also some big security and ethical concerns to keep in mind.


This space is rapidly evolving, and the practices will likely change. But I think following this guide will be a really strong foundation for API providers in mid-2025.


Please give it a read and feel free to let me know what you think, especially if we missed any key areas.



Read: How To Prepare Your API for AI Agents

Other Blog Posts

A set of metal keys on a keyring resting on a wooden surface.

API keys don't equal security. Here are 10 reasons why.

By Bill Doerrfeld • May 22, 2026
My latest for Nordic APIs explores 10 API key security risks and what to use alongside keys for stronger API security.

MC'ing at apidays New York 2026

By Bill Doerrfeld • May 18, 2026
The yearly API conference, apidays New York, is a hotbed for solid discussion on what's top of mind in the API space, and as MC I had a front row seat.

Using agentic AI to accelerate sales teams

By Bill Doerrfeld • May 13, 2026
My latest for CIO Online features real results form CIOs actively deploying AI agents to empower sales and revenue teams.

Avoid hastily bolting AI into existing products

By Bill Doerrfeld • May 12, 2026
Reports say consumers are souring on AI everywhere, all the time. So, at the risk of losing trust, or even potential business, is adding AI to an existing product really worth it?

Agentic rebuilds are the new forking

By Bill Doerrfeld • May 1, 2026
Cloudflare rebuilt Next.js over a weekend using agentic coding.

Agentic AI requires new systems thinking

By Bill Doerrfeld • April 20, 2026
My InfoWorld feature reviews the key building blocks in agentic systems and with real-world examples from Shopify, Block, and others.

What goes into a solid MCP registry?

By Bill Doerrfeld • March 31, 2026
My latest InfoWorld feature explores what makes an enterprise MCP registry effective, from semantic discovery to governance and security for AI agents.

CISOs shift from perimeter security to API security

By Bill Doerrfeld • March 30, 2026
My first-ever contribution to CSO Online looks at the shifting landscape, from perimeter-based security to API security, and how CISOs are responding.

Fixing the AI slop problem in open source

By Bill Doerrfeld • March 29, 2026
My latest feature for The New Stack looks into solutions being proposed to fix open source Slopmageddon.
A digital pattern of rounded rectangular blocks in shades of blue and purple, arranged in an interlocking layout.

Agentic AI is reshaping platform engineering at Squarespace

By Bill Doerrfeld • March 27, 2026
My latest DirectorPlus looks at how agentic AI is reshaping platform engineering at Squarespace: less shared code and more developer experience focus.