API Evangelist Papers
Formal, practitioner-focused white papers by Kin Lane — vendor-neutral, read from evidence a machine can check rather than from anybody's marketing, and revised on a regular cycle. Each one takes a single practice and distills it into about twenty pages you can act on, at $25.00 a paper. Instant download. Every paper is listed below — or, if you'd rather start from the problem you're trying to solve, start there.
The Fundamentals of API Discovery
The unglamorous prerequisite under governance, security, and AI — inventory as archaeology, the taxonomy of the dead, machine-readable discovery on...
The Fundamentals of API Governance
The real governance stack — landscape mapping, OpenAPI, JSON Schema, policies and Spectral rules, design-first vs. code-first, Git, IDE, CI/CD, shi...
The Fundamentals of API Evangelism
The technology was always the easy part — belief before adoption, internal-first, the blog as a compounding asset, outreach and onboarding, communi...
Publishing a Public MCP Server
Treat MCP as part of your API operations, not a science project — the three provider archetypes, the build → auth → curate → host → govern → distri...
Publishing an API Portal
The portal is not your API and not your product — it's the human-readable front door to an operation you should already be running, and now it has ...
The API Rating Rubric, Explained
Every API provider in the APIs.io catalog carries a Kin Score — a 0–100 composite across six facets, a standalone Agent Readiness score beside it, ...
The Fundamentals of the API Lifecycle
The protocol, the architecture, and the wave you rode in on are not what decide whether an API succeeds — managing the whole lifecycle, end to end,...
The Pricing of AI APIs
The AI labs are the most pricing-transparent class of API provider there is — and that transparency is the lesson. Real per-token rates across the ...
The Pricing of Communication APIs
Communication APIs are where the industry learned to meter — and where the headline rate is almost never the real rate. Real per-message, per-email...
The Pricing of Payment APIs
Payment APIs charge a percentage of the value moved, not the cost of service — the purest take-rate model in the API economy, and where AI pricing ...
Delivering a Modern API Integration Page with Arazzo
You should not be building integrations anymore — you should be describing them. An integration is two ends and a wire; both ends already publish O...
Making API Governance Conversational
Your Spectral ruleset can reach the IDE and the pipeline — but not the conversation, which is now where APIs get designed. Wrapping your governance...
Running a Local Food Business on APIs
The first API Evangelist bundle — a paper clipped to a working APIs.json artifact. An operation is a set of capabilities, and every capability wort...
The Fundamentals of API Reusability
Reuse fails before the first line of code — a measurable, three-axis framing of API reusability (design, operational, composability), semantic dupl...
The Agent-Era API Standards Onramp
The five-year API maturity journey is now a five-week onboarding, and the team shipping its first public API is staring at OpenAPI, JSON Schema, Ar...
The Fundamentals of Context Engineering
The discipline behind the emerging "context engineer" role — context as a governed, lifecycle artifact, not a prompt you tune. Ownership of the REA...
MCP Documentation Beyond Reference
The assumption that AI will figure out how to use your MCP server is wrong. Reference documentation describes the interface; operational documentat...
Explicit Agent Boundaries
We enforce coding standards and CI gates on code, and nothing on the Markdown files that now drive agent behavior — README, CONTRIBUTING, AGENTS.md...
The List of List Sellers
I publish three email addresses so people can reach me, and the cost of that choice arrives as a very specific genre of mail: someone offering the ...
The Fundamentals of Markdown
A complete reference to the markdown layer — the 2004 origin and the four formats it borrowed from, the twenty-year specification vacuum that Commo...
Change on the Agent Surface
Everything the industry knows about API change assumes a consumer who reads. Three layers govern change in MCP, the discipline degrades as it appro...
Onboarding Agents to an API
Every onboarding step the industry built assumes a person with a browser. This paper is a provider's guide to onboarding a caller that cannot use o...
About API Evangelist White Papers
These differ from a blog post or a vendor white paper in three ways: the recommendations come from doing the work at scale, no sponsor steers the conclusions, and each is a living document carrying a version and an "as of" date. Buy once and you get every future revision of that paper.