/
Engineering
Engineering
SDK code mode shows SotA accuracy and performance for agents using APIs

Pierce Clark

Kevin Whinnery
Code execution is a new technique to power MCP tools through LLM-generated code. Stainless has observed that a technique we call "SDK code mode" provides state-of-the-art performance and accuracy for MCP tools that expose an API. Learn how SDK code mode works, and check out our eval results in this post.
Originally posted
Mar 2, 2026
Engineering
Do you need an SDK?

Kevin Whinnery
In this post, we examine the reasons you might consider building an SDK for your product. SDKs speed developer adoption, reduce support burden, unlock enterprise customers, and help LLMs use your API more effectively.
Originally posted
Jan 8, 2026
Engineering
How to make your API a catalyst for growth

Justin Michael
Learn how to maximize the growth potential of your API and minimize your costs at the same time.
Originally posted
Dec 11, 2025
Engineering
Should you hand-write your SDK or use a generator?

Kevin Whinnery

CJ Avilla
A practical guide for API platform teams deciding between hand-written SDKs and generators like Stainless. It breaks down when generation wins (HTTP-heavy, multi-language, spec-driven clients), when custom code is better (logic-first libraries), and why a hybrid approach often delivers the best developer experience.
Originally posted
Dec 8, 2025
Engineering
How to gracefully handle resource variants in your REST API

Bruce Hill
Handling multiple resource variants in a REST API can be a tricky design challenge, with many considerations and trade-offs to take into account. In this post, we’ll look at an AI image generation API as an example, but the concepts we’re going to discuss are broadly applicable to any API with multiple resource variants.
Originally posted
Sep 19, 2025
Engineering
Escaping Maven dependency hell

Tomer Aberbach
When your job is building SDKs, a dependency manager that defies everyone’s expectations can wreak havoc, and working around third-party behavior can be tricky. Learn how and why we rejected a quick fix and took the time to develop a robust solution that meets our high quality bar.
Originally posted
Jul 3, 2025
Engineering
MCP is eating the world—and it's here to stay

Young-jin Park
Despite the hype, Model Context Protocol (MCP) isn’t magic or revolutionary. But, it’s simple, well-timed, and well-executed. At Stainless, we’re betting it’s here to stay.
Originally posted
Jun 21, 2025
Updated!
Engineering
API to MCP: step-by-step guide for developers

CJ Quines
Learn how to convert APIs into MCP servers using OpenAPI and Stainless. A technical guide to structuring tools, schemas, and workflows when generating MCP servers.
Originally posted
Jun 13, 2025
Updated!
Engineering
SDK vs API: why SDKs complete your API

CJ Quines
SDKs aren't just wrappers. They shape developer experience, reduce support burdens, and future-proof your API for AI.
Originally posted
May 15, 2025
Engineering
Lessons from complex OpenAPI spec to MCP server conversions
How we handled $refs, client quirks, recursive schemas, and tool selection in a clean, extensible way.
Originally posted
May 7, 2025
Engineering
Making Java enums forwards compatible

Tomer Aberbach
Ensure forwards compatibility in Java SDKs by wrapping enums with a fallback _UNKNOWN case.
Originally posted
Feb 10, 2025
Engineering
Making Java nullable fields backwards compatible

Tomer Aberbach
How to preserve source and binary compatibility for nullable fields in Java.
Originally posted
Jan 29, 2025