fieldtwin
Local twins of the Jobber, Housecall Pro and QuickBooks APIs for testing agents
- 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 fieldtwinAdd to claude_desktop_config.json
{
"mcpServers": {
"fieldtwin": {
"command": "npx",
"args": [
"-y",
"fieldtwin"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"fieldtwin": {
"command": "npx",
"args": [
"-y",
"fieldtwin"
]
}
}
}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

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Ouroboros
MCP serverSpec-first layer that pins requirements and verifies results of AI coding agent work
Runs locally- Open source
- 6.4K GitHub stars
- Developer tools