Schrödinger's Protocol

AI tooling for APIs is moving so quickly, it can be difficult to tell who's winning. Also in this edition: State of API DevX survey, OpenAPI on BlueSky, Mobile GraphQL at Meta in 2025, and a dev's guide to API-first design

Schrödinger's Protocol

Posts about Model Context Protocol (MCP) have dominated my API socials. Either the end of OpenAPI is now, or we don't need MCP as we have OpenAPI. Both of these takes miss the mark; check out our previous newsletter (MCP ❤️ APIs) for what MCP is and how OpenAPI fits it. We have included a fantastic article from our Slack community on MCP in this newsletter.

Easter is fast approaching, and I have decided to take a holiday this year. I will be spending my time eating chocolate surrounded by beautiful Karri trees. Happy Easter to everyone.

-- Alexander

Help shape the future of APIs

Take the Survey

The API Round-Up

API News, links, and tools from around the web

Hot Chocolate

Trying to keep up with the Easter theme, I remembered that .Net has a great GraphQL server called Hot Chocolate. It is fully compliant with the latest specs, which makes it compliant with all clients, such as Strawberry-Shake, Relay, Apollo and more. We do love naming things, aye 😅.

OpenAPI Org is now on BlueSky

Over the last six to eight months, the tech sector has found a prominent home on BlueSky. While there are still people on Mastodon and Twitter, BlueSky is growing. It's great to finally have the OpenAPI Org on there.

OpenAPI Community Hero – Phil Sturgeon

Why does Phil spend so much time driving development in the OpenAPI space? What is he excited about, and what does he see as the future of OpenAPI? Phil shares some insights on the OpenAPI blog.

Choosing Your OpenAPI Strategy with Quarkus vs. Spring

Working in enterprise for the last two years has forced me to write a lot of Java/Kotlin and Spring Boot. I have never enjoyed how Spring favours the code-first approach to building APIs. It leads to more work, more code, and a bastardised version of trying to do design first. Quarkus, an alternative to Spring, is growing in popularity. It has fixed these issues and offers a spec-first approach.

Mobile GraphQL at Meta in 2025

Sabrina from Meta's Mobile GraphQL Platform Team talks to Pascal Hartig about Meta's evolution of GraphQL. They discuss data fetching on mobile devices and how they use GraphQL to improve user experiences. It is an enjoyable listen that covers how they build on the GraphQL system.

OpenAPI: How to Handle File Management

Lorna Mitchell is back with another killer article focusing on managing large OpenAPI specs by splitting them into separate files. This is a great approach using the $ref syntax, which allows you to choose the ideal level of file granularity based on your needs.


APIs You Won't Hate

The latest from the team at API's You Won't Hate.

A Developer's Guide to API Design-First

API Design gets floated around a lot, but what does it mean, and how do you implement it? Put down your code first approaches, learn the benefits, and start building and designing first when it comes to APIs.

Enforcing API Consistency for Large Teams

Keeping APls consistent in large organizations to speed up integrations, improve code-reuse, and avoid wasting time and money.


From our Community

Articles written and shared in our free Slack community.

Breaking Down MCP: An Architectural Analysis

Kevin's excellent post in our Slack group breaks down the Model Context Protocol. He answers some great questions, from why create another protocol to whether REST would have been more web-friendly. Thanks for sharing, Kevin.

Got a buck to spare?

When you become an APIs You Won't Hate member, you'll get access to members-only content while directly supporting our work. Your support helps us to keep making resources for the API community.

Become a paid member

Thanks so much to our members: Kin L, Juxt, Alex R, Nolan S, Frank, James D, Bill D, Rich, and Umair. Your support means the world to us!

Until next time,
Alexander, Phil & Mike