# fieldtwin

> fieldtwin is an open-source MCP server for developer tools. Local twins of the Jobber, Housecall Pro and QuickBooks APIs for testing agents. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, macOS, Windows, Linux, self-hosted
- **Website:** https://nickgeorgeai.com/fieldtwin
- **Repository:** https://github.com/nickgeorgeseo/fieldtwin
- **MCP Registry name:** io.github.nickgeorgeseo/fieldtwin
- **Categories:** developer tools
- **Listing updated:** 2026-11-14

## About

fieldtwin starts a local server that imitates the Jobber, Housecall Pro and QuickBooks Online APIs, populated with a seeded fake trades business that has months of customers, jobs, quotes, invoices and payments. Point your code at localhost:4010 and it sees the same paths, headers and JSON shapes, kept consistent across all three systems or drifted on purpose.

The value is in the failures. You can add fault rules, load a scenario such as flaky-apis, throttle QuickBooks, lose a write response, deliver a webhook twice, or jump the clock so tokens expire. Checkpoints record what an agent or integration changed, and a rewind undoes it. The same seed gives byte-identical results, so a bug can be reproduced.

It is modeled from public docs rather than being production-identical; a FIDELITY.md file states how close it is, and a conformance suite scores it against real APIs. It runs on Node 22+, is Apache 2.0, and starts with npx fieldtwin. The MCP server launches its own twin.

## Features

- **Three APIs, one business:** Jobber, Housecall Pro and QuickBooks share the same fake company.
- **Failures on demand:** Rate limits, 5xx errors, lost answers and duplicate webhooks.
- **Time travel:** Advance the clock so tokens expire and events fire.
- **Checkpoints and rewind:** List what a run changed and undo it.
- **Seeded and repeatable:** The same seed builds the same world.
- **Auth modes:** Accept any token, or require tokens from its OAuth endpoints.

## Good for

- Let an AI agent make mistakes without touching client books
- Test retry logic against throttled QuickBooks calls
- Check webhook idempotency with duplicate deliveries
- Run many isolated API copies in CI
- Test a Jobber-to-QuickBooks sync with drifted data

## Install

### Claude Code (Terminal)

```sh
claude mcp add fieldtwin -- npx -y fieldtwin
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "fieldtwin": {
      "command": "npx",
      "args": [
        "-y",
        "fieldtwin"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "fieldtwin": {
      "command": "npx",
      "args": [
        "-y",
        "fieldtwin"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "fieldtwin": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "fieldtwin"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "fieldtwin": {
      "command": "npx",
      "args": [
        "-y",
        "fieldtwin"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "fieldtwin": {
      "command": "npx",
      "args": [
        "-y",
        "fieldtwin"
      ]
    }
  }
}
```

## FAQ

### Is it open source?

Yes, Apache 2.0, and it needs Node 22 or newer.

### Does it replace vendor sandboxes?

No. The author recommends a final check in a real sandbox before going live.

### Which port does it use?

4010 by default, set with FIELDTWIN_PORT.

### Is it identical to production?

No; it is modeled from public docs and FIDELITY.md says how closely.

### Is fieldtwin free?

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

### How do I add fieldtwin to Claude Code?

Run this command in your terminal: claude mcp add fieldtwin -- npx -y fieldtwin

### What are the best alternatives to fieldtwin?

The closest alternatives to fieldtwin 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/fieldtwin
