create_public_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.

Parameters3

name	string	required	Short public preview name.
html	string	required	Complete standalone HTML document beginning with <!doctype html> or <html>, including its CSS and JavaScript.
idempotency_key	string	required	Caller-generated retry key. Reuse returns the same preview instead of storing a duplicate.

Raw schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 120,
      "description": "Short public preview name."
    },
    "html": {
      "type": "string",
      "minLength": 80,
      "maxLength": 200000,
      "description": "Complete standalone HTML document beginning with <!doctype html> or <html>, including its CSS and JavaScript."
    },
    "idempotency_key": {
      "type": "string",
      "minLength": 8,
      "maxLength": 120,
      "pattern": "^[A-Za-z0-9._:-]+$",
      "description": "Caller-generated retry key. Reuse returns the same preview instead of storing a duplicate."
    }
  },
  "required": [
    "name",
    "html",
    "idempotency_key"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

list_build_systems

List the Curators, Rulebooks, and Skills this paid account may explicitly apply. Use before build_from_conversation when the user names a creative system or asks what is available.

Parameters1

output_target

string

optional

Optional target filter. Omit to list every compatible system available to the account.

Raw schema

{
  "type": "object",
  "properties": {
    "output_target": {
      "description": "Optional target filter. Omit to list every compatible system available to the account.",
      "type": "string",
      "enum": [
        "web",
        "game",
        "tauri",
        "electron",
        "widget",
        "float",
        "freeform"
      ]
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

build_from_conversation

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.

Parameters16

project_name	string	required	Short name for the new 2ools project.
conversation_summary	string	required	Factual build brief distilled from the conversation, including the intended artifact and key decisions.
headline	string	optional	Exact hero headline to preserve verbatim in the generated site.
entity	object	optional	Grounded identity facts that must survive the build.
audience	string	optional	Primary audience and the job they need to complete.
requirements	array	optional	Concrete functionality, content, and section requirements.
pages	array	optional	Pages to generate. Use Home for a one-page site or widget.
visual_direction	string	optional	Desired visual character, composition, color, typography, or references.
content_constraints	array	optional	Claims, wording, exclusions, or fidelity constraints the build must obey.
curator_id	string	optional	Exact Curator ID from list_build_systems. Omit for automatic selection.
rulebook_id	string	optional	Exact compatible Rulebook ID from list_build_systems. Overrides the Curator's default Rulebook.
skill_ids	array	optional	Exact compatible Skill IDs from list_build_systems. When supplied, replaces the Rulebook's default Skill set.
output_target	string	optional	Delivery target: site, browser game, desktop wrapper, embeddable component, floating overlay, or standalone HTML.
model	string	optional	Generation engine. studio is keyless; other models require an available account provider or linked Engine.
max_iterations	integer	optional	Hard project cap for later outside-agent child revisions. Defaults to 6 and cannot exceed 12.
idempotency_key	string	required	Caller-generated unique key. Reusing it returns the original project/job instead of creating a duplicate.

Raw schema

{
  "type": "object",
  "properties": {
    "project_name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 120,
      "description": "Short name for the new 2ools project."
    },
    "conversation_summary": {
      "type": "string",
      "minLength": 1,
      "maxLength": 12000,
      "description": "Factual build brief distilled from the conversation, including the intended artifact and key decisions."
    },
    "headline": {
      "description": "Exact hero headline to preserve verbatim in the generated site.",
      "type": "string",
      "minLength": 1,
      "maxLength": 140
    },
    "entity": {
      "description": "Grounded identity facts that must survive the build.",
      "type": "object",
      "properties": {
        "name": {
          "description": "Exact person, business, product, or project name.",
          "type": "string",
          "maxLength": 200
        },
        "category": {
          "description": "Entity category, such as musician, restaurant, or SaaS.",
          "type": "string",
          "maxLength": 200
        },
        "description": {
          "description": "Grounded description; omit unsupported claims.",
          "type": "string",
          "maxLength": 5000
        },
        "source_url": {
          "description": "Optional source URL supplied by the user.",
          "type": "string",
          "maxLength": 2000,
          "format": "uri"
        }
      }
    },
    "audience": {
      "description": "Primary audience and the job they need to complete.",
      "type": "string",
      "maxLength": 1000
    },
    "requirements": {
      "default": [],
      "description": "Concrete functionality, content, and section requirements.",
      "maxItems": 20,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 500
      }
    },
    "pages": {
      "default": [
        "Home"
      ],
      "description": "Pages to generate. Use Home for a one-page site or widget.",
      "minItems": 1,
      "maxItems": 8,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 120
      }
    },
    "visual_direction": {
      "description": "Desired visual character, composition, color, typography, or references.",
      "type": "string",
      "maxLength": 2000
    },
    "content_constraints": {
      "default": [],
      "description": "Claims, wording, exclusions, or fidelity constraints the build must obey.",
      "maxItems": 20,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 500
      }
    },
    "curator_id": {
      "description": "Exact Curator ID from list_build_systems. Omit for automatic selection.",
      "type": "string",
      "minLength": 1,
      "maxLength": 120
    },
    "rulebook_id": {
      "description": "Exact compatible Rulebook ID from list_build_systems. Overrides the Curator's default Rulebook.",
      "type": "string",
      "minLength": 1,
      "maxLength": 120
    },
    "skill_ids": {
      "description": "Exact compatible Skill IDs from list_build_systems. When supplied, replaces the Rulebook's default Skill set.",
      "minItems": 1,
      "maxItems": 12,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 120
      }
    },
    "output_target": {
      "default": "web",
      "description": "Delivery target: site, browser game, desktop wrapper, embeddable component, floating overlay, or standalone HTML.",
      "type": "string",
      "enum": [
        "web",
        "game",
        "tauri",
        "electron",
        "widget",
        "float",
        "freeform"
      ]
    },
    "model": {
      "default": "studio",
      "description": "Generation engine. studio is keyless; other models require an available account provider or linked Engine.",
      "type": "string",
      "enum": [
        "studio",
        "openai",
        "claude",
        "gemini",
        "grok"
      ]
    },
    "max_iterations": {
      "default": 6,
      "description": "Hard project cap for later outside-agent child revisions. Defaults to 6 and cannot exceed 12.",
      "type": "integer",
      "minimum": 1,
      "maximum": 12
    },
    "idempotency_key": {
      "type": "string",
      "minLength": 8,
      "maxLength": 120,
      "pattern": "^[A-Za-z0-9._:-]+$",
      "description": "Caller-generated unique key. Reusing it returns the original project/job instead of creating a duplicate."
    }
  },
  "required": [
    "project_name",
    "conversation_summary",
    "idempotency_key"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

refine_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.

Parameters5

project_id	string	required	Project containing the saved base version.
base_version_id	string	required	Authoritative saved version to use as the parent and current source.
feedback	string	required	Specific requested changes. Requirements not explicitly changed remain in force.
model	string	optional	Generation engine for this child revision. Studio safely preserves the parent but cannot apply substantive edits; choose an AI model or linked Engine for real revisions.
idempotency_key	string	required	Unique retry key. Reuse returns the original revision job without consuming another iteration.

Raw schema

{
  "type": "object",
  "properties": {
    "project_id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      "description": "Project containing the saved base version."
    },
    "base_version_id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      "description": "Authoritative saved version to use as the parent and current source."
    },
    "feedback": {
      "type": "string",
      "minLength": 1,
      "maxLength": 5000,
      "description": "Specific requested changes. Requirements not explicitly changed remain in force."
    },
    "model": {
      "default": "studio",
      "description": "Generation engine for this child revision. Studio safely preserves the parent but cannot apply substantive edits; choose an AI model or linked Engine for real revisions.",
      "type": "string",
      "enum": [
        "studio",
        "openai",
        "claude",
        "gemini",
        "grok"
      ]
    },
    "idempotency_key": {
      "type": "string",
      "minLength": 8,
      "maxLength": 120,
      "pattern": "^[A-Za-z0-9._:-]+$",
      "description": "Unique retry key. Reuse returns the original revision job without consuming another iteration."
    }
  },
  "required": [
    "project_id",
    "base_version_id",
    "feedback",
    "idempotency_key"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_build

Get one build's current status, progress, errors, completed version IDs, and protected preview URLs. Does not return generated source code.

Parameters1

job_id

string

required

Build job ID returned by build_from_conversation.

Raw schema

{
  "type": "object",
  "properties": {
    "job_id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      "description": "Build job ID returned by build_from_conversation."
    }
  },
  "required": [
    "job_id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

compare_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.

Parameters3

project_id	string	required	Project containing both versions.
left_version_id	string	required	Earlier or baseline version ID.
right_version_id	string	required	Later or candidate version ID.

Raw schema

{
  "type": "object",
  "properties": {
    "project_id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      "description": "Project containing both versions."
    },
    "left_version_id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      "description": "Earlier or baseline version ID."
    },
    "right_version_id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      "description": "Later or candidate version ID."
    }
  },
  "required": [
    "project_id",
    "left_version_id",
    "right_version_id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

list_approval_requests

List exact saved versions waiting for a separately delegated reviewer. Returns project/version identity and attribution, never generated source.

Parameters2

status	string	optional	Review-request status to return.
limit	integer	optional	Maximum approval requests to return.

Raw schema

{
  "type": "object",
  "properties": {
    "status": {
      "default": "pending",
      "description": "Review-request status to return.",
      "type": "string",
      "enum": [
        "pending",
        "approved",
        "rejected",
        "all"
      ]
    },
    "limit": {
      "default": 20,
      "description": "Maximum approval requests to return.",
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

approve_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.

Parameters4

project_id	string	required	Project containing the candidate version.
version_id	string	required	Saved candidate version to approve.
confirmation	string	required	Explicit approval confirmation.
decision_note	string	optional	Optional review note stored with the delegated decision.

Raw schema

{
  "type": "object",
  "properties": {
    "project_id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      "description": "Project containing the candidate version."
    },
    "version_id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      "description": "Saved candidate version to approve."
    },
    "confirmation": {
      "type": "string",
      "const": "APPROVE",
      "description": "Explicit approval confirmation."
    },
    "decision_note": {
      "default": "",
      "description": "Optional review note stored with the delegated decision.",
      "type": "string",
      "maxLength": 2000
    }
  },
  "required": [
    "project_id",
    "version_id",
    "confirmation"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

reject_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.

Parameters4

project_id	string	required	Project containing the candidate version.
version_id	string	required	Saved candidate version to reject.
confirmation	string	required	Explicit rejection confirmation.
decision_note	string	required	Review feedback explaining what the next child revision should change.

Raw schema

{
  "type": "object",
  "properties": {
    "project_id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      "description": "Project containing the candidate version."
    },
    "version_id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      "description": "Saved candidate version to reject."
    },
    "confirmation": {
      "type": "string",
      "const": "REJECT",
      "description": "Explicit rejection confirmation."
    },
    "decision_note": {
      "type": "string",
      "minLength": 1,
      "maxLength": 2000,
      "description": "Review feedback explaining what the next child revision should change."
    }
  },
  "required": [
    "project_id",
    "version_id",
    "confirmation",
    "decision_note"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

cancel_build

Cancel a queued or running non-Agent 2ools build. Completed versions are not deleted and terminal builds are left unchanged. Governed Agent execution uses cancel_agent_run.

Parameters1

job_id

string

required

Build job ID returned by build_from_conversation.

Raw schema

{
  "type": "object",
  "properties": {
    "job_id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      "description": "Build job ID returned by build_from_conversation."
    }
  },
  "required": [
    "job_id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

list_projects

List recent 2ools projects the authenticated account can access, including owned and shared projects. Returns compact metadata without generated source.

Parameters1

limit

integer

optional

Maximum projects to return.

Raw schema

{
  "type": "object",
  "properties": {
    "limit": {
      "default": 20,
      "description": "Maximum projects to return.",
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_project

Get a 2ools project's brief, selected pages, active version, and compact version history. Does not return generated source code.

Parameters1

project_id

string

required

2ools project ID.

Raw schema

{
  "type": "object",
  "properties": {
    "project_id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      "description": "2ools project ID."
    }
  },
  "required": [
    "project_id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_project_context

Read one source-free operating packet before acting: the active version, exact frozen Curator snapshot, revision-safe Rulebook context, review attention, artifact index, work queue, and current activity cursor. Historical Rulebook text is never guessed after its revision changes.

Parameters2

project_id	string	required	2ools project ID.
include_governance_text	boolean	optional	Include exact Rulebook content and policy when the active version still matches the current Rulebook revision.

Raw schema

{
  "type": "object",
  "properties": {
    "project_id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      "description": "2ools project ID."
    },
    "include_governance_text": {
      "default": true,
      "description": "Include exact Rulebook content and policy when the active version still matches the current Rulebook revision.",
      "type": "boolean"
    }
  },
  "required": [
    "project_id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

render_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.

Parameters2

project_id	string	required	Project containing the saved version.
version_id	string	required	Saved version to display.

Raw schema

{
  "type": "object",
  "properties": {
    "project_id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      "description": "Project containing the saved version."
    },
    "version_id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      "description": "Saved version to display."
    }
  },
  "required": [
    "project_id",
    "version_id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

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.

Parameters1

project_id

string

required

Readable 2ools project ID.

Raw schema

{
  "type": "object",
  "properties": {
    "project_id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      "description": "Readable 2ools project ID."
    }
  },
  "required": [
    "project_id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_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.

Parameters2

agent_id	string	required	2ools Agent ID.
run_limit	integer	optional	Maximum recent runs to include.

Raw schema

{
  "type": "object",
  "properties": {
    "agent_id": {
      "type": "string",
      "minLength": 8,
      "maxLength": 64,
      "pattern": "^[a-z0-9-]+$",
      "description": "2ools Agent ID."
    },
    "run_limit": {
      "default": 25,
      "description": "Maximum recent runs to include.",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    }
  },
  "required": [
    "agent_id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

run_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.

Parameters5

project_id	string	required	Project this Agent is assigned to.
agent_id	string	required	Already-armed 2ools Agent ID.
task	string	required	Concrete task for this run. This cannot widen the Agent's saved tools, folders, network, send, change, or spend authority.
model	string	required	CLI model available through the account's online Engine.
idempotency_key	string	required	Caller-generated unique key. Reusing it returns the original run instead of starting another.

Raw schema

{
  "type": "object",
  "properties": {
    "project_id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      "description": "Project this Agent is assigned to."
    },
    "agent_id": {
      "type": "string",
      "minLength": 8,
      "maxLength": 64,
      "pattern": "^[a-z0-9-]+$",
      "description": "Already-armed 2ools Agent ID."
    },
    "task": {
      "type": "string",
      "minLength": 1,
      "maxLength": 20000,
      "description": "Concrete task for this run. This cannot widen the Agent's saved tools, folders, network, send, change, or spend authority."
    },
    "model": {
      "type": "string",
      "enum": [
        "openai",
        "claude",
        "gemini",
        "grok"
      ],
      "description": "CLI model available through the account's online Engine."
    },
    "idempotency_key": {
      "type": "string",
      "minLength": 8,
      "maxLength": 120,
      "pattern": "^[A-Za-z0-9._:-]+$",
      "description": "Caller-generated unique key. Reusing it returns the original run instead of starting another."
    }
  },
  "required": [
    "project_id",
    "agent_id",
    "task",
    "model",
    "idempotency_key"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

cancel_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.

Parameters4

project_id	string	required	Project the Agent run belongs to.
agent_id	string	required	Agent that owns the run.
run_id	string	required	Agent run ID returned by run_project_agent.
job_id	string	required	Agent job ID returned by run_project_agent.

Raw schema

{
  "type": "object",
  "properties": {
    "project_id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      "description": "Project the Agent run belongs to."
    },
    "agent_id": {
      "type": "string",
      "minLength": 8,
      "maxLength": 64,
      "pattern": "^[a-z0-9-]+$",
      "description": "Agent that owns the run."
    },
    "run_id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      "description": "Agent run ID returned by run_project_agent."
    },
    "job_id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      "description": "Agent job ID returned by run_project_agent."
    }
  },
  "required": [
    "project_id",
    "agent_id",
    "run_id",
    "job_id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_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.

Parameters3

project_id	string	required	2ools project ID.
limit	integer	optional	Maximum activity items to return.
cursor	string	optional	Opaque next_cursor from a prior response.

Raw schema

{
  "type": "object",
  "properties": {
    "project_id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      "description": "2ools project ID."
    },
    "limit": {
      "default": 40,
      "description": "Maximum activity items to return.",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "cursor": {
      "description": "Opaque next_cursor from a prior response.",
      "type": "string",
      "maxLength": 1000
    }
  },
  "required": [
    "project_id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

wait_for_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.

Parameters4

project_id	string	required	2ools project ID.
after_cursor	string	required	Opaque head_cursor from get_project_activity or next_cursor from a prior wait.
limit	integer	optional	Maximum new events to return.
timeout_seconds	integer	optional	Maximum time to wait before returning timed_out=true.

Raw schema

{
  "type": "object",
  "properties": {
    "project_id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      "description": "2ools project ID."
    },
    "after_cursor": {
      "type": "string",
      "minLength": 1,
      "maxLength": 1000,
      "description": "Opaque head_cursor from get_project_activity or next_cursor from a prior wait."
    },
    "limit": {
      "default": 40,
      "description": "Maximum new events to return.",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "timeout_seconds": {
      "default": 20,
      "description": "Maximum time to wait before returning timed_out=true.",
      "type": "integer",
      "minimum": 1,
      "maximum": 20
    }
  },
  "required": [
    "project_id",
    "after_cursor"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

list_project_feedback

Read page-anchored review feedback for versions in a project, with explicit human or external-agent attribution.

Parameters2

project_id	string	required	2ools project ID.
include_resolved	boolean	optional	Include feedback already marked resolved.

Raw schema

{
  "type": "object",
  "properties": {
    "project_id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      "description": "2ools project ID."
    },
    "include_resolved": {
      "default": false,
      "description": "Include feedback already marked resolved.",
      "type": "boolean"
    }
  },
  "required": [
    "project_id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

add_project_feedback

Add an attributable review comment to a saved project version. This does not modify source or approve the version.

Parameters9

project_id	string	required
version_id	string	required
page	string	optional
x	number	optional	Horizontal position as a percentage.
y	number	optional	Vertical position as a percentage.
label	string	optional
comment	string	required
reply_to_feedback_id	string	optional	Root feedback ID to reply to. Replies inherit the root pin position and cannot be nested.
idempotency_key	string	required	Caller-generated retry key. Reusing it returns the original feedback item.

Raw schema

{
  "type": "object",
  "properties": {
    "project_id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    },
    "version_id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    },
    "page": {
      "default": "Home",
      "type": "string",
      "minLength": 1,
      "maxLength": 120
    },
    "x": {
      "default": 50,
      "description": "Horizontal position as a percentage.",
      "type": "number",
      "minimum": 0,
      "maximum": 100
    },
    "y": {
      "default": 50,
      "description": "Vertical position as a percentage.",
      "type": "number",
      "minimum": 0,
      "maximum": 100
    },
    "label": {
      "default": "",
      "type": "string",
      "maxLength": 120
    },
    "comment": {
      "type": "string",
      "minLength": 1,
      "maxLength": 600
    },
    "reply_to_feedback_id": {
      "description": "Root feedback ID to reply to. Replies inherit the root pin position and cannot be nested.",
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    },
    "idempotency_key": {
      "type": "string",
      "minLength": 8,
      "maxLength": 120,
      "pattern": "^[A-Za-z0-9._:-]+$",
      "description": "Caller-generated retry key. Reusing it returns the original feedback item."
    }
  },
  "required": [
    "project_id",
    "version_id",
    "comment",
    "idempotency_key"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

resolve_project_feedback

Owner-only review decision that resolves or reopens one saved feedback item.

Parameters3

project_id	string	required
feedback_id	string	required
resolved	boolean	optional

Raw schema

{
  "type": "object",
  "properties": {
    "project_id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    },
    "feedback_id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    },
    "resolved": {
      "default": true,
      "type": "boolean"
    }
  },
  "required": [
    "project_id",
    "feedback_id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

list_project_pins

Read shared workspace notes and http(s) links, with explicit attribution.

Parameters1

project_id

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "project_id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    }
  },
  "required": [
    "project_id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

add_project_pin

Add an attributable note or safe http(s) link to the shared project workspace.

Parameters9

project_id	string	required
version_id	string	optional
kind	string	required
url	string	optional
label	string	optional
x	number	optional
y	number	optional
surface	string	optional
idempotency_key	string	required	Caller-generated retry key. Reusing it returns the original pin.

Raw schema

{
  "type": "object",
  "properties": {
    "project_id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    },
    "version_id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    },
    "kind": {
      "type": "string",
      "enum": [
        "note",
        "link"
      ]
    },
    "url": {
      "type": "string",
      "maxLength": 2000,
      "format": "uri"
    },
    "label": {
      "default": "",
      "type": "string",
      "maxLength": 200
    },
    "x": {
      "default": 0.5,
      "type": "number",
      "minimum": 0,
      "maximum": 1
    },
    "y": {
      "default": 0.5,
      "type": "number",
      "minimum": 0,
      "maximum": 1
    },
    "surface": {
      "default": "chrome",
      "type": "string",
      "enum": [
        "chrome",
        "preview"
      ]
    },
    "idempotency_key": {
      "type": "string",
      "minLength": 8,
      "maxLength": 120,
      "pattern": "^[A-Za-z0-9._:-]+$",
      "description": "Caller-generated retry key. Reusing it returns the original pin."
    }
  },
  "required": [
    "project_id",
    "kind",
    "idempotency_key"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

remove_project_pin

Remove one shared workspace pin. The operation is idempotent.

Parameters2

project_id	string	required
pin_id	string	required

Raw schema

{
  "type": "object",
  "properties": {
    "project_id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    },
    "pin_id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    }
  },
  "required": [
    "project_id",
    "pin_id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

prepare_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.

Parameters2

project_id	string	required
version_id	string	required

Raw schema

{
  "type": "object",
  "properties": {
    "project_id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    },
    "version_id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    }
  },
  "required": [
    "project_id",
    "version_id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

list_artifacts

List durable project artifacts and each latest immutable version without returning stored bytes.

Parameters1

project_id

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "project_id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    }
  },
  "required": [
    "project_id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_artifact

Read one artifact's immutable version history, provenance, attribution, digests, and review states without returning stored bytes.

Parameters2

project_id	string	required
artifact_id	string	required

Raw schema

{
  "type": "object",
  "properties": {
    "project_id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    },
    "artifact_id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    }
  },
  "required": [
    "project_id",
    "artifact_id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

prepare_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.

Parameters10

project_id	string	required
artifact_id	string	optional	Existing artifact to version. Omit when creating a new artifact.
parent_version_id	string	optional	Required latest version id when updating an existing artifact.
kind	string	required
name	string	required
filename	string	required
media_type	string	required
byte_size	integer	required
sha256	string	required
review_note	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "project_id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    },
    "artifact_id": {
      "description": "Existing artifact to version. Omit when creating a new artifact.",
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    },
    "parent_version_id": {
      "description": "Required latest version id when updating an existing artifact.",
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    },
    "kind": {
      "type": "string",
      "enum": [
        "site",
        "widget",
        "freeform",
        "document",
        "pdf",
        "presentation",
        "spreadsheet",
        "image",
        "archive",
        "message",
        "dataset",
        "file"
      ]
    },
    "name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 160
    },
    "filename": {
      "type": "string",
      "minLength": 1,
      "maxLength": 240
    },
    "media_type": {
      "type": "string",
      "minLength": 3,
      "maxLength": 200
    },
    "byte_size": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 10000000
    },
    "sha256": {
      "type": "string",
      "pattern": "^[a-fA-F0-9]{64}$"
    },
    "review_note": {
      "type": "string",
      "maxLength": 2000
    }
  },
  "required": [
    "project_id",
    "kind",
    "name",
    "filename",
    "media_type",
    "byte_size",
    "sha256"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

prepare_artifact_download

Create a five-minute download URL for one immutable artifact version. Stored bytes never enter MCP model output.

Parameters3

project_id	string	required
artifact_id	string	required
artifact_version_id	string	required

Raw schema

{
  "type": "object",
  "properties": {
    "project_id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    },
    "artifact_id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    },
    "artifact_version_id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    }
  },
  "required": [
    "project_id",
    "artifact_id",
    "artifact_version_id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

list_artifact_approval_requests

List exact artifact versions awaiting or carrying a human review decision. Requires separately delegated artifact review authority.

Parameters2

project_id	string	optional
status	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "project_id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    },
    "status": {
      "default": "pending",
      "type": "string",
      "enum": [
        "pending",
        "approved",
        "rejected"
      ]
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

approve_artifact_version

Approve one pending immutable artifact version and make it current. Repeating the same decision is idempotent.

Parameters2

request_id	string	required
note	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "request_id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    },
    "note": {
      "type": "string",
      "maxLength": 2000
    }
  },
  "required": [
    "request_id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

reject_artifact_version

Reject one pending immutable artifact version with useful feedback. Repeating the same decision is idempotent.

Parameters2

request_id	string	required
note	string	required

Raw schema

{
  "type": "object",
  "properties": {
    "request_id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    },
    "note": {
      "type": "string",
      "minLength": 1,
      "maxLength": 2000
    }
  },
  "required": [
    "request_id",
    "note"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

list_work_assignments

List durable project work contracts, bounded attempts, leases, budgets, and result references.

Parameters2

project_id	string	required
status	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "project_id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    },
    "status": {
      "type": "string",
      "enum": [
        "open",
        "in_progress",
        "review",
        "completed",
        "canceled"
      ]
    }
  },
  "required": [
    "project_id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

create_work_assignment

Create a durable assignment with acceptance criteria and hard step, time, and spend ceilings.

Parameters10

project_id	string	required
title	string	required
brief	string	required
acceptance_criteria	array	optional
priority	string	optional
max_steps	integer	optional
max_minutes	integer	optional
max_spend_cents	integer	optional
due_at	string	optional
idempotency_key	string	required

Raw schema

{
  "type": "object",
  "properties": {
    "project_id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    },
    "title": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "brief": {
      "type": "string",
      "minLength": 1,
      "maxLength": 10000
    },
    "acceptance_criteria": {
      "default": [],
      "maxItems": 20,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 500
      }
    },
    "priority": {
      "default": "normal",
      "type": "string",
      "enum": [
        "low",
        "normal",
        "high",
        "urgent"
      ]
    },
    "max_steps": {
      "default": 50,
      "type": "integer",
      "minimum": 1,
      "maximum": 500
    },
    "max_minutes": {
      "default": 30,
      "type": "integer",
      "minimum": 1,
      "maximum": 1440
    },
    "max_spend_cents": {
      "default": 0,
      "type": "integer",
      "minimum": 0,
      "maximum": 1000000
    },
    "due_at": {
      "type": "string",
      "format": "date-time",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"
    },
    "idempotency_key": {
      "type": "string",
      "minLength": 8,
      "maxLength": 200
    }
  },
  "required": [
    "project_id",
    "title",
    "brief",
    "idempotency_key"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

claim_work_assignment

Atomically claim one open assignment and receive a five-minute renewable lease plus an immutable budget snapshot.

Parameters3

assignment_id	string	required
input_refs	array	optional
idempotency_key	string	required

Raw schema

{
  "type": "object",
  "properties": {
    "assignment_id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    },
    "input_refs": {
      "default": [],
      "maxItems": 40,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "kind": {
            "type": "string",
            "enum": [
              "builder_version",
              "artifact_version",
              "project",
              "url"
            ]
          },
          "id": {
            "type": "string",
            "minLength": 1,
            "maxLength": 2000
          },
          "artifact_id": {
            "type": "string",
            "maxLength": 100
          },
          "label": {
            "type": "string",
            "maxLength": 160
          }
        },
        "required": [
          "kind",
          "id"
        ]
      }
    },
    "idempotency_key": {
      "type": "string",
      "minLength": 8,
      "maxLength": 200
    }
  },
  "required": [
    "assignment_id",
    "idempotency_key"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

heartbeat_work_session

Renew the authenticated worker's active lease without widening its immutable step, time, or spend ceilings.

Parameters3

session_id	string	required
used_steps	integer	optional
used_spend_cents	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "session_id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    },
    "used_steps": {
      "type": "integer",
      "minimum": 0,
      "maximum": 500
    },
    "used_spend_cents": {
      "type": "integer",
      "minimum": 0,
      "maximum": 1000000
    }
  },
  "required": [
    "session_id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

submit_work_session

End the authenticated worker's lease and submit typed result references for a separate review decision.

Parameters6

session_id	string	required
output_refs	array	optional
result_summary	string	required
used_steps	integer	optional
used_spend_cents	integer	optional
idempotency_key	string	required

Raw schema

{
  "type": "object",
  "properties": {
    "session_id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    },
    "output_refs": {
      "default": [],
      "maxItems": 40,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "kind": {
            "type": "string",
            "enum": [
              "builder_version",
              "artifact_version",
              "project",
              "url"
            ]
          },
          "id": {
            "type": "string",
            "minLength": 1,
            "maxLength": 2000
          },
          "artifact_id": {
            "type": "string",
            "maxLength": 100
          },
          "label": {
            "type": "string",
            "maxLength": 160
          }
        },
        "required": [
          "kind",
          "id"
        ]
      }
    },
    "result_summary": {
      "type": "string",
      "minLength": 1,
      "maxLength": 5000
    },
    "used_steps": {
      "type": "integer",
      "minimum": 0,
      "maximum": 500
    },
    "used_spend_cents": {
      "type": "integer",
      "minimum": 0,
      "maximum": 1000000
    },
    "idempotency_key": {
      "type": "string",
      "minLength": 8,
      "maxLength": 200
    }
  },
  "required": [
    "session_id",
    "result_summary",
    "idempotency_key"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

decide_work_assignment

Complete submitted work or reopen it with useful feedback. Requires separately delegated work-review authority.

Parameters4

assignment_id	string	required
decision	string	required
note	string	optional
idempotency_key	string	required

Raw schema

{
  "type": "object",
  "properties": {
    "assignment_id": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
    },
    "decision": {
      "type": "string",
      "enum": [
        "completed",
        "reopened"
      ]
    },
    "note": {
      "type": "string",
      "maxLength": 2000
    },
    "idempotency_key": {
      "type": "string",
      "minLength": 8,
      "maxLength": 200
    }
  },
  "required": [
    "assignment_id",
    "decision",
    "idempotency_key"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

app.2ools/mcp (Model Context Protocol Server)

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

create_public_preview

list_build_systems

build_from_conversation

refine_project

get_build

compare_versions

list_approval_requests

approve_version

reject_version

cancel_build

list_projects

get_project

get_project_context

render_project_preview

list_project_agents

get_agent

run_project_agent

cancel_agent_run

get_project_activity

wait_for_project_activity

list_project_feedback

add_project_feedback

resolve_project_feedback

list_project_pins

add_project_pin

remove_project_pin

prepare_version_export

list_artifacts

get_artifact

prepare_artifact_upload

prepare_artifact_download

list_artifact_approval_requests

approve_artifact_version

reject_artifact_version

list_work_assignments

create_work_assignment

claim_work_assignment

heartbeat_work_session

submit_work_session

decide_work_assignment

Install

Remote endpoint