create_public_preview
Create free 2ools preview
Turn a complete standalone HTML document already created in this chat into a temporary, read-only 2ools preview. Free and authless; expires after 24 hours. This tool does not generate the page—write the HTML first, then call it.
輸入參數html必填name必填idempotency_key必填
list_build_systems
List my custom build systems
List creative systems created by the authenticated account and compatible with an optional output target. Built-in 2ools skills, routing, prompts, and operating systems are private and are not returned.
輸入參數output_target
list_connected_engines
List connected computers
List privacy-minimized connected 2ools Engines for exact native dispatch. Returns opaque Engine identity, a redacted machine label, online state, authenticated provider CLIs, supported protocols, privacy-safe workspace handles, and the last observed timestamp. Never returns tokens, paths, repository URLs, SSH hosts, secrets, or raw device labels.
無需輸入參數。
get_project_engine_workspace
Get project source workspace
Read the privacy-safe Engine workspace attached to one project. Returns only opaque Engine/workspace identity, safe display metadata, live readiness, and a revision. Never returns source, paths, repository URLs, SSH hosts, tokens, or secrets.
輸入參數project_id必填
attach_project_engine_workspace
Attach project source workspace
Owner-authorized attachment of one saved project to one exact opaque workspace on one exact online 2ools Engine. This grants future project work access to real source on that computer, so show the selected computer/workspace and obtain explicit confirmation. It changes no source file and never falls back to another Engine.
輸入參數confirm必填engine_id必填project_id必填workspace_id必填expected_revision必填
register_existing_project
Register an existing project
Create one durable Project OS record for a local or external project that list_projects did not match. When the canonical project ID is already known, pass existing_project_id and that exact record is reused. Otherwise an exact normalized name match is reused instead of duplicated, even with a new idempotency key. Call only after the person approves the proposed name, goal, current state, decisions, and next step. This never reads or uploads local files and never starts a build.
輸入參數goal必填approval必填decisionsnext_step必填project_name必填current_state必填output_targetidempotency_key必填existing_project_id
build_from_conversation
Build conversation in 2ools
Create a new 2ools project from a structured conversation brief and queue one durable build. Returns project_id and job_id; use get_build to retrieve completion status and the protected preview.
輸入參數modelpagesentityaudienceheadlineproject_name必填requirementsoutput_targetmax_iterationsidempotency_key必填visual_directioncreative_system_id另有 4 個
start_project_on_engine
Start project on selected computer
Create one new 2ools project and queue its first build on one exact connected Engine and provider selected by the person. Fails before project creation or queueing when that Engine is offline, busy, missing the provider, or lacks the protocol. Never falls back to hosted, server, Studio, or another computer.
輸入參數pagesentityaudienceheadlineprotocol必填provider必填engine_id必填project_name必填requirementsoutput_targetmax_iterationsidempotency_key必填另有 6 個
refine_project
Refine a 2ools project
Create one protected child version from a saved base version and concrete review feedback. Preserves the base source as currentCode, consumes one persisted project iteration, and returns an asynchronous job_id.
輸入參數modelfeedback必填project_id必填base_version_id必填idempotency_key必填
Get one build's current status, progress, errors, completed version IDs, and protected preview URLs. Does not return generated source code.
輸入參數job_id必填
get_engine_dispatch
Get Engine dispatch
Read the authoritative state of one exact Engine dispatch. Queued means accepted but not started; running appears only after the selected Engine atomically claims the lease. Returns claim, heartbeat, failure, and terminal state without client inference.
輸入參數job_id必填
compare_versions
Compare 2ools versions
Compare two saved versions in one project without returning source. Reports lineage, review state, page additions/removals, byte sizes, and SHA-256 identity for each page.
輸入參數project_id必填left_version_id必填right_version_id必填
list_approval_requests
List 2ools approval requests
List exact saved versions waiting for a separately delegated reviewer. Returns project/version identity and attribution, never generated source.
輸入參數limitstatus
approve_version
Approve a 2ools version
Use separately delegated review authority to approve one saved version and make it the project's active version. Does not publish, export, or change project permissions.
輸入參數project_id必填version_id必填confirmation必填decision_note
reject_version
Reject a 2ools version
Use separately delegated review authority to reject one saved version. If it is active, restores its saved parent as active; the rejected version remains in immutable history.
輸入參數project_id必填version_id必填confirmation必填decision_note必填
cancel_build
Cancel 2ools build
Cancel one exact queued or running non-Agent 2ools build after named explicit confirmation. Repeating the same cancellation is safe, late Engine results are rejected, completed versions are never deleted, and immutable history remains. Governed Agent execution uses cancel_agent_run.
輸入參數job_id必填reason必填confirm必填
get_account_profile
Get 2ools account profile
Read the authenticated person's 2ools profile, current account labels, and server-derived effective MCP scopes. Passwords, private credentials, billing instruments, and provider secrets are never returned.
無需輸入參數。
update_account_profile
Update 2ools account profile
Update only the explicitly supplied profile fields for the authenticated person. This cannot change email, password, MFA, billing, entitlements, roles, or account-deletion state.
輸入參數biolocalewebsitetimezoneusernamejob_titledisplay_namedefault_locationprofile_use_casespreferred_audience
get_project_access
Get project access
Read the authenticated person's role plus the canonical project owner, members, and pending invitations. Non-managers can read active members but never receive pending-invite metadata.
輸入參數project_id必填
invite_project_member
Invite project member
Invite an existing 2ools username or an email address to one owned project as a collaborator or viewer. New-account claim tokens are emailed by 2ools and are never returned through MCP.
輸入參數roleidentity必填project_id必填version_id
update_project_member_role
Change project member access
Change one exact member to collaborator or viewer, or transfer ownership. Requires explicit confirmation because demotion cancels that member's active builds and pauses armed project agents, while ownership transfer changes the current owner's authority.
輸入參數role必填confirm必填member_id必填project_id必填
remove_project_member
Remove project member
Remove one exact member's project access after explicit confirmation. Their account and authored history stay; active project builds are canceled and armed project agents are paused.
輸入參數confirm必填member_id必填project_id必填
revoke_project_invite
Revoke project invitation
Revoke one exact pending project invitation after explicit confirmation. The person can no longer accept that invitation; project history remains auditable.
輸入參數confirm必填invite_id必填
list_projects
List 2ools projects
Open the native Project OS entry point and list recent 2ools projects the authenticated account can access. The app automatically continues the only saved project or shows an inline chooser when several projects are available. Returns compact metadata without generated source.
輸入參數limit
get_project
Get 2ools project
Get a 2ools project's brief, selected pages, active version, and compact version history. Does not return generated source code.
輸入參數project_id必填
get_project_context
Get 2ools project operating context
Read one source-free operating packet: active version metadata, the latest explicitly selected observed project input, review attention, artifact index, work queue, and current activity cursor. Imported input is immutable evidence, not an AI proposal or live filesystem sync; private 2ools skills, prompts, routing, governance text, and generated version source are not returned.
輸入參數project_id必填include_governance_textinclude_project_input_files
continue_project
2ools · Continue Project OS
Return one project's current Living Plan, next useful move, continuity-readiness gaps, latest evidence, and a compact 2ools-active receipt. Opens a compact status, Continue, and Open Project OS card on MCP Apps hosts; the full Project OS belongs in the host's browser side panel.
輸入參數project_id必填response_format
refresh_project_cockpit
Refresh the open 2ools Project Cockpit
Refresh the bounded project state shown inside an already-open 2ools MCP App. This app-only read does not start work, import files, or change the project.
輸入參數project_id必填
activate_project
Use 2ools for this project
Record the person's one-time choice to use this already-connected 2ools client with one exact saved project. Call only after the person approves in the inline card or explicitly in chat. This does not read or import local files and does not start work or a build.
輸入參數approval必填project_id必填
get_project_mission
Read a project's Mission and Goal Stack
Return a bounded canonical Project Mission view, active Goal Contract, server-derived health, role capabilities, or a paginated goals, templates, scope-change, or history slice.
輸入參數viewlimitcursorproject_id必填
get_project_intelligence
Read a project's Product Intelligence
Return the versioned frontier-product research dossier, six parallel lane states, evidence ledger, saturation audits, falsification, concepts, ranked outputs, integrity summary, connector visibility, and a deterministic operating brief. Missing premium access is reported as a gap, never invented.
輸入參數project_id必填
update_project_intelligence
Preserve frontier Product Intelligence
Initialize or append one immutable, validated dossier revision. The complete snapshot must cite material claims, preserve unknowns, finish or explicitly block all six lanes before synthesis, include a reproducible saturation audit, and pass falsification/output gates. Revision conflicts require a reread; no source retrieval is fabricated by this tool.
輸入參數change必填project_id必填
get_project_discipline
Read Project Discipline
Return derived direction, trade-off, evidence, and continuity status with active decisions, eval evidence, verifier definitions, and explicit permission boundaries. Status is computed from authoritative Project OS records, never editable checkboxes.
輸入參數project_id必填
list_project_engineering_decisions
List project engineering decisions
List native-safe engineering decisions for one exact project, including the canonical project revision, category, risk, question, rationale, tradeoffs, response contract, constraints, and current state. Never returns secrets or internal prompts; unknown future response kinds remain in Project OS.
輸入參數limitstateproject_id必填
answer_project_engineering_decision
Answer a project engineering decision
Accept or reject one exact native-safe engineering decision at one exact project revision. Requires an explicit confirmation and durable note, enforces project role and high-risk owner policy, rejects revision conflicts, preserves immutable history, and returns an idempotent receipt plus canonical reread. Unknown future response kinds remain in Project OS.
輸入參數note必填answer必填confirm必填project_id必填risk_leveldecision_id必填supersedes_ididempotency_key必填expected_revision必填
manage_project_discipline
Record Project Discipline evidence
Propose a project trade-off, version an eval case or verifier definition, or attach an eval/verifier receipt to exact work. Agents may propose decisions but cannot accept their own proposals; verifier definitions describe external evidence and never execute arbitrary code on 2ools.
輸入參數change必填project_id必填
update_project_mission
Author a Project Mission or Goal Stack change
Create or revise Mission and Goal contracts, explicitly transition or reorder goals, or propose a scope change. Server role, revision, conflict, and safety policy remain authoritative.
輸入參數change必填project_id必填
review_project_mission
Review or restore Project Mission evidence
Restore an immutable Mission or Goal revision, decide a proposed scope change, or submit proof-based goal completion review. Completion and high-risk authority remain server-gated.
輸入參數change必填project_id必填
manage_work_watchdog
Manage Project OS Watchdog coordination
Pause, park, resume, or reprioritize one durable task, or deliberately configure the project Watchdog. This never answers for the user, approves a risky action, deploys, spends, sends externally, deletes data, or widens authority.
輸入參數change必填project_id必填
act_on_project_os_task
Act on a Project OS task
App-only route for an authenticated person's explicit click in the native Project OS panel. Hidden from the model; every action is revision checked and idempotent, and cancellation requires an explicit confirmation.
輸入參數change必填project_id必填
update_living_plan
Update a project's Living Plan
Add, edit, move, or reorder open Living Plan items from the current conversation, then return the refreshed inline plan and timeline panel. This cannot mark returned work complete; completion remains a separate evidence-backed review decision.
輸入參數change必填project_id必填
render_project_preview
Show 2ools project preview
Render an interactive, read-only card for one saved 2ools version. Use after get_build or get_project when the user wants to see, open, or share the result. Returns protected preview and access-checked workspace links without source code.
輸入參數project_id必填version_id必填
list_project_agents
List project Agents
List the authorizing account's built-in Agents assigned to one readable project. This reveals status and summary, not full Limits or run traces.
輸入參數project_id必填
get_agent
Inspect a governed 2ools Agent
Read one Agent's saved Limits, trigger, immutable revision summaries, and redacted append-only run traces. Raw prompts, tool arguments, credentials, and source bytes are not returned.
輸入參數agent_id必填run_limit
run_project_agent
Run an armed project Agent
Queue real execution for a project-linked Agent the person already test-ran and armed. The immutable saved Limits, project access, account fuse, and online Engine requirement are enforced server-side before a job exists.
輸入參數task必填model必填agent_id必填project_id必填idempotency_key必填
get_project_agent_mode
Get project Agent Mode
Read the project-level autonomous coordination state derived from the canonical Living Plan, governed Agent, and exact Engine destination. Returns progress, current work, next eligible safe step, and the reason the project is running or needs the person.
輸入參數project_id必填
configure_project_agent_mode
Configure project Agent Mode
Turn the selected project's governed Agent Mode on or off. When enabled, the person chooses one armed project Agent, one exact Engine, and one provider; only reviewed safe-auto steps in the exact approved plan may advance in dependency order. Limits and approval boundaries are never widened.
輸入參數confirm必填enabled必填agent_idproviderengine_idproject_id必填idempotency_key必填expected_revision必填include_approved_plan
advance_project_agent_mode
Advance project Agent Mode
Idempotently re-evaluate and, when safe, queue the next dependency-ready safe-auto plan step on the project's already approved Agent, Engine, and provider. Running, review, blocked, and approval states never double-dispatch.
輸入參數project_id必填
dispatch_project_work
Run Project OS task on selected computer
Reserve one exact revision-checked Project OS task for one armed project Agent, then queue it on one exact online Engine and authenticated provider selected by the person. Queued is not working; the task becomes active only after that Engine atomically claims it. Never falls back to another computer, provider, hosted compute, or a parallel task.
輸入參數noteconfirm必填agent_id必填protocol必填provider必填engine_id必填project_id必填assignment_id必填idempotency_key必填expected_revision必填
get_project_work_dispatch
Get Project OS task dispatch
Read the authoritative queued, claimed, running, approval-paused, or terminal state of one exact governed Project OS task dispatch. Returns bounded progress and lease evidence without prompts, credentials, source, paths, or private model transcripts.
輸入參數job_idassignment_ididempotency_key
cancel_agent_run
Cancel governed Agent run
Stop one queued or running Agent execution and close its durable run history. Completed, failed, stalled, and already-canceled runs keep their terminal truth.
輸入參數job_id必填run_id必填confirm必填agent_id必填project_id必填
get_project_activity
Get 2ools project activity
Read the attributable project timeline across human work, external MCP agents, builds, versions, feedback, and workspace pins. Actor kind is explicit; an external agent is never presented as the human account that authorized it.
輸入參數limitcursorproject_id必填
wait_for_project_activity
Wait for new 2ools project activity
Wait up to 20 seconds for attributable project events newer than a head_cursor or prior next_cursor. Returns events oldest-first so an outside agent can process them in order. If resync_required is true, paginate get_project_activity instead of advancing the cursor.
輸入參數limitproject_id必填after_cursor必填timeout_seconds
list_project_feedback
List project feedback
Read page-anchored review feedback for versions in a project, with explicit human or external-agent attribution.
輸入參數project_id必填include_resolved
add_project_feedback
Add project feedback
Add an attributable review comment to a saved project version. This does not modify source or approve the version.
輸入參數xypagelabelcomment必填project_id必填version_id必填idempotency_key必填reply_to_feedback_id
resolve_project_feedback
Resolve project feedback
Owner-only review decision that resolves or reopens one saved feedback item.
輸入參數resolvedproject_id必填feedback_id必填
list_project_pins
List workspace pins
Read shared workspace notes and http(s) links, with explicit attribution.
輸入參數project_id必填
add_project_pin
Add workspace pin
Add an attributable note or safe http(s) link to the shared project workspace.
輸入參數xyurlkind必填labelsurfaceproject_id必填version_ididempotency_key必填
remove_project_pin
Remove workspace pin
Remove one shared workspace pin. The operation is idempotent.
輸入參數pin_id必填project_id必填
prepare_version_export
Prepare portable version export
Create a five-minute download URL for an exact saved version. Source is delivered by the download route, never embedded in MCP model output.
輸入參數project_id必填version_id必填
get_version_share_link
Get exact version share link
Read the durable sharing state and current URL for one exact saved version. Disabled shares return no URL.
輸入參數pageproject_id必填version_id必填
create_version_share_link
Create exact version share link
Create or recover a durable public or code-protected link for one exact saved version. Reusing the idempotency key returns the original result.
輸入參數pageaccess必填project_id必填version_id必填idempotency_key必填
revoke_version_share_link
Revoke exact version share link
Disable every existing public or code-protected URL for one exact saved version. Re-publishing a protected link rotates its code.
輸入參數project_id必填version_id必填idempotency_key必填
list_artifacts
List project artifacts
List durable project artifacts and each latest immutable version without returning stored bytes.
輸入參數project_id必填
get_artifact
Get artifact history
Read one artifact's immutable version history, provenance, attribution, digests, and review states without returning stored bytes.
輸入參數project_id必填artifact_id必填
prepare_artifact_upload
Prepare reviewed artifact upload
Create a five-minute PUT URL for exact bytes. External-agent output always enters pending review and never replaces the current artifact version before approval.
輸入參數kind必填name必填sha256必填filename必填byte_size必填media_type必填project_id必填artifact_idreview_noteparent_version_id
prepare_artifact_download
Prepare exact artifact download
Create a five-minute download URL for one immutable artifact version. Stored bytes never enter MCP model output.
輸入參數project_id必填artifact_id必填artifact_version_id必填
list_artifact_approval_requests
List artifact review requests
List exact artifact versions awaiting or carrying a human review decision. Requires separately delegated artifact review authority.
輸入參數statusproject_id
approve_artifact_version
Approve exact artifact version
Approve one pending immutable artifact version and make it current. Repeating the same decision is idempotent.
輸入參數noterequest_id必填
reject_artifact_version
Request artifact changes
Reject one pending immutable artifact version with useful feedback. Repeating the same decision is idempotent.
輸入參數note必填request_id必填
get_task_quality_gate
Read a task Quality Gate
Return the current task-bound Quality Gate policy, freshness, deterministic check receipt, and attached findings. A pass never replaces required human visual or approval review.
輸入參數assignment_id必填
run_task_quality_gate
Run or settle a task Quality Gate
Start checks against exact task/artifact/environment fingerprints, or submit every configured check with same-project evidence and explicit findings. Missing routes, stale proof, failed checks, and open findings cannot become a false pass.
輸入參數change必填
get_work_handoff
Read task context handoff
Return the current immutable context-handoff receipt, exact task lineage, and honestly labeled worker-reported or 2ools-forecast context signal.
輸入參數assignment_id必填
prepare_work_handoff
Prepare a bounded task handoff
Checkpoint one owned session into an immutable, exactly-once successor envelope. Estimated signals are labeled as estimates; questions and possibly committed effects stay paused for a person.
輸入參數reasonsession_id必填signal_kindsignal_labelidempotency_key必填request_handoffremaining_context_tokens
list_work_assignments
List project work assignments
List durable project work contracts, bounded attempts, leases, budgets, and result references.
輸入參數statusproject_id必填
create_work_assignment
Create bounded project work
Create a durable assignment with acceptance criteria and hard step, time, and spend ceilings.
輸入參數brief必填title必填due_atgoal_idprioritymax_stepsmax_tokensproject_id必填max_minutesdependency_idsidempotency_key必填max_spend_cents另有 5 個
claim_work_assignment
Claim bounded project work
Atomically claim one open assignment and receive a five-minute renewable lease plus an immutable budget snapshot.
輸入參數input_refsassignment_id必填idempotency_key必填
heartbeat_work_session
Renew a work-session lease
Renew the authenticated worker's active lease without widening its immutable step, time, or spend ceilings.
輸入參數checkpointsession_id必填used_stepsmodel_callseffect_stateinput_tokensoutput_tokenshandoff_reasonrequest_handoffused_spend_centscached_input_tokenscontext_signal_kind另有 3 個
checkpoint_work_session
Checkpoint bounded project work
End the current lease with a compact continuation checkpoint, or place work in an explicit waiting or blocked state. Ambiguous external effects always wait for reconciliation and are never auto-retried.
輸入參數reasoncheckpoint必填session_id必填used_stepsdispositionmodel_callswaiting_foreffect_stateinput_tokensoutput_tokensidempotency_key必填used_spend_cents另有 1 個
submit_work_session
Submit work for review
End the authenticated worker's lease and submit typed result references for a separate review decision.
輸入參數session_id必填used_stepsmodel_callsoutput_refsinput_tokensoutput_tokensresult_summary必填idempotency_key必填used_spend_centscached_input_tokens
decide_work_assignment
Review submitted project work
Complete submitted work or reopen it with useful feedback. Requires separately delegated work-review authority.
輸入參數notedecision必填assignment_id必填idempotency_key必填