Skip to content
MCP server

Tiltmeter

Warn agents when a third-party API changes shape, with the fix as a pull request

Runs locallyStatus and history
Install
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 tiltmeter

Add 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

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools