Service twin · API + UI
Dropbox
Test file agents that organize content, manage sharing, and retrieve documents across team folders.
API + UIcaptured contractREST · MCP · CLI
Terminal
$ uv tool install blobfish-cli
$ blobfish twin login
$ blobfish twin-runs create --twins dropbox --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--dropbox rekeyed onto seeded state.
Seeded entities
| Entity | Table | Fields | About |
|---|---|---|---|
| dropbox_about_me | dropbox_about_mes | 2 | Inferred from MCP tool parameters; the tool contract remains the authority. |
| dropbox_file | dropbox_files | 8 | Inferred from MCP tool parameters; the tool contract remains the authority. |
| dropbox_file_or_folder | dropbox_file_or_folders | 5 | Inferred from MCP tool parameters; the tool contract remains the authority. |
| dropbox_file_request | dropbox_file_requests | 6 | Inferred from MCP tool parameters; the tool contract remains the authority. |
| dropbox_files_in_folder | dropbox_files_in_folders | 8 | Inferred from MCP tool parameters; the tool contract remains the authority. |
| dropbox_folder | dropbox_folders | 7 | Inferred from MCP tool parameters; the tool contract remains the authority. |
| dropbox_move_file_or_folder | dropbox_move_file_or_folders | 7 | Inferred from MCP tool parameters; the tool contract remains the authority. |
| dropbox_paper | dropbox_papers | 5 | Inferred from MCP tool parameters; the tool contract remains the authority. |
| dropbox_temporary_link | dropbox_temporary_links | 3 | Inferred from MCP tool parameters; the tool contract remains the authority. |
Three surfaces, one state
Mount Dropbox 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":["dropbox"],"ttl_minutes":60}'Known limitations
This twin mirrors the captured contract sm--dropbox: 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.