Skip to main content
MCP server CX Codex

Tiltmeter — Claude Code MCP server: API drift, install

Tiltmeter watches the shape of third-party JSON responses and alerts agents when an API changes before new data reaches dependent code.

MIT ★ 1 updated 2026-10-28

Install into Claude Code · Platform CLI All methods and platforms ↓
claude mcp add --env TILTMETER_CONFIG=<TILTMETER_CONFIG> --env ANTHROPIC_API_KEY=<ANTHROPIC_API_KEY> --transport stdio tiltmeter -- uvx tiltmeter
Open on GitHub

What Tiltmeter does

Tiltmeter records a baseline for the JSON APIs you call, then compares later responses with it. The server detects removed or renamed fields, type changes, null values and new fields. Its MCP tools include has_drifted, get_schema, get_changes, check_api and check_all, so an agent can inspect expected fields and recent changes before using an API.

Run it locally with uvx tiltmeter. tiltmeter init creates tiltmeter.yaml, while tiltmeter check tests the configured endpoints; breaking drift can fail a CI build through the command's exit status. Tiltmeter keeps its local state in SQLite and does not send response bodies to the language model. Slack and webhook alerts are supported.

ANTHROPIC_API_KEY is needed for change explanations. To monitor your own APIs, create the configuration with tiltmeter init first; without that file there are no configured endpoints to check.

What it helps with

  • detect a changed JSON API schema
  • spot fields renamed by a provider
  • check response types before trusting an API
  • fail CI on breaking API drift
  • give an agent the changes needed for a code fix

Example prompts for the agent

  • Before relying on this API, call has_drifted for its endpoint and report any warning or breaking changes.
  • Use get_schema to inspect the expected fields and types, then compare them with the response.
  • Run check_all and summarize changes that could break the current code.

How to install Tiltmeter

Platform CLI

claude mcp add --env TILTMETER_CONFIG=<TILTMETER_CONFIG> --env ANTHROPIC_API_KEY=<ANTHROPIC_API_KEY> --transport stdio tiltmeter -- uvx tiltmeter

Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from tiltmeter <command>

Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more

Questions about Tiltmeter

How do I install Tiltmeter in Claude Code?

Run claude mcp add tiltmeter -e ANTHROPIC_API_KEY=<ANTHROPIC_API_KEY> -- uvx tiltmeter.

What does Tiltmeter do?

It compares the observed shape of third-party JSON API responses with a baseline, then reports schema drift to agents and CI.

Do I need an API key to use Tiltmeter?

ANTHROPIC_API_KEY is needed for explanations of detected changes. Basic API checks and schema comparisons use tiltmeter check.

Similar MCP servers

All MCP servers for Agent setup: memory, context, orchestration →

Project sponsors

Companies that keep this analytics open