Developer Tools
openfactory.tech
Manage OpenFactory builds, including creating, listing, and deploying bootable Linux ISOs.
ENDPOINT 1
https://console.openfactory.tech/mcp-stream/mcp
MCP server metadata
- Name
- OpenFactory
- Version
- 2.14.4
OpenFactory is an AI-powered Linux OS image builder. Use these tools to: - List and manage builds - Create new builds from recipes - Browse pre-built recipe templates - Run tests on built images - Manage VMs for testing - Interact with desktop VM GUIs (click, type, scroll, screenshot, close browser tabs) via the `desktop_*` tool family (`desktop_screenshot`, `desktop_click`, `desktop_type`, `desktop_key`, `desktop_close_tab`, `desktop_open_url`, `desktop_interact`) CRITICAL — session_token: Every tool response includes a "session_token" field. You MUST pass this value as the "session_token" argument in ALL subsequent tool calls. Without it, the server cannot identify your session and tool calls will fail with "Build not found" or similar errors. Extract session_token from the first tool response and include it in every following call. When creating builds, use the recipe tools to browse available templates or create custom recipes based on user requirements.
Known tools 150
list_buildsList your OpenFactory builds.
get_buildGet full details of a specific build including its recipe.
get_build_statusGet the current status of a build.
create_buildCreate a new build from a recipe.
deploy_from_gitBuild a bootable Linux ISO from a git repo.
get_iso_download_urlGet the download URL for a completed build's ISO.
retry_buildRetry a failed build.
update_build_recipeReplace a build's canonical recipe and graph.
list_recipesList available pre-built recipes.
list_recipe_categoriesList all available recipe categories.
get_recipeGet full details of a specific recipe.
validate_recipeValidate a recipe without creating a build.
create_recipe_from_templateCreate a new recipe based on an existing template.
create_test_suiteCreate a reusable project test suite without requiring a built variant.
list_test_suitesList reusable test suites accessible to the current MCP user.
get_test_suiteView one reusable test suite and optionally its recent status history.
update_test_suite_targetsBind or update a suite's named ISO slots using completed OpenFactory builds.
run_test_suiteRun a reusable test suite against bound ISO target slots.
list_test_suite_runsList test runs created from a reusable test suite.
get_test_suite_statusGet a suite's authoring readiness and latest run status.
run_testsRun tests on a built ISO.
get_test_resultsGet the results of a test run.
list_test_runsList test runs for your builds.
stop_test_runStop a running test run.
list_vmsList your running VMs.
create_vmCreate a VM from a built ISO.
start_vmStart a stopped VM.
stop_vmStop a running VM.
delete_vmDelete a VM.
get_vm_console_urlGet the VNC console URL for a VM.
guest_commandRun commands and manage files on a VM via the QEMU guest agent.
send_smsSend an SMS text message to a phone number.
call_phonePlace a real-time AI voice phone call.
check_messagesCheck incoming SMS messages and recent call logs for your workspace.
desktop_screenshotTake a screenshot of your desktop and see what's on screen.
annotate_screenshotCapture the desktop and draw labeled highlight boxes on it, then return the annotated screenshot URL.
desktop_clickClick at coordinates on your desktop, then return screenshot + elements.
desktop_dragDrag-and-drop on your desktop: press at (x, y), move to (end_x, end_y), release.
desktop_typeType text on your desktop, then return screenshot + elements.
desktop_keyPress a key or key combination on your desktop, then return screenshot + elements.
desktop_close_tabClose the currently active browser tab, then return screenshot + elements.
desktop_open_urlOpen a URL in Brave on your desktop (falls back to Firefox or Chromium if Brave isn't installed on the VM).
desktop_interactExecute a sequence of actions on your desktop, then return screenshot + elements.
desktop_read_regionRun a real vision-language OCR model on a region of your desktop and return all text.
desktop_listenListen to audio from a desktop VM and get transcriptions.
desktop_speakSpeak text aloud on a desktop VM using text-to-speech.
authenticate_testerLog your tester browser into a login-walled OpenFactory platform site so you can reproduce and VERIFY authenticated UI.
enumerate_dom_linksList every clickable / interactive element on the active page via DevTools.
get_browser_diagnosticsCapture browser diagnostics — console errors, failed requests, page health.
ensure_tester_vmGet-or-create your persistent desktop tester VM for an app (idempotent).
scale_tester_poolSet how many tester VMs an app keeps (explicit performance opt-in).
start_app_testStart recording an app test run (one scenario execution).
record_app_test_stepRecord one step of the running app test, with server-side screenshot.
finish_app_testFinalize an app test run with its verdict.
list_app_test_runsList app test runs (newest first), or the per-scenario verdict rollup.
get_app_test_runGet one app test run, including per-step verdicts and screenshot refs.
set_app_test_report_visibilityToggle whether a standalone app test report is publicly viewable.
read_email_otpRead a 2FA / one-time code from a Composio-connected Gmail.
create_app_scenarioCreate a reusable GUI test scenario stored on OpenFactory.
list_app_scenariosList your saved GUI test scenarios.
get_app_scenarioGet a scenario's full definition, hardened cache, and last run.
delete_app_scenarioDelete a saved app test scenario (its definition + hardened element cache).
assign_app_scenarioAssign a scenario to a project (and optionally an existing variant), or remove it.
run_app_scenarioRun a saved scenario in a VM and record the result as an app test run.
run_app_test_groupRe-run a whole group of saved app-test scenarios in the background.
get_app_test_groupLive status of a group re-run: per-scenario status, which VM each ran on, and pass/fail counts.
cancel_app_test_groupCancel a running group re-run.
walk_appAutonomously walk a web dashboard and record what's there + what breaks.
get_app_walkGet the full walk record: status, totals, states, transitions, findings.
list_app_walksList walks visible to the caller (own walks; admins see all).
stop_app_walkRequest cooperative cancellation.
get_pending_checkpointLong-poll for the oldest pending harness checkpoint visible to the caller.
submit_scenario_checkpointSubmit a verdict for a paused checkpoint.
get_checkpointFetch a single checkpoint (pending or resolved) by id.
add_app_databaseProvision a managed Postgres database for an app + publish ``DATABASE_URL`` into the app's env automatically.
list_app_databasesList databases provisioned for an app (metadata only — no passwords).
add_app_bucketProvision a managed MinIO bucket for an app + publish AWS_* credentials into the app's env automatically.
list_app_bucketsList buckets provisioned for an app (metadata only — no secret_keys).
enable_app_authProvision per-app OIDC auth + auto-publish ``OF_AUTH_*`` into env.
get_app_auth_statusReturn the current auth binding for the app.
rotate_app_auth_secretGenerate a new client_secret + republish via producer API.
disable_app_authDisable per-app auth.
create_checkpointCapture a manual checkpoint (code SHA + VM snapshot + DB snapshot) for the app.
list_checkpointsList checkpoints for an app (newest first) + per-app storage usage.
rollback_appBi-directional rollback.
pin_checkpointPin a checkpoint so the retention reconciler never deletes it.
delete_checkpointRemove a checkpoint.
enable_app_ideEnable code-server (Web IDE) for the app.
disable_app_ideStop code-server + remove the ide-<slug> gateway route.
get_app_ide_statusCurrent IDE binding for the app: enabled flag, URL, status, timestamps.
list_app_templatesBrowse the app-templates gallery.
get_app_templateFull manifest for one template: source git URL, runtime defaults, env-variable spec, declared services, rendered README.
instantiate_app_templateCreate a new app from the template.
remix_appFork a public+remixable app (or your own app regardless of flags).
set_app_remixableToggle the remixable flag on your own app.
set_walk_baselinePin a walk as the current baseline for an app.
get_walk_baselineGet the current baseline walk for an app (your own pin).
list_walk_baselinesList every baseline pin you have across all your apps.
clear_walk_baselineClear the baseline pin for an app.
diff_walksCompute a diff between two walks.
walk_recursive_reportRecursive BFS-tree view of a walk's UI state graph.
walk_findings_to_ticketsSerialize a walk's findings into ticket payloads ready to POST to Linear / Jira / GitHub.
run_all_app_scenariosKick off a batch run of every saved scenario for this app.
walk_siteAutonomously walk a website and bring back a structured map of it.
get_walk_summaryToken-bounded digest of a walked website: status + coverage, the site state tree (routes, titles, inbound actions, per-node finding counts), a findings digest (top by severity), a capability inventory (forms, inputs, internal/external links), a console/HTTP error rollup, the structural ``tree_hash``, and active-baseline status.
seal_walk_baselineSeal a completed walk into an IMMUTABLE golden state tree and pin it as the active baseline for (you, app_name).
check_walk_regressionThe agentic UX-regression gate.
propose_fixCreate a FixIntent for a walker Finding.
apply_fixApply a patch to a deployed app and restart its systemd unit.
get_fix_intentRead one FixIntent (status, target_file, suggested_patch, apply_result).
list_fix_intentsList your FixIntents, newest first.
close_findingMark a finding as resolved (fixed/wont_fix/duplicate/not_a_bug).
run_fix_cyclePropose a fix cycle: create FixIntents for every blocker/major finding (or NEW since baseline if supplied), up to max_findings.
prepare_build_inputsRun deterministic build preparation before the privileged image build.
validate_configValidate the current prepared worktree config without building.
regenerate_configRe-run deterministic config generation for the current recipe/worktree.
classify_failureClassify the next repair surface for a failed build or test run.
regenerate_source_projectRegenerate and force-push one generated source-project git repo.
rebuild_source_projectRefresh OBS for one generated source project and wait for packages.
refresh_source_project_packagesRewrite live-build archive/package lists from resolved OBS source projects.
build_imageBuild the OS image by running ./build.sh via the privileged build daemon.
report_build_stageReport a build stage transition so the dashboard ribbon + SSE advance.
emit_build_outputStream a line of output into the build log (visible on the dashboard).
lookup_failure_patternsMatch build output against the curated failure-pattern table.
record_build_outcomeRecord a build outcome into the build-knowledge base.
prepare_harness_buildCreate a build + prepared worktree WITHOUT queueing the autonomous pipeline.
finalize_buildFinalize a successful build: artifacts, tests, verification, record.
platform_fix_startStart a host-side platform-website fix: an ad-hoc git branch/worktree plus a host Claude Code session that implements + commits the change (never pushes).
get_platform_fixRead a platform fix record: status (running | implemented | staging | staged | landing | landed | failed | stage_failed | land_failed), commit, changed files, staging/prod URLs, error details.
stage_platform_fixStage an implemented fix onto the local dev servers (the tester VM can reach the returned staging_url).
land_platform_fixLand a staged fix to production: verifies the green-scenario gate, then pushes via the blessed pipeline (monorepo: ai-sync-now; openfactory.tech: fast-forward main + push).
create_appRegister an app (a git repo to deploy) on OpenFactory.
list_appsList your registered apps.
get_appGet one app's full record (source, slug, status, deploy history).
deploy_appBuild a fresh app-baked OpenFactory variant and deploy it blue-green.
get_app_deploy_statusPoll an immutable app variant through build, boot, health, and cutover.
create_app_from_promptTurn a one-sentence brief into a queued immutable app deployment.
iterate_appDispatch a natural-language change to an app and have it applied for you.
get_app_build_statusReturn the build/deploy status for an app plus live iteration-thread state — origin (brief + iterations), current URL, deploy history count, env version drift signal, and each in-flight change's status (queued/working/ done/failed) with the agent's result evidence.
list_app_envList the app's env vars (masked — values returned as ``********``).
set_app_envUpsert and/or delete env vars on an app in a single transaction.
reveal_app_envDecrypt and return a single app env var's plaintext value.
list_account_envList account-level env vars (shared defaults across all your apps).
set_account_envUpsert/delete account-level env vars in a single transaction.
reveal_account_envDecrypt and return a single account env var.
desktop_start_recordingStart recording a VM's screen to a video file.
desktop_stop_recordingStop a recording and finalize the video.
get_recordingGet a recording's status + metadata (status, duration_ms, size_bytes, video_url).
list_recordingsList recordings for a VM, newest first.
test_workflowAutonomously TEST a GUI workflow and report whether it works.