API Drifter
Open-source CLI and MCP server that checks a live API against its OpenAPI spec and reports which side to fix.
At a Glance
The CLI and engine are open source under Apache-2.0 and free to use; runs locally.
Engagement
Available On
Alternatives
Listed Nov 2026
About API Drifter
API Drifter is an open-source CLI and MCP server from the apidrifter organization. It runs an OpenAPI document against a live implementation and reports each mismatch with two fixes: one if the spec is the source of truth, and one if the implementation is. The same engine also diffs spec versions and MCP servers.
What It Is
API Drifter detects API drift, the gap between what a published OpenAPI document says and what the running API does. Examples include a field typed as an integer that arrives as a string, a required property that is sometimes missing, a null the schema forbids, or an undocumented status code. It is a command-line tool that can also run as an MCP server over stdio so coding agents can drive the same loop.
How the plan, run, report loop works
The engine reads the spec and proposes one request per operation, with the parameters, body and auth each needs. Values come from the spec's own examples, and a person, an agent, or a small plan file supplies the rest. Requests are sent to a dev, staging or production server, and responses are validated for status, media type, headers and body. Each finding is reported with a spec-side fix and an implementation-side fix. Output is JSON when piped, text in a terminal, or Markdown. Exit code 1 signals findings at or above the configured threshold, which suits CI.
Spec diffing and MCP coverage
The engine compares two spec versions and classifies changes as breaking, warning or info. It is polarity-aware, so a property becoming required is breaking in a request but harmless in a response. For MCP servers it snapshots tools, resources, prompts and server instructions and diffs them, tracking description changes because agents act on descriptions.
Agent and framework use
The MCP server exposes tools for planning, running, verifying, diffing, breaking changes, changelogs, MCP snapshots and listing rules. The project documents setup for Claude Code, Cursor, Windsurf and other MCP clients, a Claude Code plugin, and framework guides for FastAPI, Express, Hono, Fastify and NestJS. The CLI only contacts the server you point it at, and non-localhost URLs must be HTTPS.
Community Discussions
Be the first to start a conversation about API Drifter
Share your experience with API Drifter, ask questions, or help others learn from your insights.
Pricing
Open Source (Apache-2.0)
The CLI and engine are open source under Apache-2.0 and free to use; runs locally.
- CLI and MCP server (apidrifter serve)
- Plan and run requests against a live API and verify responses
- Spec diff and breaking-change detection
- MCP server snapshot and diff
- Runs locally; specs and reports stay local
Capabilities
Key Features
- Verifies a live API against its OpenAPI spec
- Two-sided fix suggestions for every finding
- Plan generation with fillable request slots
- 26 verification finding rules
- Polarity-aware spec diff with 357 change rules
- Breaking-change detection with CI exit codes
- MCP server snapshot and diff
- MCP server mode for coding agents
- Claude Code plugin and skill
- JSON, text and Markdown output
- Composite GitHub Action
- Framework guides for FastAPI, Express, Hono, Fastify and NestJS
