Skip to main content

8 posts tagged with "API"

Everything around building and operating APIs in modern systems. From design and documentation to reliability, observability, and governance. Focused on pragmatic, production-ready approaches.

View All Tags
MCP Resources: Adding Climate Data to Your Weather Server

MCP Resources: Adding Climate Data to Your Weather Server

Extend MCP servers with Resources for read-only data. Add 30-year climate normals to the weather server, understand Resource Templates, and combine Tools + Resources for powerful AI workflows.

11 min read
Publish Once or Fragment Forever? About the State of MCP Registries

Publish Once or Fragment Forever? About the State of MCP Registries

From modelcontextprotocol.io's Registry Preview and Generic Registry API to GitHub, Docker, Azure, Smithery, Raycast, MCP.so, PulseMCP, and FluidMCP—what MCP registries actually do and how to choose.

7 min read
AsyncAPI – Documenting Message-Driven APIs

AsyncAPI – Documenting Message-Driven APIs

How AsyncAPI complements OpenAPI for documenting asynchronous message-driven APIs, with a practical example, diagram, CI/testing tips, and documentation options.

4 min read
OpenAPI Specification 3.2 Released – What’s New?

OpenAPI Specification 3.2 Released – What’s New?

OpenAPI 3.2 brings path templating, new HTTP methods, streaming support, and richer documentation features.

5 min read
Internal API Documentation with Docusaurus

Internal API Documentation with Docusaurus

Docusaurus is great for public developer portals, but what if you want to keep your API documentation internal?

8 min read
Building API Documentation with Docusaurus

Building API Documentation with Docusaurus

Technical documentation is more than just a README - it’s a product in itself. For APIs, a clear and interactive documentation experience can make or break adoption.

5 min read