# Keyframer Inspector

> Keyframer Inspector is an open-source MCP server for developer tools. MCP server that lets coding agents record, slow down and test app animations. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** macOS, Windows, Linux, iOS, Android, CLI
- **Website:** https://keyframer.dev/inspector
- **Repository:** https://github.com/keyframer-dev/inspector
- **MCP Registry name:** dev.keyframer/inspector
- **Categories:** developer tools
- **Listing updated:** 2026-11-14

## About

Keyframer Inspector is a motion debugger, and its MCP server is built into the desktop app, enabled with one switch in Settings. An agent can record the app, run its scenarios, read the trace and the problems list and take screenshots, then use check and recheck to measure, change code and measure again until the motion problems are gone. The registry also lists an npm package that runs over stdio.

The SDKs, MIT licensed, cover React Native with Reanimated, Flutter, iOS (UIKit and opt-in SwiftUI) and Android (Views and opt-in Compose). Animations show up with the line of code that started them. They can be slowed from 1x down to 0.1x, paused and frame-stepped, and spring curves can be dragged and written back to source. The Problems tab ranks issues like animations ignoring Reduce Motion, off-screen animation and render-cost hints by the frames they cost.

For CI, check files state expectations such as settle time and overshoot, and keyframer-inspect ci holds pull requests to them. The debugger is free; a separate production monitoring product, Motion Vitals, is described as coming soon.

## Features

- **Agent fix loop:** check and recheck let an agent measure, edit and re-measure motion.
- **Slow motion and stepping:** Run at 0.1x to 1x, pause and step one frame at a time.
- **Tune and apply:** Drag spring curves and write numbers back to the source line.
- **Ranked problems:** Dropped frames, ignored Reduce Motion and render hints are sorted by frame cost.
- **CI check files:** Readable files assert settle time, overshoot and no dropped frames.
- **Four platforms:** React Native, Flutter, iOS and Android SDKs, with a desktop app.

## Good for

- Have an agent fix a janky screen transition and verify it
- Retune a spring animation by dragging its curve
- Gate pull requests on motion regressions
- Find animations that ignore Reduce Motion
- Compare two recorded sessions before and after a change

## Install

### Claude Code (Terminal)

```sh
claude mcp add inspector --env KEYFRAMER_VITALS_READ_KEY='<KEYFRAMER_VITALS_READ_KEY>' -- npx -y @keyframerdev/inspector
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "inspector": {
      "command": "npx",
      "args": [
        "-y",
        "@keyframerdev/inspector"
      ],
      "env": {
        "KEYFRAMER_VITALS_READ_KEY": "<KEYFRAMER_VITALS_READ_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "inspector": {
      "command": "npx",
      "args": [
        "-y",
        "@keyframerdev/inspector"
      ],
      "env": {
        "KEYFRAMER_VITALS_READ_KEY": "<KEYFRAMER_VITALS_READ_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "inspector": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@keyframerdev/inspector"
      ],
      "env": {
        "KEYFRAMER_VITALS_READ_KEY": "<KEYFRAMER_VITALS_READ_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "inspector": {
      "command": "npx",
      "args": [
        "-y",
        "@keyframerdev/inspector"
      ],
      "env": {
        "KEYFRAMER_VITALS_READ_KEY": "<KEYFRAMER_VITALS_READ_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "inspector": {
      "command": "npx",
      "args": [
        "-y",
        "@keyframerdev/inspector"
      ],
      "env": {
        "KEYFRAMER_VITALS_READ_KEY": "<KEYFRAMER_VITALS_READ_KEY>"
      }
    }
  }
}
```

## Tools

- `check`: Measures motion and reports problems for the agent fix loop.
- `recheck`: Re-measures motion after a code change.

## FAQ

### Is the debugger free?

Yes. The debugger is free and every SDK is MIT licensed.

### Which coding agents are supported?

Claude Code, Codex, Cursor, VS Code, Windsurf, Zed and Claude Desktop are named.

### Which platforms are covered?

React Native, Flutter, iOS and Android, with a desktop app for macOS, Windows and Linux.

### What is Motion Vitals?

A production monitoring plan priced by sessions a month, listed as coming soon, with a free 1,000-session tier.

### Is Keyframer Inspector free?

Yes. Keyframer Inspector is open source, so you can use and self-host it for free.

### How do I add Keyframer Inspector to Claude Code?

Run this command in your terminal: claude mcp add inspector --env KEYFRAMER_VITALS_READ_KEY='<KEYFRAMER_VITALS_READ_KEY>' -- npx -y @keyframerdev/inspector

### What are the best alternatives to Keyframer Inspector?

The closest alternatives to Keyframer Inspector are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/keyframer-inspector
