All posts

Fundamentals

What is contract drift (and why uptime checks miss it)

Contract drift is when live API or MCP response shapes change while HTTP status stays 200 — and how to detect it before users do.

Uptime monitoring answers one question: did the endpoint respond? Contract drift answers another: did the shape of the response still match what your code expects? Vendors change JSON schemas silently — required fields disappear, enums gain values, MCP tools vanish from tools/list — while returning HTTP 200.

Contract drift vs. downtime

  • Downtime: connection failures, 5xx, timeouts — traditional monitors catch these.
  • Contract drift: schema changes that break parsers, agents, and integrations without tripping uptime.

Agent teams feel this first: a removed MCP tool fails mid-workflow even though the server is “up.” Platform teams see it as deserialization errors in production while synthetic checks stay green.

Why fixtures and CI are not enough

Checked-in OpenAPI specs and mocked responses test what you ship. They do not observe third-party APIs that change on their own cadence. Pair in-repo diff with live vendor monitoring so merge-time gates and scheduled watches cover both sides of the boundary.

How DriftGuard classifies change

Baseline a live URL or MCP catalog, diff on a schedule, and label each change breaking, warning, or info. Route breaking events to Slack or PagerDuty; keep the rest in an audit timeline for postmortems.

Explore drift detection, API monitoring, and MCP monitoring — or paste two JSON blobs into the compare tool to see classified diffs instantly.

Start on one endpoint

Start a free trial on a single vendor URL or MCP server. When contract drift lands, you get a diff — not a vague “something broke in prod.”

Watch your first contract free

Paste a vendor URL or MCP endpoint — baseline in minutes, alert on breaking drift.