Tiltmeter
Warn agents when a third-party API changes shape, with the fix as a pull request
- Pricing
- Free
- Platforms
- CLI, API
- Runs
- Locally
- Version
- 0.5.1
- Listing updated
- 3 days ago
About Tiltmeter
Tiltmeter is a free MCP server for developer tools. It runs locally on your machine and is started by your AI client.
Tiltmeter learns the structure of an API's JSON responses from real traffic, then flags drift: a renamed field, a null where a value used to be, or a number that became a string. Changes are graded breaking, warning or info, and a removed field beside a similar new one is flagged as a probable rename. Only response shape is stored, not bodies, in a local SQLite file with no account.
The MCP server lets Claude Code, Cursor or LangChain agents call has_drifted before trusting an API, and get_schema to see which fields to expect. The CLI adds tiltmeter scan, which searches a folder for uses of known retired or moved APIs, and tiltmeter fix, which has an agent adapt the code and open a pull request. ANTHROPIC_API_KEY is only needed for explanations written by Claude.
The website also pitches a provider mode: an API provider publishes one signed notice and each customer's repository gets a pull request. Its public test opened 84 such pull requests, of which 18 were merged.
Install
Run in a terminal
claude mcp add tiltmeter --env ANTHROPIC_API_KEY='<ANTHROPIC_API_KEY>' -- uvx tiltmeterAdd to claude_desktop_config.json
{
"mcpServers": {
"tiltmeter": {
"command": "uvx",
"args": [
"tiltmeter"
],
"env": {
"ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"tiltmeter": {
"command": "uvx",
"args": [
"tiltmeter"
],
"env": {
"ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"tiltmeter": {
"type": "stdio",
"command": "uvx",
"args": [
"tiltmeter"
],
"env": {
"ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"tiltmeter": {
"command": "uvx",
"args": [
"tiltmeter"
],
"env": {
"ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"tiltmeter": {
"command": "uvx",
"args": [
"tiltmeter"
],
"env": {
"ANTHROPIC_API_KEY": "<ANTHROPIC_API_KEY>"
}
}
}
}Configuration
TILTMETER_CONFIGPath to tiltmeter.yaml. Defaults to tiltmeter.yaml in the working directory.ANTHROPIC_API_KEYOnly needed for explanations written by Claude.
Tools this server provides (2)
Taken from the project documentation; the running server may differ.
- has_drifted
- Lets an agent check whether an API has changed before trusting it.
- get_schema
- Shows which fields an API response is expected to have.
What it does
- Drift detection
- Learns response shape and flags renamed, nulled or retyped fields.
- Agent pre-check
- has_drifted and get_schema let an agent verify an API before using it.
- Known-change scan
- Searches code for retired models and moved endpoints.
- Fix as pull request
- Hands drift to an agent that edits code and opens a PR.
- CI gate
- Exit codes fail builds on breaking drift; Slack and webhook alerts are supported.
Good for
- Catch an API field rename before agents act on bad data
- Find code still calling a retired model
- Gate CI on breaking API drift
- Publish a signed deprecation notice as an API provider
Pricing
Free
Free for developers building on others' APIs; provider pricing not published
Prices change. Check tiltmeter.dev before you buy.
Tiltmeter FAQ
Does it need an account?
No. The README says it uses one SQLite file and no account.
Are response bodies sent to an LLM?
No. Only their shape is used.
How do I install it?
Use pip install tiltmeter or uv tool install tiltmeter, then run tiltmeter init.
Does it cost anything?
The site says Tiltmeter is free for developers building on someone else's API.
Is Tiltmeter free?
Yes. Tiltmeter is free to use.
How do I add Tiltmeter to Claude Code?
Run this command in your terminal: claude mcp add tiltmeter --env ANTHROPIC_API_KEY='<ANTHROPIC_API_KEY>' -- uvx tiltmeter
What are the best alternatives to Tiltmeter?
The closest alternatives to Tiltmeter are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.
Alternatives to Tiltmeter

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Ouroboros
MCP serverSpec-first layer that pins requirements and verifies results of AI coding agent work
Runs locally- Open source
- 6.4K GitHub stars
- Developer tools