Service twin · API + UI
QuickBooks
Test finance agents that manage customers, invoices, bills, payments, purchases, and accounting records.
API + UIcaptured contractREST · MCP · CLI
Terminal
$ uv tool install blobfish-cli
$ blobfish twin login
$ blobfish twin-runs create --twins quickbooks --ttl 60 --waitWhat’s inside
A deterministic, seeded, resettable replica: every operation below executes real state transitions against the twin’s own SQLite state — reads are hash-invariant, writes produce inspectable diffs, and reset restores the seed baseline. This twin runs the captured contract sm--quickbooks rekeyed onto seeded state.
Seeded entities
| Entity | Table | Fields | About |
|---|---|---|---|
| quickbooks_account | quickbooks_accounts | 8 | Inferred from MCP tool parameters; the tool contract remains the authority. |
| quickbooks_customer | quickbooks_customers | 9 | Inferred from MCP tool parameters; the tool contract remains the authority. |
| quickbooks_customer_balance_detail | quickbooks_customer_balance_details | 15 | Inferred from MCP tool parameters; the tool contract remains the authority. |
| quickbooks_customer_balance_report | quickbooks_customer_balance_reports | 10 | Inferred from MCP tool parameters; the tool contract remains the authority. |
| quickbooks_employee | quickbooks_employees | 6 | Inferred from MCP tool parameters; the tool contract remains the authority. |
| quickbooks_full_invoice | quickbooks_full_invoices | 5 | Inferred from MCP tool parameters; the tool contract remains the authority. |
| quickbooks_invoice | quickbooks_invoices | 9 | Inferred from MCP tool parameters; the tool contract remains the authority. |
| quickbooks_sparse_invoice | quickbooks_sparse_invoices | 3 | Inferred from MCP tool parameters; the tool contract remains the authority. |
| quickbooks_vendor | quickbooks_vendors | 9 | Inferred from MCP tool parameters; the tool contract remains the authority. |
| quickbooks_vendor_balance_detail | quickbooks_vendor_balance_details | 14 | Inferred from MCP tool parameters; the tool contract remains the authority. |
| quickbooks_vendor_balance_report | quickbooks_vendor_balance_reports | 11 | Inferred from MCP tool parameters; the tool contract remains the authority. |
Three surfaces, one state
Mount QuickBooks in a twin environment and the same seeded state serves vendor-shaped REST operations, an MCP endpoint for tool calling, and a generated bf-twin CLI — with copy-on-write sessions per rollout and a one-call reset to the seed baseline. Prefer raw HTTP? The same create works with curl:
API
$ curl -sS -X POST https://blobfish.ai/api/v1/twin/environments \
-H "X-API-Key: $BLOBFISH_API_KEY" -H "Content-Type: application/json" \
-d '{"services":["quickbooks"],"ttl_minutes":60}'Known limitations
This twin mirrors the captured contract sm--quickbooks: its tool surface is the captured server’s, with synthetic seeded values. Operations outside that capture are not mounted — we mount fewer, executable operations rather than stub the rest.