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
claude mcp add --env TILTMETER_CONFIG=<TILTMETER_CONFIG> --env ANTHROPIC_API_KEY=<ANTHROPIC_API_KEY> --transport stdio tiltmeter -- uvx tiltmeterWhat 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_driftedfor its endpoint and report any warning or breaking changes. - Use
get_schemato inspect the expected fields and types, then compare them with the response. - Run
check_alland 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 tiltmeterReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from tiltmeter <command>
Platform CLI
codex mcp add tiltmeter --env TILTMETER_CONFIG=<TILTMETER_CONFIG> --env ANTHROPIC_API_KEY=<ANTHROPIC_API_KEY> -- uvx tiltmeterReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from tiltmeter <command>
Config file
{
"mcpServers": {
"tiltmeter": {
"command": "uvx",
"args": [
"tiltmeter"
],
"env": {
"TILTMETER_CONFIG": "<TILTMETER_CONFIG>",
"ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>"
}
}
}
}Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from tiltmeter <command>
Config file
{
"servers": {
"tiltmeter": {
"type": "stdio",
"command": "uvx",
"args": [
"tiltmeter"
],
"env": {
"TILTMETER_CONFIG": "<TILTMETER_CONFIG>",
"ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>"
}
}
}
}Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from tiltmeter <command>
Platform CLI
gemini mcp add -e TILTMETER_CONFIG=<TILTMETER_CONFIG> -e ANTHROPIC_API_KEY=<ANTHROPIC_API_KEY> tiltmeter uvx tiltmeterReplace <…> 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.