# Martin Loop

> Martin Loop is an MCP server for developer tools. Run coding agents with budgets, verifier checks, recovery and a clear handoff. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Platforms:** CLI
- **Repository:** https://github.com/keesan12/martin-loop
- **MCP Registry name:** io.github.Keesan12/martin-loop
- **Categories:** [developer tools](https://ai-powered.com/categories/developer-tools), [AI models and LLM tooling](https://ai-powered.com/categories/ai-and-llm)
- **Listing updated:** 2026-11-18

## About

MartinLoop wraps the coding job rather than writing code itself. You set an objective, verifier command, spend ceiling (--budget-usd) and iteration cap, and the job ends with VERIFIED, STOPPED or NEEDS REVIEW plus receipts. The README stresses that VERIFIED only proves the checks that were configured.

Its audit command reads Claude Code session history locally to report API-equivalent spend inside fix-and-retry loops, with an offline option. Work is local-first, with optional hosted dashboard sync. It supports runtimes such as Codex, Claude and Gemini, and passes any --model through unchanged. The @martinloop/mcp package adds the MCP interface.

## Features

- **Budget and iteration limits:** Hard spend and attempt ceilings per run.
- **Verifier evidence:** Completion needs fresh checks bound to the run.
- **Recovery state:** Keeps rollback evidence for retries or review.
- **Loop-tax audit:** Measures spend in fix-and-retry loops.
- **Dossiers and history:** Inspect results, failure classes and stored integrity.

## Good for

- Let a coding agent run a bounded job unattended
- Measure retry spend from Claude Code sessions
- Keep scope limits on agent edits
- Hand off a run with receipts

## Install

### Claude Code (Terminal)

```sh
claude mcp add martin-loop -- npx -y @martinloop/mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "martin-loop": {
      "command": "npx",
      "args": [
        "-y",
        "@martinloop/mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "martin-loop": {
      "command": "npx",
      "args": [
        "-y",
        "@martinloop/mcp"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "martin-loop": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@martinloop/mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "martin-loop": {
      "command": "npx",
      "args": [
        "-y",
        "@martinloop/mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "martin-loop": {
      "command": "npx",
      "args": [
        "-y",
        "@martinloop/mcp"
      ]
    }
  }
}
```

## FAQ

### Does it write code?

No; the coding agent does.

### Which runtimes?

Codex, Claude and Gemini are named.

### Is data sent anywhere?

Local-first; hosted sync is optional.

### How do I start?

Run `npx -y martin-loop@latest start`.

### How do I add Martin Loop to Claude Code?

Run this command in your terminal: claude mcp add martin-loop -- npx -y @martinloop/mcp

### What are the best alternatives to Martin Loop?

The closest alternatives to Martin Loop are REA, Context7, Chrome DevTools MCP, Codebase Memory and GitHub.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Context7](https://ai-powered.com/mcp/context7): Context7 is a freemium MCP server for developer tools.
- [Chrome DevTools MCP](https://ai-powered.com/mcp/chrome-devtools-mcp-2): Chrome DevTools MCP is an open-source MCP server for browser automation.
- [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.
- [awesome-mcp-servers](https://ai-powered.com/mcp/awesome-mcp-servers-2): awesome-mcp-servers 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.

---
Source: https://ai-powered.com/mcp/martin-loop
