Skip to content
MCP server

fieldtwin

Local twins of the Jobber, Housecall Pro and QuickBooks APIs for testing agents

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, macOS, Windows
Runs
Locally
Version
0.5.3
Listing updated
2 days ago

About fieldtwin

fieldtwin is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

claude mcp add fieldtwin -- npx -y fieldtwin

Add to claude_desktop_config.json

{
  "mcpServers": {
    "fieldtwin": {
      "command": "npx",
      "args": [
        "-y",
        "fieldtwin"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "fieldtwin": {
      "command": "npx",
      "args": [
        "-y",
        "fieldtwin"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Configuration

  • FIELDTWIN_PORTThe port the twin listens on. The MCP server starts a twin of its own, so pick another port if one already runs on 4010.
  • FIELDTWIN_HOSTThe address the twin listens on. Keep the loopback address unless something else must reach the twin.
  • FIELDTWIN_AUTHany-token accepts any Bearer token; oauth accepts only tokens from the twin's OAuth endpoints.
  • FIELDTWIN_SEEDWhich fake business to generate: the same seed builds the same world.

What it does

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

Pricing

Open source

Apache 2.0.

Prices change. Check nickgeorgeai.com before you buy.

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 to fieldtwin

  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