2ools

Official40 toolsLive

by 2ools · JavaScript

Build, version, review, and export websites, web apps, and games from a conversation.

app.2ools/mcp MCP Server

The app.2ools/mcp MCP server is a remote MCP server for 2ools. It helps you build, version, review, and export websites, web apps, and games from inside the AI chat you already use. It exposes tools over Streamable HTTP and is listed on the MCP Registry.

🛠️ Key Features

Remote MCP server for 2ools
Build, version, review, and export websites, web apps, and games
Model Context Protocol (MCP) integration
Tool support (listed as 40)

🚀 Use Cases

Generating and iterating on websites
Creating and revising web apps
Producing and exporting games via chat workflows

⚡ Developer Benefits

Access via Streamable HTTP
Works within an existing AI chat experience
MCP Registry discoverability for app.2ools/mcp

⚠️ Limitations

Only described as a remote server; no local/embedded mode is stated
No specific tool names or response schemas are provided

Topics

aianthropicclaudeclaude-desktopcursorllmmcpmcp-servermodel-context-protocolwebsite-builder

Captured live from the server via tools/list.

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#"
}

README.md13 KBView on GitHub

2ools MCP Server

Remote MCP server for 2ools — build, version, review and export websites, web apps and games from inside the AI chat you already use.

code

https://2ools.app/mcp

Your assistant writes the site. 2ools is where it lives: every result becomes a restorable version, previews are shareable links that need no account to open, and the source exports as plain files with no proprietary runtime.

One tool is free and needs no account at all — create_public_preview turns a standalone HTML document your model just wrote into a real, viewable URL. The rest connect over OAuth 2.1 with PKCE and least-privilege scopes.

Quick start

Paste this into the AI client you want to connect:

Connect this client to 2ools (github.com/2ools/mcp-server, MCP endpoint https://2ools.app/mcp). Retrieve https://2ools.app/start non-visibly with an HTTP or web-fetch tool; never navigate the in-app browser to that instructions page. Use this client's in-app browser for every 2ools sign-in and authorization page; never use Chrome, another external browser, or the system browser when this client has an in-app browser or preview pane. The exact OAuth approval URL must be the first 2ools page you visibly open. Before I must act, your only user-facing setup message may be Connecting 2ools in this client's browser…. Do not output insight blocks or narrate setup mechanics. Ask me exactly once to sign in and click Authorize. Do not end your turn while authorization is pending; after it succeeds, keep the 2ools app visibly open in that pane. Fetch https://2ools.app/start and follow its "For your AI" steps exactly.

The live start page is the single current connection ritual for every client. It detects the current client path, keeps OAuth alive, and leaves only sign-in and the Authorize click to the person. Manual MCP configuration is a fallback only for clients that cannot manage their own remote-MCP setup.

After authorization, the initiating context selects the app destination: an exact project's Project OS when its ID is known, the new-project or existing-project workspace flow when that intent is known, and the authenticated MCP workspace for a generic install. The public homepage is never the fallback.

Registry introspection proxy

Registries that require a local stdio process can run the included credential-free proxy. It forwards MCP JSON-RPC traffic to the same verified remote endpoint; it does not mock or reimplement any 2ools tools. It translates the stdio handshake into the remote endpoint's current per-request MCP envelope and returns the live schemas from 2ools.

bash

npm ci
npm start

The included Dockerfile runs the same dependency-free proxy for reproducible registry introspection. It intentionally does not perform an interactive OAuth flow. Clients using authenticated workspace tools should connect directly to https://2ools.app/mcp so OAuth remains end-to-end with 2ools.

2ools Skill

For assistants that support repository skills, add or copy the 2ools Skill. It keeps the temporary-preview and OAuth workspace boundaries explicit. Client support for remote MCP and Skill folders varies; the live start page routes each client to its supported flow.

Try it with no account

Ask your assistant:

Write this as one standalone HTML document, create a free 2ools preview, and show me the link.

You get back a real URL that anyone can open. It expires after 24 hours.

What you can do with it

Ask your assistant…	It uses
"Open this generated site in 2ools and give me a client-safe preview link"	`create_public_preview`
"Save this conversation as a durable 2ools project"	`build_from_conversation`
"Make the hours bigger and show me the new version"	`refine_project`
"Compare the last two versions"	`compare_versions`
"What changed on this project since Tuesday?"	`get_project_activity`
"Export the source as a zip"	`prepare_version_export`

Tools

43 tools, each with explicit readOnlyHint and destructiveHint annotations so a client can reason about blast radius before calling anything.

Free — no account required

Tool	Effect	What it does
`create_public_preview`	write	Turn a complete standalone HTML document already created in this chat into a temporary, read-only 2ools preview.

Build and refine

Tool	Effect	What it does
`build_from_conversation`	write	Create a new 2ools project from a structured conversation brief and queue one durable build.
`refine_project`	write	Create one protected child version from a saved base version and concrete review feedback.
`get_build`	read-only	Get one build's current status, progress, errors, completed version IDs, and protected preview URLs.
`cancel_build`	destructive	Cancel a queued or running non-Agent 2ools build.
`compare_versions`	read-only	Compare two saved versions in one project without returning source.
`list_build_systems`	read-only	List the Curators, Rulebooks, and Skills this paid account may explicitly apply.

Read a project

Tool	Effect	What it does
`list_projects`	read-only	List recent 2ools projects the authenticated account can access, including owned and shared projects.
`get_project`	read-only	Get a 2ools project's brief, selected pages, active version, and compact version history.
`get_project_context`	read-only	Read one source-free operating packet before acting: the active version, exact frozen Curator snapshot, revision-…
`render_project_preview`	read-only	Render an interactive, read-only card for one saved 2ools version.
`get_project_activity`	read-only	Read the attributable project timeline across human work, external MCP agents, builds, versions, feedback, and…
`wait_for_project_activity`	read-only	Wait up to 20 seconds for attributable project events newer than a head_cursor or prior next_cursor.

Review and approval

Tool	Effect	What it does
`list_approval_requests`	read-only	List exact saved versions waiting for a separately delegated reviewer.
`approve_version`	destructive	Use separately delegated review authority to approve one saved version and make it the project's active version.
`reject_version`	destructive	Use separately delegated review authority to reject one saved version.

Feedback and shared notes

Tool	Effect	What it does
`list_project_feedback`	read-only	Read page-anchored review feedback for versions in a project, with explicit human or external-agent attribution.
`add_project_feedback`	write	Add an attributable review comment to a saved project version.
`resolve_project_feedback`	destructive	Owner-only review decision that resolves or reopens one saved feedback item.
`list_project_pins`	read-only	Read shared workspace notes and http(s) links, with explicit attribution.
`add_project_pin`	write	Add an attributable note or safe http(s) link to the shared project workspace.
`remove_project_pin`	destructive	Remove one shared workspace pin.

Tool	Effect	What it does
`prepare_version_export`	read-only	Create a five-minute download URL for an exact saved version.
`get_version_share_link`	read-only	Read the durable sharing state and current URL for one exact saved version.
`create_version_share_link`	write	Create or recover a durable public or code-protected link for one exact saved version.
`revoke_version_share_link`	destructive	Disable every existing public or code-protected URL for one exact saved version.

Artifacts

Tool	Effect	What it does
`list_artifacts`	read-only	List durable project artifacts and each latest immutable version without returning stored bytes.
`get_artifact`	read-only	Read one artifact's immutable version history, provenance, attribution, digests, and review states without…
`prepare_artifact_upload`	write	Create a five-minute PUT URL for exact bytes.
`prepare_artifact_download`	read-only	Create a five-minute download URL for one immutable artifact version.
`list_artifact_approval_requests`	read-only	List exact artifact versions awaiting or carrying a human review decision.
`approve_artifact_version`	write	Approve one pending immutable artifact version and make it current.
`reject_artifact_version`	write	Reject one pending immutable artifact version with useful feedback.

Agents

Tool	Effect	What it does
`list_project_agents`	read-only	List the authorizing account's built-in Agents assigned to one readable project.
`get_agent`	read-only	Read one Agent's saved Limits, trigger, immutable revision summaries, and redacted append-only run traces.
`run_project_agent`	write	Queue real execution for a project-linked Agent the person already test-ran and armed.
`cancel_agent_run`	destructive	Stop one queued or running Agent execution and close its durable run history.

Work assignments

Tool	Effect	What it does
`list_work_assignments`	read-only	List durable project work contracts, bounded attempts, leases, budgets, and result references.
`create_work_assignment`	write	Create a durable assignment with acceptance criteria and hard step, time, and spend ceilings.
`claim_work_assignment`	write	Atomically claim one open assignment and receive a five-minute renewable lease plus an immutable budget snapshot.
`heartbeat_work_session`	write	Renew the authenticated worker's active lease without widening its immutable step, time, or spend ceilings.
`submit_work_session`	write	End the authenticated worker's lease and submit typed result references for a separate review decision.
`decide_work_assignment`	write	Complete submitted work or reopen it with useful feedback.

Authentication

Access	Method	Scopes
`create_public_preview`	none — genuinely authless	—
Everything else	OAuth 2.1 authorization code + PKCE (S256)	least-privilege, consented per connection

The authorization server publishes RFC 8414 and RFC 9728 discovery documents at /.well-known/oauth-authorization-server and /.well-known/oauth-protected-resource, supports RFC 7591 dynamic client registration, rotates refresh tokens with family revocation on replay, and stores only token digests.

Review authority is deliberately separate from build authority. projects:build lets an agent produce candidate versions; approve_version and reject_version require projects:approve, which is excluded from default grants. An agent that can build cannot sign off on its own work unless a human explicitly delegates that.

Design notes

Source never travels through the model transcript. Exports and artifact downloads are five-minute signed URLs bound to the action, the account and the exact version. The MCP response carries metadata and links, not bytes — so a large site does not consume the context window, and generated source is not replayed into a provider log.

Shared previews run in an opaque-origin sandbox. A shared page is served under a CSP sandbox with connect-src 'none', so a site built by a model cannot read the viewer's cookies, storage, or reach the network.

External agent output enters review, not production. An artifact uploaded by an outside agent is stored immutably and marked pending; it cannot become the current version until a human with review authority approves that exact digest.

Interactive previews use MCP Apps. render_project_preview returns a real interactive card via ui://2ools/project-preview-v1.html rather than a wall of text.

Registry

Published to the official Model Context Protocol registry under the domain-verified namespace app.2ools/mcp.

bash

curl "https://registry.modelcontextprotocol.io/v0/servers?search=2ools"

Status

The endpoint is live in production. Health, including the exact deployed release:

bash

curl https://2ools.app/api/health

License

MIT — see LICENSE. This repository holds the server's public manifest and documentation; the 2ools application itself is a hosted product.

Install

Tools (40)

create_public_previewlist_build_systemsbuild_from_conversationrefine_projectget_buildcompare_versionslist_approval_requestsapprove_version

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://2ools.app/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://2ools.app/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

app.2ools/mcp MCP Server

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

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

2ools MCP Server

Quick start

Registry introspection proxy

2ools Skill

Try it with no account

What you can do with it

Tools

Free — no account required

Build and refine

Read a project

Review and approval

Feedback and shared notes

Export and sharing

Artifacts

Agents

Work assignments

Authentication

Design notes

Links

Registry

Status

License

Install

Remote endpoint

Related servers