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

KubeCon + CloudNativeCon North America 2026 keynote stage with the
By Bill Doerrfeld • November 10, 2026
At KubeCon NA 2026, the opening keynotes made it clear: AI inference is the new cloud native production workload. Here's what that means for Kubernetes.
Agentics Day: MCP + Agents North America title slide on the screen at KubeCon NA 2026
By Bill Doerrfeld • November 10, 2026
Agents are getting production tested. I explore some of the top lessons learned at KubeCon NA 2026's co-located event, Agentics Day: MCP + Agents.
KubeCon + CloudNativeCon North America 2026 graphic: November 9-12, Salt Lake City, Utah
By Bill Doerrfeld • November 6, 2026
I'll be at KubeCon + CloudNativeCon NA 2026 in Salt Lake City, Nov 9–12, scouting stories on agentic AI, cloud native and APIs. Reach out if you'd like to connect!
AI Pen-Testing Conference graphic from AI Security University
By Bill Doerrfeld • November 4, 2026
Another virtual conference is in the bag, and the community really showed up to talk AI penetration testing.
By Bill Doerrfeld • October 30, 2026
My eight-part Road to KubeCon column with The New Stack is done. Here are some of the key takeaways.
How AI Agents Change API Interaction opening slide doerrfeld bill 2026 nordic apis
By Bill Doerrfeld • October 18, 2026
Here are my slides from my opening keynote at Nordic APIs Summit 2026, exploring how AI agents are changing API interaction patterns.
By Bill Doerrfeld • October 17, 2026
My latest research for AI Security University looks at AI tools and resources for pen-testers, red teamers, and bug bounty hunters.
By Bill Doerrfeld • October 16, 2026
My commissioned feature for Arthur D. Little's PRISM publication analyzes the big shifts underway now that generating code is becoming trivial.
By Bill Doerrfeld • October 11, 2026
Was happy to participate as a speaker and moderator at SecureMaine on October 8th, 2026.
By Bill Doerrfeld • October 5, 2026
My latest for LeadDev interviews a Meta engineer who built an agentic system to optimize their capacity planning, leading to real power use savings.