# Tiltmeter

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

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 1 repo stars
- Author: tiltmeter-dev
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/tiltmeter-dev/tiltmeter
- Updated: 2026-10-28
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/tiltmeter

## What it 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.

## Requirements
- Needs: Python and uv (commands run via uvx)
- Environment variables: `TILTMETER_CONFIG`, `ANTHROPIC_API_KEY` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
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>

### Codex

**Platform CLI**
```bash
codex mcp add tiltmeter --env TILTMETER_CONFIG=<TILTMETER_CONFIG> --env ANTHROPIC_API_KEY=<ANTHROPIC_API_KEY> -- 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>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "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>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "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>

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e TILTMETER_CONFIG=<TILTMETER_CONFIG> -e ANTHROPIC_API_KEY=<ANTHROPIC_API_KEY> 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>

## When to use it
- 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
- 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.

## Similar
- [bearer](https://affpapa.org/en/nevibecode/skills/bearer.md) — skill · 302 installs
- [Meta Social Technologies MCP](https://affpapa.org/en/nevibecode/mcp/meta-social-technologies-mcp.md) — MCP server · ★ 18 repo stars
- [codometer-measure](https://affpapa.org/en/nevibecode/skills/codometer-measure.md) — skill · 363 installs
- [cost-diff](https://affpapa.org/en/nevibecode/skills/cost-diff.md) — skill · 248 installs
- [pp-apartments](https://affpapa.org/en/nevibecode/skills/pp-apartments.md) — skill · 242 installs
- [blueprint](https://affpapa.org/en/nevibecode/skills/wordpress-blueprint.md) — skill · 4300 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
