Developer Tools

Corezoid

by Corezoid

Overview

Connect Claude to the Corezoid Actor Engine. Browse workspaces, projects, stages and folders; read a process as JSON, lint it, create a new one and deploy your edits with conflict protection; run tasks and inspect their history and node statistics; manage sharing, user groups, API keys, dashboards and charts. Destructive operations (delete, pause, move, deploy) are marked as such and the move/immutability actions are dry-run first with an explicit confirm token. Every call runs with the signed-in user's own Corezoid permissions.

Tools

add-chart

ChatGPT

Add a chart to a Corezoid dashboard. chart_type must be one of: column, pie, funnel, table. Use 'column' for bar/comparison charts — 'bar' is not a valid type.

add-to-group

ChatGPT

Add a user (or API key user) to a group.

create-dashboard

ChatGPT

Create a new Corezoid dashboard for visualizing process node metrics. Returns dashboard_id needed for adding charts.

create-group

ChatGPT

Create a new user group in the current workspace. Returns the group's obj_id (use as obj_to_id when sharing).

create-process

ChatGPT

Create an empty Corezoid process in a folder. Returns the new process ID, its JSON scheme and a base token for the first deploy.

create-project

ChatGPT

Create a new Corezoid project (with optional stages) inside a workspace. Returns the new project_id and the stage IDs that were created.

delete-api-key

ChatGPT

Delete an API key. The secret is invalidated immediately — subsequent requests return 401. Objects owned by the key are reassigned to the workspace owner.

delete-folder

ChatGPT

Move a Corezoid folder to the recycle bin (Trash). Can be restored from the Corezoid UI.

delete-group

ChatGPT

Delete a user group. By default refuses to delete if the group still has active shares — pass force=true to override. Existing share links are revoked when the group is deleted.

delete-process

ChatGPT

Move a Corezoid process (or state diagram) to the recycle bin (Trash). Can be restored from the Corezoid UI. Use pull-process first if you want a local backup before deleting.

delete-project

ChatGPT

Move a Corezoid project to the recycle bin (Trash). It can be restored from the Corezoid UI; permanent destruction is only possible there.

delete-task

ChatGPT

Delete a task from a process. At least one of task_id or ref must be provided. If only ref is given, the task_id and node_id are resolved automatically.

deploy-stage

ChatGPT

Deploy (promote) one stage's processes onto another within a Corezoid project — e.g. develop → production. Wraps the admin obj_scheme compare+merge behind the UI's "Deploy" button (/api/2/compare, /api/2/merge). DESTRUCTIVE, and irreversible on an immutable target. SAFETY: apply=false (default) is a dry-run showing only the diff and any conflicts — nothing is deployed. To deploy you MUST first get the user's explicit confirmation of the exact source→target, then call with apply=true AND confirm="<source_stage_id>-><target_stage_id>". Never deploy without the user confirming. The merge is asynchronous; this tool waits for it to finish over the progress WebSocket.

find-principal

ChatGPT

Search users, groups or API keys in the workspace by substring. Returns obj_ids to pass as obj_to_id in share-object.

get-chart

ChatGPT

Get a single chart with its series data.

get-dashboard

ChatGPT

Get a Corezoid dashboard with its charts and series. Use after add-chart to verify series is populated.

get-node-stat

ChatGPT

Return time-series statistics (in/out counts) for a node over a time range. node_id is the ID shown in the Corezoid UI archive URL (/diagram/{node_id}/archive). ops[0]['data'] contains [{"date":"YYYY-MM-DD","in":N,"out":M}] for non-zero buckets. ops[0]['title'] is the node title.

invite-user

ChatGPT

Invite an external email to the workspace AND share a process/folder/stage/project with them in one call. Returns the invite URL the recipient must open.

lint-process

ChatGPT

Lint a Corezoid process given as JSON text: structural problems, unreachable or no-op nodes, missing error branches, literal values that should be env variables, schema validity. Runs locally on the content; calls nothing.

list-aliases

ChatGPT

List the aliases (short_name -> target process) defined in a Corezoid project's stage. Pass short_name to filter to one exact match instead of scanning the full table — the common case when resolving a known alias (e.g. a Smart API receiver) to its conv_id.

list-api-keys

ChatGPT

List API keys visible in the current workspace.

list-folders

ChatGPT

List the immediate children of a Corezoid folder (subfolders, processes and state diagrams). Read-only.

list-group-objects

ChatGPT

List the processes (conv objects) currently shared with a group. Used to audit group impact before destructive operations. Note: folders/stages/projects shared to the group are not retrievable via this endpoint.

list-groups

ChatGPT

List user groups visible in the current workspace.

list-node-tasks

ChatGPT

Return tasks currently sitting in a specific node of a process. This is a paged scan of one node, not a lookup — to find one task by ref or task_id use show-task instead.

list-projects

ChatGPT

Return the list of projects inside a Corezoid workspace (company), sorted by title.

list-shares

ChatGPT

List users, API keys and groups that currently have access to a Corezoid object.

list-stages

ChatGPT

Return the list of stages (environments) inside a Corezoid project.

list-task-history

ChatGPT

Return the execution history (node path) for a task. Shows each node transition with node_id, node_prev_id, create_time_ms. NOTE: the Corezoid API does not record data snapshots — the data field is always null in history entries. To inspect the current data payload, use show-task (read-only); it also resolves the task_id this tool requires from a ref.

list-variables

ChatGPT

List the environment variables (env_var) of the stage given in scope.stage_id: short_name, obj_id, data_type (raw/json), env_var_type (visible/secret), title, value and change time. Read-only; secret variables are always shown masked.

list-workspaces

ChatGPT

Return the list of Corezoid workspaces (companies) available to the authenticated user.

modify-api-key

ChatGPT

Update title and/or description of an existing API key. Does not regenerate the secret.

modify-chart

ChatGPT

Modify an existing Corezoid chart. Always provide the full series array — partial updates are not supported.

modify-folder

ChatGPT

Rename a Corezoid folder and/or update its description. At least one of title or description must be supplied.

modify-group

ChatGPT

Rename a user group and/or update its description. At least one of title or description must be supplied.

modify-project

ChatGPT

Update a Corezoid project's title, short_name and/or description. At least one of title/short_name/description must be provided.

modify-task

ChatGPT

Modify an existing task's data; at least one of task_id or ref is required. WARNING: the Corezoid API does a SHALLOW (top-level) merge — if a top-level key holds a nested object (e.g. data.currencies), its whole value is replaced and sub-keys absent from your payload are silently lost. Pass deep_merge: true to fetch current task data first and merge recursively, preserving sub-keys.

move-folder

ChatGPT

Move (reparent) one existing NORMAL Corezoid folder to another folder in the configured workspace, preserving its folder ID and descendants; NOT copy, import, or deploy. Projects and stages are intentionally rejected. EXPLICIT-INTENT ONLY: never reorganize automatically during create/edit/review/refactor. SAFETY: apply=false (default) reads the live parent, destination and effective project/stage contexts, checks destination ancestry to prevent self/descendant cycles, and returns a dry-run; to apply, show it to the user and pass the exact context-bound confirm token it returned. Moving the source, destination or either effective stage/project context invalidates an old token; completion is post-verified. destination_folder_id=0 means workspace root. Cross-stage/project/root moves also require allow_cross_stage=true and affect every descendant's environment context. Local mirror directories are not relocated automatically.

move-process

ChatGPT

Move (reparent) one existing Corezoid process/state diagram to another folder in the configured workspace, preserving its object ID and graph; NOT copy, import, or deploy. EXPLICIT-INTENT ONLY: never reorganize objects automatically during create/edit/review/refactor — use only when the user names both object and destination. SAFETY: apply=false (default) reads the live current parent, destination and effective project/stage contexts and returns a dry-run; to apply, show it to the user and pass the exact context-bound confirm token it returned. Moving the source, destination or either effective stage/project context invalidates an old token; completion is post-verified. destination_folder_id=0 means workspace root. Cross-stage/project/root moves also require allow_cross_stage=true, because stage-scoped aliases/variables, access and deployment behavior are not migrated. Local mirror files are not relocated automatically.

pause-process

ChatGPT

Pause one Corezoid process without changing or deploying its graph. CONSEQUENTIAL: Corezoid rejects NEW task creation for a paused process with conveyor_is_not_active — that is admission control, not proof that tasks already running or parked in nodes have stopped; inspect those separately. EXPLICIT-INTENT ONLY: never invoke because a process looks unused, during a review/refactor, or as an inferred safety step — only when the user asks to pause this exact process. SAFETY: apply=false (default) reads live status and returns a dry-run; after showing it and receiving explicit approval, call apply=true with confirm="process#<id>:<live_status>->paused". The live status is re-read on every invocation and the result is post-verified.

pull-process

ChatGPT

Fetch a Corezoid process as JSON. Returns the process scheme and a base token naming the server version it was read at — keep it: a later deploy of this process compares it with the server to detect concurrent changes. Read-only; nothing is written anywhere.

push-process

ChatGPT

Validate and deploy a Corezoid process from JSON. Runs the same gates as the local push: structure fix, schema, lint (force=true overrides blocking findings, never structural ones), a concurrency check against base, a pre-push snapshot, and the irreversibility check. Pass the base token from pull-process / create-process: if someone changed the process on the server since, the push is blocked with a report — pull again and re-apply your edits (merging is not available on the hosted server). Needs scope.stage_id for the snapshot. Returns the deployed scheme with the server's node IDs and a new base for the next edit.

remove-from-group

ChatGPT

Remove a user from a group.

resume-process

ChatGPT

Resume (activate) one paused/debug Corezoid process without changing or deploying its graph. CONSEQUENTIAL: after activation, API clients, schedules, callbacks and other processes may create new tasks immediately. EXPLICIT-INTENT ONLY: never resume automatically after edits, tests, a review or a previous pause — only when the user asks to resume this exact process and accepts incoming traffic. SAFETY: apply=false (default) reads live status and returns a dry-run; after showing it and receiving explicit approval, call apply=true with confirm="process#<id>:<live_status>->active". The live status is re-read on every invocation and the result is post-verified.

run-task

ChatGPT

Create a task in a deployed Corezoid process and wait for it to reach a final node. Returns the task's final node and data.

set-dashboard-layout

ChatGPT

Save chart positions on a dashboard grid. Must be called after add-chart/modify-chart to make charts visible. Each grid entry positions one chart by its chart_id (hex string from add-chart).

set-stage-immutable

ChatGPT

Set a stage's immutable (read-only) flag. Immutable stages are the ONLY valid deploy/merge targets (see deploy-stage); an immutable stage can no longer be edited directly — only changed via deploy. Consequential: making a stage editable removes that protection. Requires explicit user confirmation — call with confirm="<stage_id>:<true|false>" (e.g. "684082:true"). Never change immutability without the user confirming.

show-folder

ChatGPT

Show metadata for a single Corezoid folder: title, obj_type (0 normal, 2 project, 3 stage), parent folder ID and parent type.

show-process

ChatGPT

Show a Corezoid process's own metadata (title, description, status, conv_type, owner_id/owner_login, project_id, stage_id, immutable) without exporting its scheme. Lighter than pull-process for an ownership/location lookup.

show-project

ChatGPT

Show a Corezoid project's metadata and the stages available to the caller. Returns project obj_id, short_name, parent folder ID and the list of stage IDs/titles.

show-task

ChatGPT

Return the current state of a single task — data, obj_id (task_id), node_id and status — resolved by task_id and/or ref. At least one of task_id or ref must be provided; when both are given task_id wins. This is the way to look a task up from an external ref: list-node-tasks needs the node the task is parked in and pages through it, while this is a single lookup. Read-only — it commits nothing, so it also works on immutable stages and with view-only access.

add-chart

Claude

add-to-group

Claude

create-dashboard

Claude

create-group

Claude

create-process

Claude

create-project

Claude

delete-api-key

Claude

delete-folder

Claude

delete-group

Claude

delete-process

Claude

delete-project

Claude

delete-task

Claude

deploy-stage

Claude

find-principal

Claude

get-chart

Claude

get-dashboard

Claude

get-node-stat

Claude

invite-user

Claude

lint-process

Claude

list-aliases

Claude

list-api-keys

Claude

list-folders

Claude

list-group-objects

Claude

list-groups

Claude

list-node-tasks

Claude

list-projects

Claude

list-shares

Claude

list-stages

Claude

list-task-history

Claude

list-variables

Claude

list-workspaces

Claude

modify-api-key

Claude

modify-chart

Claude

modify-folder

Claude

modify-group

Claude

modify-project

Claude

modify-task

Claude

move-folder

Claude

move-process

Claude

pause-process

Claude

pull-process

Claude

push-process

Claude

remove-from-group

Claude

resume-process

Claude

run-task

Claude

set-dashboard-layout

Claude

set-stage-immutable

Claude

show-folder

Claude

show-process

Claude

show-project

Claude

show-task

Claude

Capabilities

Writes

Example Prompts

Click any prompt to copy it.

Links

Documentation ↗Privacy Policy ↗

App Stats

104

Tools

Prompts

ChatGPT, Claude

Platforms