$cat ~/blog/retrofitting-apis.md
file info~/blog/retrofitting-apis.md
date·May 12, 2026size·~6 min read
────
//

Your APIs Weren't Built for This

/*Your APIs were built for developers. AI agents are a different beast entirely and most enterprise infrastructure isn't ready for them.*/

##The Infrastructure Problem No One Talks About


There’s a quiet infrastructure problem showing up in more and more companies right now. It doesn’t get talked about much, and it definitely doesn’t make headlines, but it’s quietly killing a lot of AI projects before they ever make it to production.

At a high level, the issue is simple. Most APIs were built for humans. Now they’re being asked to serve machines.

##How We Got Here


For years, the model was straightforward. A developer reads some documentation, writes an integration, and that integration does one thing well. Maybe it pulls a report every hour. Maybe it syncs customer data once a day. Everything is predictable, paced, and designed around a human understanding what’s going on.

That model is breaking down.

Agents in 2026 don’t behave like that. They don’t just call one endpoint and stop. They plan, they branch, they retry, they explore. They might hit ten or twenty endpoints in a single loop just to complete what looks like one task from the outside. And they don’t just need APIs to respond, they need APIs to guide them.

That’s where things start to fall apart.

##The Reality Inside Most Enterprises


If you spend time inside most enterprise environments, you start to see the same pattern. Systems that have been around for a decade or more. ERPs that were customized beyond recognition. Internal tools that only a handful of people really understand. APIs layered on top over time, sometimes clean, sometimes barely there.

None of this was built with autonomous systems in mind.

And when you put an agent on top of that stack, the friction shows up immediately.

Speed becomes an issue because agents operate in bursts, not in scheduled intervals. Context becomes an issue because APIs expose endpoints, not intent. Reliability becomes an issue because error handling was written for humans who can interpret ambiguity, not for systems that need structure. But the biggest problem, the one that keeps coming up over and over, is state.

Most real workflows aren’t single-step. They’re sequences. They depend on memory, on continuity, on knowing what happened three calls ago. Stateless APIs make that awkward even for humans, but for agents it becomes a constant source of failure.

So you end up in this strange place where the models themselves are good enough, sometimes more than good enough, but the infrastructure underneath them can’t keep up.

##What’s Changing Right Now


What’s interesting is that the industry clearly sees this now. MCP, the Model Context Protocol, is one of the more visible attempts to fix the gap. The idea is not to replace existing APIs, but to wrap them in something that agents can actually reason about. Something discoverable, structured, and consistent.

From what I’ve seen and heard, that layer alone can collapse integration time dramatically. What used to take days can sometimes be done in minutes, mostly because the agent no longer has to guess how to use a tool.

At the same time, there’s this parallel path emerging with computer use. Instead of fixing the API layer, you sidestep it entirely. If a human can click through a system, an agent can too. It’s not elegant, but it works, especially in environments where rewriting or even exposing APIs just isn’t realistic.

##The Hard Problems Underneath


Even with these approaches, though, the harder problems are still sitting underneath.

Security starts to look different when actions are chained autonomously instead of executed one at a time. It becomes less clear who is responsible for what, especially when something goes wrong. Data is another layer entirely. Most companies don’t have a single, clean source of truth. They have fragments scattered across systems, formats, and teams. Wrapping APIs helps, but it doesn’t unify the underlying reality.

And then there’s the gap between demos and production. A lot of teams can get something working in a controlled environment. Very few have something that runs reliably at scale without constant supervision.

That gap feels like the real story.

##What Comes Next


There’s a lot of momentum right now, and the timelines being thrown around are aggressive. More applications embedding agents, more tooling, more standards. But underneath all of that, the same constraint keeps showing up. The systems we built over the last twenty years weren’t designed for this mode of operation.

They assumed a human in the loop.

What seems to be working, at least for the teams making progress, is not wholesale replacement. It’s more incremental than that. Wrapping instead of rewriting. Standardizing instead of rebuilding. Treating integration points as first-class problems instead of afterthoughts.

It’s less about having the newest stack and more about how intentional the plumbing is.

##The Real Takeaway


Because at some point, an agent is going to hit a system at an odd hour, follow a path no one explicitly designed, and rely entirely on how well those edges were defined. And when something breaks, there isn’t going to be a developer stepping in to interpret a vague error message.

That’s the environment these systems are moving into.

And it feels like most of the work ahead isn’t about making models smarter. It’s about making everything around them a little more legible.

###Sources and references, based on publicly discussed trends and releases:


Anthropic, announcement of Model Context Protocol, November 2024
OpenAI, MCP adoption updates, April 2025
Microsoft Copilot Studio integrations, mid 2025
AWS announcements on agent tooling support, late 2025
Gartner forecasts on agentic AI adoption and project failure rates
Deloitte reports on enterprise AI adoption and production readiness

────
──EOF──cd ~/blog