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

Are shared libraries on their way out?

By Bill Doerrfeld • July 7, 2026
Big surprise: it's way easier to generate new code with AI than to reuse old code. But what are the long-term effects?

AI coding agents are now the default

By Bill Doerrfeld • June 25, 2026
Agentic coding tools have become the default. "When we've taken that away accidentally from people, they scream."

Your AI model might disappear tomorrow: what now?

By Bill Doerrfeld • June 17, 2026
My latest for LeadDev considers how engineering leaders should respond in the wake of uncertainty in the AI model market.

My research into 10 MCP gateways

By Bill Doerrfeld • June 10, 2026
I'm working with Zuplo on some new content around their MCP Gateway release. First up: a deep comparison of MCP gateways on the market!

Signs point to AI talent redistribution, not replacement

By Bill Doerrfeld • June 10, 2026
The constant barrage of AI layoffs is overshadowing the economic reasons behind these cuts, as well as the net-positive talent redistribution happening at large.

Reviewing MCP servers to connect with databases

By Bill Doerrfeld • June 8, 2026
My latest for InfoWorld reviews MCP servers and agent-ready tools for connecting AI agents with popular database styles.

When do you pull the plug on software projects?

By Bill Doerrfeld • May 29, 2026
For my latest DirectorPlus edition, Joel Carusone from NinjaOne shares how engineering leaders can build the muscle for making tough calls.
Close-up of a glowing laptop keyboard in blue light, viewed at an angle with the screen above

How MCP supports context engineering

By Bill Doerrfeld • May 25, 2026
My latest InfoWorld feature explores how Model Context Protocol (MCP) supports context engineering for AI-assisted coding.
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.