Building APIs for Developers and AI Agents

Key takeaways

APIs are foundational in modern software, facilitating essential connections between different services.
Every company is becoming an API company, making the quality of SDKs and documentation critical for developer experiences.
MCP represents a shift in how developers and AI agents interact with APIs, requiring new design considerations.
Designing tools for AI necessitates a focus on dynamic generation and streamlined interactions to address context limitations.
The future of API development will focus on creating clear standards and idiomatic SDKs for both human and AI users.

Summary

APIs as the Dendrites of the Internet

The podcast opens with the analogy that APIs function like dendrites in the internet's neural network, facilitating connections between various software components. As every company evolves into an API company, the importance of a robust API platform becomes evident, highlighting the necessity of SDKs, documentation, and adherence to best practices.

Building API Platforms: Lessons from Stripe

Alex Rattray shares insights from his time at Stripe, where he redesigned API documentation and focused on the significance of SDKs. He discusses the challenges faced in ensuring high-quality output and the need for well-typed SDKs to improve developer experience, emphasizing the importance of a cohesive developer experience.

MCP: APIs for AI Agents

The conversation dives into the Model Context Protocol (MCP), which reframes APIs as interfaces for large language models (LLMs). Alex explains the distinction between designing APIs for human developers and for AI agents, noting the unique challenges involved in creating an idiomatic interface for LLMs.

Challenges in Tool and Documentation Design

Discussion highlights the complexities of creating tools and documentation that are useful for both human developers and AI agents. Topics include context limitations, dynamic tool generation, and the necessity for comprehensive documentation to ensure LLMs can effectively interact with APIs.

The Future of Developer Platforms and SDKs

Looking ahead, Alex envisions a future where the role of API developers transforms with the rise of AI agents. He shares thoughts on the need for clearer API design standards and stronger, more idiomatic SDKs to meet the demands of both human and AI users.

Valuable Lessons from Collaboration with Leading API Companies

The episode concludes with Alex sharing insights from working with cutting-edge technology companies. He emphasizes the importance of considering the end-user experience and how API teams are evolving to be more user-centric in their approach.

Show notes

Stainless founder Alex Rattray joins a16z partner Jennifer Li to talk about the future of APIs, SDKs, and the rise of MCP (Model Context Protocol). Drawing on his experience at Stripe—where he helped redesign API docs and built code-generation systems—Alex explains why the SDK is the API for most developers, and why high-quality, idiomatic libraries are essential not just for humans, but now for AI agents as well.

They dive into:

The evolution of SDK generation and lessons from building at scale inside Stripe.
Why MCP reframes APIs as interfaces for large language models.
The challenges of designing tools and docs for both developers and AI agents.
How context limits, dynamic tool generation, and documentation shape agent usability.
The future of developer platforms in an era where “every company is an API company.”

Timecodes:

0:00 – Introduction: APIs as the Dendrites of the Internet

1:49 – Building API Platforms: Lessons from Stripe

3:03 – SDKs: The Developer’s Interface

6:16 – The MCP Model: APIs for AI Agents

9:23 – Designing for LLMs and AI Users

13:08 – Solving Context Window Challenges

16:57 – The Importance of Strongly Typed SDKs

21:07 – The Future of API and Agent Experience

24:45 – Lessons from Leading API Companies

26:14 – Outro and Disclaimers

Resources:

Find Alex on X: https://x.com/rattrayalex

Find Jennifer on X: https://x.com/JenniferHli

Stay Updated:

Let us know what you think: https://ratethispodcast.com/a16z

Find a16z on Twitter: https://twitter.com/a16z

Find a16z on LinkedIn: https://www.linkedin.com/company/a16z

Subscribe on your favorite podcast app: https://a16z.simplecast.com/

Follow our host: https://x.com/eriktorenberg

Please note that the content here is for informational purposes only; should NOT be taken as legal, business, tax, or investment advice or be used to evaluate any investment or security; and is not directed at any investors or potential investors in any a16z fund. a16z and its affiliates may maintain investments in the companies discussed. For more details please see a16z.com/disclosures.

Stay Updated:

Find a16z on YouTube: YouTube

Find a16z on X

Find a16z on LinkedIn

Listen to the a16z Show on Spotify

Listen to the a16z Show on Apple Podcasts

Follow our host: https://twitter.com/eriktorenberg