MCP

Updated May 6, 2026 Suggest Edits

MCP tools are how agents get work done in Bakin. They create and move tasks, advance workflows, manage assets and projects, search local state, send messages, schedule recurring work, and check system health.

Use this reference when you need the exact tool name, the arguments it accepts, and a copyable call shape.

Assets

Asset tools let agents list, inspect, save, link, restore, and clean up files managed by Bakin.

bakin_exec_assets_audit Audited assets

Audit asset health: check for missing thumbnails, invalid sidecars, orphaned files. Set fix=true to auto-generate missing thumbnails and create stub sidecars.

mcporter call bakin-<agent>.bakin_exec_assets_audit --args '{
  "type": "value",
  "fix": true
}'

Parameter	Type	Required	Notes
`type`	choice	no	Limit audit to a specific asset type
`fix`	boolean	no	Auto-fix issues where possible

plugins/assets/index.ts:808

bakin_exec_assets_delete Deleted an asset

Soft-delete an asset (moves to trash, restorable until trash is emptied).

mcporter call bakin-<agent>.bakin_exec_assets_delete --args '{
  "filename": "value"
}'

Parameter	Type	Required	Notes
`filename`	string	yes	Canonical asset filename (e.g. "20260401-hero-a1b2c3d4.png")

plugins/assets/index.ts:723

bakin_exec_assets_empty_trash Emptied asset trash

Permanently delete all items from trash. This cannot be undone.

mcporter call bakin-<agent>.bakin_exec_assets_empty_trash

plugins/assets/index.ts:984

bakin_exec_assets_get Read asset details

Retrieve a single asset's sidecar metadata by canonical filename.

mcporter call bakin-<agent>.bakin_exec_assets_get --args '{
  "filename": "value"
}'

Parameter	Type	Required	Notes
`filename`	string	yes	Canonical asset filename (e.g. "20260401-hero-a1b2c3d4.png")

plugins/assets/index.ts:612

bakin_exec_assets_link Linked an asset

Link an asset to a different task, or unlink it (set taskId to null). Sidecar-only edit — no file move.

mcporter call bakin-<agent>.bakin_exec_assets_link --args '{
  "filename": "value",
  "taskId": "value"
}'

Parameter	Type	Required	Notes
`filename`	string	yes	Canonical asset filename (e.g. "20260401-hero-a1b2c3d4.png")
`taskId`	string	yes	Target task ID, or null to unlink

plugins/assets/index.ts:749

bakin_exec_assets_list Listed assets

List assets with optional type filter. Returns asset count, canonical filenames, and metadata.

mcporter call bakin-<agent>.bakin_exec_assets_list --args '{
  "type": "value"
}'

Parameter	Type	Required	Notes
`type`	choice	no	Filter by asset type

plugins/assets/index.ts:595

bakin_exec_assets_list_trash Listed trashed assets

List trashed assets with name, size, deleted timestamp, and days remaining before auto-purge.

mcporter call bakin-<agent>.bakin_exec_assets_list_trash

plugins/assets/index.ts:771

bakin_exec_assets_open Opened an asset

Open an attached asset by canonical filename. Returns sidecar metadata plus extracted text for text-like assets; non-extractable assets return metadata-only status.

mcporter call bakin-<agent>.bakin_exec_assets_open --args '{
  "filename": "value"
}'

Parameter	Type	Required	Notes
`filename`	string	yes	Canonical asset filename (e.g. "20260401-hero-a1b2c3d4.png")

plugins/assets/index.ts:642

bakin_exec_assets_permanent_delete Permanently deleted an asset

Permanently delete a specific trashed asset. This cannot be undone.

mcporter call bakin-<agent>.bakin_exec_assets_permanent_delete --args '{
  "filename": "value"
}'

Parameter	Type	Required	Notes
`filename`	string	yes	The trash filename (includes __deleted- suffix)

plugins/assets/index.ts:998

bakin_exec_assets_restore Restored an asset

Restore a trashed asset back to its original location. Use bakin_exec_assets_list_trash first to get the filename.

mcporter call bakin-<agent>.bakin_exec_assets_restore --args '{
  "filename": "value"
}'

Parameter	Type	Required	Notes
`filename`	string	yes	The trash filename (includes __deleted- suffix)

plugins/assets/index.ts:791

bakin_exec_assets_retype Retyped an asset

Change an asset's type classification. Sidecar-only edit — no file move.

mcporter call bakin-<agent>.bakin_exec_assets_retype --args '{
  "filename": "value",
  "type": "value"
}'

Parameter	Type	Required	Notes
`filename`	string	yes	Canonical asset filename (e.g. "20260401-hero-a1b2c3d4.png")
`type`	choice	yes

plugins/assets/index.ts:938

bakin_exec_assets_save Saved an asset

Save an agent-created file to the assets directory with standardized naming (YYYYMMDD-slug.ext) and sidecar metadata. Handles directory creation, naming conventions, and .meta.json automatically.

mcporter call bakin-<agent>.bakin_exec_assets_save --args '{
  "filePath": "value",
  "taskId": "value",
  "type": "value",
  "description": "value",
  "tags": [
    "value"
  ],
  "tool": "value",
  "slug": "value"
}'

Parameter	Type	Required	Notes
`filePath`	string	yes	Absolute path to the source file to save
`taskId`	string	yes	Task ID to record in sidecar metadata
`type`	choice	yes
`description`	string	no	One-sentence summary visible in the asset grid and search. Be specific — "Q2 blog hero image" not "an image".
`tags`	array	no	Lowercase hyphenated tags for filtering. Use domain tags (social, blog), format tags (draft, final), and project tags.
`tool`	string	no	Tool used to generate (e.g., "dall-e-3", "nano-banana-pro")
`slug`	string	no	Custom filename slug. Auto-derived from source filename if omitted.

plugins/assets/index.ts:703

bakin_exec_assets_update_content Updated asset content

Update the text content of an editable asset. Only works for text-based MIME types (markdown, plain text, YAML, JSON, CSV, XML). Rewrites the entire file.

mcporter call bakin-<agent>.bakin_exec_assets_update_content --args '{
  "filename": "value",
  "content": "value"
}'

Parameter	Type	Required	Notes
`filename`	string	yes	Canonical asset filename (e.g. "20260401-doc-a1b2c3d4.md")
`content`	string	yes	New file content (replaces entire file)

plugins/assets/index.ts:960

Check

MCP tools discovered from registered exec tool definitions.

bakin_exec_check_gates Checked workflow gates

Get a human-readable overview of all gate statuses in a workflow. Shows which gates are approved, waiting, or pending.

mcporter call bakin-<agent>.bakin_exec_check_gates --args '{
  "taskId": "value"
}'

Parameter	Type	Required	Notes
`taskId`	string	yes	Task ID (or workflow instance ID)

plugins/workflows/index.ts:1724

Gen

Generation tools create or import media through Bakin so outputs land in the asset pipeline with task context.

bakin_exec_gen_image Generated an image

Generate an image via Gemini Imagen (Nano Banana), or import an existing image file into the asset pipeline via filePath. Default model: flash (cheaper). Use model=pro for higher quality. Default: 1080x1920 portrait (9:16) for Stories/Reels. Presets: social-portrait, social-square, social-landscape, custom. Auto-generates thumbnail. Max ${MAX_IMAGE_EDGE}px on any edge.

mcporter call bakin-<agent>.bakin_exec_gen_image --args '{
  "prompt": "value",
  "filePath": "value",
  "taskId": "value",
  "preset": "value",
  "width": 20,
  "height": 20,
  "model": "value",
  "thumbnail": true
}'

Parameter	Type	Required	Notes
`prompt`	string	no	Image generation prompt (required for Gemini generation, optional description for raw file import)
`filePath`	string	no	Path to an existing image file to import through the asset pipeline (skips Gemini generation)
`taskId`	string	yes	Task ID for asset organization
`preset`	choice	no	Size preset (default: social-portrait = 1080x1920)
`width`	number	no	Custom width (only when preset=custom, max ${MAX_IMAGE_EDGE})
`height`	number	no	Custom height (only when preset=custom, max ${MAX_IMAGE_EDGE})
`model`	choice	no	Model tier: flash (default, cheaper) or pro (higher quality)
`thumbnail`	boolean	no	Generate a 400px WebP thumbnail for UI previews (default: true)

scripts/lib/generate-image.ts:321

Get

Runtime lookup tools return local Bakin paths and state agents should not hardcode.

bakin_exec_get_paths Resolved paths

Get Bakin content directory paths — where to find assets, team info, docs, etc.

mcporter call bakin-<agent>.bakin_exec_get_paths

scripts/lib/get-paths.ts:9

bakin_exec_get_step Read workflow step

Get the current workflow step as human-readable formatted text. Includes instructions, prior outputs, schema, and rejection context in a clear structure.

mcporter call bakin-<agent>.bakin_exec_get_step --args '{
  "taskId": "value"
}'

Parameter	Type	Required	Notes
`taskId`	string	yes	Task ID

plugins/workflows/index.ts:1648

Git

MCP tools discovered from registered exec tool definitions.

bakin_exec_git_prepare_worktree Prepared git worktree

Create or reuse an isolated git worktree for a task. Call this before editing code for a Bakin task.

mcporter call bakin-<agent>.bakin_exec_git_prepare_worktree

plugins/git/index.ts:639

bakin_exec_git_release_worktree Released git worktree

Release a tracked git worktree. Refuses dirty removal unless force=true.

mcporter call bakin-<agent>.bakin_exec_git_release_worktree

plugins/git/index.ts:654

bakin_exec_git_status Checked git worktrees

List Bakin-tracked git worktrees and their dirty state.

mcporter call bakin-<agent>.bakin_exec_git_status

plugins/git/index.ts:647

Health

Health tools let agents check whether Bakin is running correctly before or during work.

bakin_exec_health_doctor Ran diagnostics

Run system diagnostics (agent roster, skill sync, runtime, taskboard, assets, etc.). Returns detailed check results. Use fresh=true to force a full re-check instead of returning cached results.

mcporter call bakin-<agent>.bakin_exec_health_doctor --args '{
  "fresh": true
}'

Parameter	Type	Required	Notes
`fresh`	boolean	no	Force fresh diagnostics instead of cached results

plugins/health/index.ts:309

bakin_exec_health_status Checked system health

Get a quick system health summary — uptime, memory, active MCP sessions, and doctor error/warning counts. Useful for checking system state before starting work.

mcporter call bakin-<agent>.bakin_exec_health_status

plugins/health/index.ts:280

Heartbeat

Heartbeat tools let agents publish lightweight status so Bakin can show who is active and what they are doing.

bakin_exec_heartbeat Sent heartbeat

Write a heartbeat signal. Call periodically (every 5-10 minutes) to indicate you are alive. Also call when starting or finishing a task.

mcporter call bakin-<agent>.bakin_exec_heartbeat --args '{
  "status": "value",
  "currentTask": "value",
  "message": "value"
}'

Parameter	Type	Required	Notes
`status`	choice	no	Current status
`currentTask`	string	no	Task ID currently being worked on
`message`	string	no	Brief status note

scripts/lib/heartbeat.ts:13

Lesson

MCP tools discovered from registered exec tool definitions.

bakin_exec_lesson_search Searched package lessons

Search the enabled agent-package lessons for the calling agent.

mcporter call bakin-<agent>.bakin_exec_lesson_search --args '{
  "query": "value",
  "limit": 20
}'

Parameter	Type	Required	Notes
`query`	string	yes	Search query
`limit`	number	no	Max lessons to return (default from settings, max 10)

plugins/team/index.ts:1820

Log

Logging tools record progress updates in Bakin task history and audit surfaces.

bakin_exec_log Logged message

Log a formatted progress update with category and stage tags. Categories: start, progress, milestone, blocked, complete. More structured than raw bakin_exec_tasks_log_progress.

mcporter call bakin-<agent>.bakin_exec_log --args '{
  "taskId": "value",
  "message": "value",
  "category": "value",
  "stage": "value"
}'

Parameter	Type	Required	Notes
`taskId`	string	yes	Task ID
`message`	string	yes	Human-readable status update
`category`	choice	no	Log category (default: progress)
`stage`	string	no	Workflow stage tag (e.g., "image-gen", "copy-review")

scripts/lib/log-progress.ts:45

Memory

Memory tools expose indexed runtime memory, sessions, turns, checkpoints, and status to agents.

bakin_exec_memory_get_session Read session memory

Fetch a session by key plus its most recent turns.

mcporter call bakin-<agent>.bakin_exec_memory_get_session --args '{
  "sessionKey": "value",
  "agent": "value",
  "turnLimit": 20
}'

Parameter	Type	Required	Notes
`sessionKey`	string	yes	Session key (required)
`agent`	string	no	Narrow to a single agent
`turnLimit`	number	no	Max turns to include (default 50)

plugins/memory/mcp/get-session.ts:23

bakin_exec_memory_get_turn Read turn memory

Fetch a single turn by id (the `turn:<hex>` form).

mcporter call bakin-<agent>.bakin_exec_memory_get_turn --args '{
  "turnId": "value"
}'

Parameter	Type	Required	Notes
`turnId`	string	yes	Turn id (required, e.g. turn:abc123...)

plugins/memory/mcp/get-turn.ts:23

bakin_exec_memory_list_agents Listed memory agents

Agents with memory rows, each with total count and per-tier breakdown.

mcporter call bakin-<agent>.bakin_exec_memory_list_agents

plugins/memory/mcp/list-agents.ts:20

bakin_exec_memory_search Searched memory

Hybrid search across every memory tier (sessions, turns, checkpoints, daily notes, dreams, durable, audit). Optional tier/agent filters.

mcporter call bakin-<agent>.bakin_exec_memory_search --args '{
  "query": "value",
  "agent": "value",
  "limit": 20
}'

Parameter	Type	Required	Notes
`query`	string	no	Search query (required)
`agent`	string	no	Filter to a single agent id
`limit`	number	no	Max results (default 20, max 100)

plugins/memory/mcp/search.ts:24

bakin_exec_memory_status Read memory status

Indexer health: per-tier row counts, offset tracking, snapshot timestamp.

mcporter call bakin-<agent>.bakin_exec_memory_status

plugins/memory/mcp/status.ts:30

Messaging

Messaging tools let agents create, update, approve, reject, and inspect human-facing messages and sessions.

bakin_exec_messaging_approve Approved a message

Approve a messaging item (draft → scheduled, review → published)

mcporter call bakin-<agent>.bakin_exec_messaging_approve --args '{
  "itemId": "value"
}'

Parameter	Type	Required	Notes
`itemId`	string	yes	Item ID (required)

bakin-bits-official/plugins/messaging/index.ts:1072

bakin_exec_messaging_create Created a message

Create a new messaging item

mcporter call bakin-<agent>.bakin_exec_messaging_create --args '{
  "title": "value",
  "agent": "value",
  "scheduledAt": "value",
  "channels": [
    "value"
  ],
  "contentType": "value",
  "tone": "value",
  "brief": "value",
  "status": "value"
}'

Parameter	Type	Required	Notes
`title`	string	yes	Item title (required)
`agent`	string	yes	Assigned agent (required)
`scheduledAt`	string	yes	ISO datetime for scheduling (required)
`channels`	array	no	Runtime channel IDs (default: ["general"])
`contentType`	string	no	Content type id from the messaging contentTypes setting (e.g. post, article, video)
`tone`	string	no	Content tone (energetic, calm, educational, etc.)
`brief`	string	no	Content brief
`status`	string	no	Initial status (default: draft)

bakin-bits-official/plugins/messaging/index.ts:1011

bakin_exec_messaging_delete Deleted a message

Delete a messaging item

mcporter call bakin-<agent>.bakin_exec_messaging_delete --args '{
  "itemId": "value"
}'

Parameter	Type	Required	Notes
`itemId`	string	yes	Item ID (required)

bakin-bits-official/plugins/messaging/index.ts:1113

bakin_exec_messaging_get Read message details

Get details for a single messaging item

mcporter call bakin-<agent>.bakin_exec_messaging_get --args '{
  "itemId": "value"
}'

Parameter	Type	Required	Notes
`itemId`	string	yes	Item ID (required)

bakin-bits-official/plugins/messaging/index.ts:996

bakin_exec_messaging_list Listed messages

List messaging items with optional filters

mcporter call bakin-<agent>.bakin_exec_messaging_list --args '{
  "month": "value",
  "status": "value",
  "agent": "value",
  "channel": "value"
}'

Parameter	Type	Required	Notes
`month`	string	no	Filter by month (YYYY-MM)
`status`	string	no	Filter by status (draft, scheduled, review, published, etc.)
`agent`	string	no	Filter by assigned agent
`channel`	string	no	Filter by runtime channel ID (e.g. general, announcements)

bakin-bits-official/plugins/messaging/index.ts:960

bakin_exec_messaging_proposal_update Updated brainstorm proposal

Update a proposal status or fields (approve, reject, edit)

mcporter call bakin-<agent>.bakin_exec_messaging_proposal_update --args '{
  "sessionId": "value",
  "proposalId": "value",
  "status": "value",
  "title": "value",
  "brief": "value",
  "tone": "value",
  "scheduledAt": "value",
  "channels": [
    "value"
  ],
  "rejectionNote": "value"
}'

Parameter	Type	Required	Notes
`sessionId`	string	yes	Session ID (required)
`proposalId`	string	yes	Proposal ID (required)
`status`	string	no	New status (proposed, approved, rejected, revised)
`title`	string	no	Updated title
`brief`	string	no	Updated brief
`tone`	string	no	Updated tone
`scheduledAt`	string	no	Updated schedule datetime
`channels`	array	no	Updated channels
`rejectionNote`	string	no	Note explaining rejection

bakin-bits-official/plugins/messaging/index.ts:1294

bakin_exec_messaging_reject Rejected a message

Reject a messaging item back to draft status

mcporter call bakin-<agent>.bakin_exec_messaging_reject --args '{
  "itemId": "value",
  "note": "value"
}'

Parameter	Type	Required	Notes
`itemId`	string	yes	Item ID (required)
`note`	string	no	Rejection note / feedback

bakin-bits-official/plugins/messaging/index.ts:1090

bakin_exec_messaging_session_confirm Confirmed brainstorm proposal

Confirm a planning session — creates messaging items from approved proposals

mcporter call bakin-<agent>.bakin_exec_messaging_session_confirm --args '{
  "sessionId": "value",
  "autoApprove": true
}'

Parameter	Type	Required	Notes
`sessionId`	string	yes	Session ID (required)
`autoApprove`	boolean	no	Auto-approve: create items in scheduled status instead of draft

bakin-bits-official/plugins/messaging/index.ts:1328

bakin_exec_messaging_session_create Created brainstorm session

Create a new planning session for an agent

mcporter call bakin-<agent>.bakin_exec_messaging_session_create --args '{
  "agentId": "value",
  "title": "value"
}'

Parameter	Type	Required	Notes
`agentId`	string	yes	Agent ID (required)
`title`	string	no	Session title

bakin-bits-official/plugins/messaging/index.ts:1165

bakin_exec_messaging_session_delete Deleted brainstorm session

Delete a planning session

mcporter call bakin-<agent>.bakin_exec_messaging_session_delete --args '{
  "sessionId": "value"
}'

Parameter	Type	Required	Notes
`sessionId`	string	yes	Session ID (required)

bakin-bits-official/plugins/messaging/index.ts:1208

bakin_exec_messaging_session_get Read brainstorm session

Get a planning session with full message history and proposals

mcporter call bakin-<agent>.bakin_exec_messaging_session_get --args '{
  "sessionId": "value"
}'

Parameter	Type	Required	Notes
`sessionId`	string	yes	Session ID (required)

bakin-bits-official/plugins/messaging/index.ts:1150

bakin_exec_messaging_session_list Listed brainstorm sessions

List planning sessions with optional filters

mcporter call bakin-<agent>.bakin_exec_messaging_session_list --args '{
  "status": "value",
  "agentId": "value"
}'

Parameter	Type	Required	Notes
`status`	string	no	Filter by status (active, completed)
`agentId`	string	no	Filter by agent ID

bakin-bits-official/plugins/messaging/index.ts:1133

bakin_exec_messaging_session_message Sent brainstorm message

Send a message in a planning session (non-streaming, returns full response)

mcporter call bakin-<agent>.bakin_exec_messaging_session_message --args '{
  "sessionId": "value",
  "message": "value"
}'

Parameter	Type	Required	Notes
`sessionId`	string	yes	Session ID (required)
`message`	string	yes	User message content (required)

bakin-bits-official/plugins/messaging/index.ts:1228

bakin_exec_messaging_session_update Updated brainstorm session

Update a planning session title or status

mcporter call bakin-<agent>.bakin_exec_messaging_session_update --args '{
  "sessionId": "value",
  "title": "value",
  "status": "value"
}'

Parameter	Type	Required	Notes
`sessionId`	string	yes	Session ID (required)
`title`	string	no	New title
`status`	string	no	New status (active, completed)

bakin-bits-official/plugins/messaging/index.ts:1185

bakin_exec_messaging_update Updated a message

Update a messaging item

mcporter call bakin-<agent>.bakin_exec_messaging_update --args '{
  "itemId": "value",
  "title": "value",
  "scheduledAt": "value",
  "status": "value",
  "brief": "value",
  "tone": "value"
}'

Parameter	Type	Required	Notes
`itemId`	string	yes	Item ID (required)
`title`	string	no	New title
`scheduledAt`	string	no	New schedule datetime
`status`	string	no	New status
`brief`	string	no	Updated brief
`tone`	string	no	Updated tone

bakin-bits-official/plugins/messaging/index.ts:1046

Models

Model tools expose model configuration and available model choices to agents.

bakin_exec_models_get_config Read model config

Get model configuration for all agents or a specific agent. Shows effective model (own override or default), subagent model, and system defaults.

mcporter call bakin-<agent>.bakin_exec_models_get_config --args '{
  "agentId": "value"
}'

Parameter	Type	Required	Notes
`agentId`	string	no	Specific agent ID to query (omit for all agents)

plugins/models/index.ts:730

bakin_exec_models_list Listed models

List available AI models with tier classification (budget/standard/premium). Use this to discover what models are available for assignment.

mcporter call bakin-<agent>.bakin_exec_models_list --args '{
  "tier": "value"
}'

Parameter	Type	Required	Notes
`tier`	choice	no	Filter by model tier

plugins/models/index.ts:711

Post

Publishing tools send completed work to configured channels through Bakin adapters.

bakin_exec_post_channel Posted to channel

Post a message through the active runtime channel adapter. Supports image/video attachments when the adapter supports rich content.

mcporter call bakin-<agent>.bakin_exec_post_channel --args '{
  "channel": "value",
  "content": "value",
  "imageFilename": "value",
  "videoFilename": "value",
  "embed": {
    "key": "value"
  },
  "taskId": "value"
}'

Parameter	Type	Required	Notes
`channel`	string	yes	Channel name or runtime channel target
`content`	string	yes	Message text / caption
`imageFilename`	string	no	Asset filename resolved via the assets index.
`videoFilename`	string	no	Asset filename resolved via the assets index.
`embed`	record	no	Optional rich metadata for adapters that support it
`taskId`	string	no	Task ID for audit trail

scripts/lib/post-channel.ts:111

Project

Project tools let agents create, update, read, and maintain project specs and linked checklist items.

bakin_exec_project_add_item Added project item

Add a new checklist item to a project.

mcporter call bakin-<agent>.bakin_exec_project_add_item --args '{
  "projectId": "value",
  "title": "value"
}'

Parameter	Type	Required	Notes
`projectId`	string	yes	Project ID
`title`	string	yes	Checklist item title

bakin-bits-official/plugins/projects/index.ts:614

bakin_exec_project_ask Asked project question

Ask an agent a question about a project. Sends the project context (spec, checklist, assets) along with the message to the agent for brainstorming.

mcporter call bakin-<agent>.bakin_exec_project_ask --args '{
  "projectId": "value",
  "message": "value",
  "agent": "value"
}'

Parameter	Type	Required	Notes
`projectId`	string	yes	Project ID
`message`	string	yes	Question or prompt for the agent
`agent`	string	no	Agent ID to ask (defaults to main)

bakin-bits-official/plugins/projects/index.ts:804

bakin_exec_project_attach_asset Attached asset to project

Attach an existing asset to a project by filename. Assets provide additional context (specs, designs, docs) that agents can reference. Only summaries are included in project_get — use asset tools to read full content when needed.

mcporter call bakin-<agent>.bakin_exec_project_attach_asset --args '{
  "projectId": "value",
  "filename": "value",
  "label": "value"
}'

Parameter	Type	Required	Notes
`projectId`	string	yes	Project ID
`filename`	string	yes	Asset filename (e.g., "20260327-hero-a1b2c3d4.png") — globally unique, stable across retype/relink
`label`	string	no	Human-readable label or summary of what this asset contains

bakin-bits-official/plugins/projects/index.ts:716

bakin_exec_project_create Created a project

Create a new project with title, markdown body, and optional initial checklist items. Returns project ID and generated task item IDs.

mcporter call bakin-<agent>.bakin_exec_project_create --args '{
  "title": "value",
  "body": "value",
  "owner": "value",
  "tasks": [
    "value"
  ]
}'

Parameter	Type	Required	Notes
`title`	string	yes	Project title
`body`	string	no	Markdown body (spec/plan)
`owner`	string	no	Project owner
`tasks`	array	no	Initial checklist item titles

bakin-bits-official/plugins/projects/index.ts:547

bakin_exec_project_delete Deleted a project

Delete a project by ID.

mcporter call bakin-<agent>.bakin_exec_project_delete --args '{
  "projectId": "value"
}'

Parameter	Type	Required	Notes
`projectId`	string	yes	Project ID

bakin-bits-official/plugins/projects/index.ts:596

bakin_exec_project_detach_asset Detached asset from project

Remove an asset reference from a project by filename. Does not delete the asset itself.

mcporter call bakin-<agent>.bakin_exec_project_detach_asset --args '{
  "projectId": "value",
  "filename": "value"
}'

Parameter	Type	Required	Notes
`projectId`	string	yes	Project ID
`filename`	string	yes	Asset filename to detach

bakin-bits-official/plugins/projects/index.ts:736

bakin_exec_project_get Read project details

Get a project by ID including full spec, checklist, progress, and linked board task statuses.

mcporter call bakin-<agent>.bakin_exec_project_get --args '{
  "projectId": "value"
}'

Parameter	Type	Required	Notes
`projectId`	string	yes	Project ID

bakin-bits-official/plugins/projects/index.ts:533

bakin_exec_project_link_item Linked project item

Link an existing board task to a project checklist item. Use this when a task was created separately and should be associated with a project.

mcporter call bakin-<agent>.bakin_exec_project_link_item --args '{
  "projectId": "value",
  "taskItemId": "value",
  "taskId": "value"
}'

Parameter	Type	Required	Notes
`projectId`	string	yes	Project ID
`taskItemId`	string	yes	Checklist item ID
`taskId`	string	yes	Board task ID to link

bakin-bits-official/plugins/projects/index.ts:668

bakin_exec_project_list Listed projects

List all projects with optional status filter. Returns summaries with id, title, status, progress, taskCount.

mcporter call bakin-<agent>.bakin_exec_project_list --args '{
  "status": "value"
}'

Parameter	Type	Required	Notes
`status`	choice	no	Filter by status

bakin-bits-official/plugins/projects/index.ts:517

bakin_exec_project_mark_item Marked project item

Mark a checklist item as checked (done) or unchecked. Returns updated progress percentage.

mcporter call bakin-<agent>.bakin_exec_project_mark_item --args '{
  "projectId": "value",
  "taskItemId": "value",
  "checked": true
}'

Parameter	Type	Required	Notes
`projectId`	string	yes	Project ID
`taskItemId`	string	yes	Checklist item ID (e.g., t001)
`checked`	boolean	yes	true to mark as done, false to uncheck

bakin-bits-official/plugins/projects/index.ts:629

bakin_exec_project_promote_item Promoted project item

Create a NEW board task from a project checklist item and automatically link it. The task appears on the task board with the item title and projectId set.

mcporter call bakin-<agent>.bakin_exec_project_promote_item --args '{
  "projectId": "value",
  "taskItemId": "value",
  "assignee": "value"
}'

Parameter	Type	Required	Notes
`projectId`	string	yes	Project ID
`taskItemId`	string	yes	Checklist item ID to promote to a board task
`assignee`	string	no	Agent to assign the task to

bakin-bits-official/plugins/projects/index.ts:692

bakin_exec_project_remove_item Removed project item

Remove a checklist item from a project.

mcporter call bakin-<agent>.bakin_exec_project_remove_item --args '{
  "projectId": "value",
  "taskItemId": "value"
}'

Parameter	Type	Required	Notes
`projectId`	string	yes	Project ID
`taskItemId`	string	yes	Checklist item ID to remove

bakin-bits-official/plugins/projects/index.ts:649

bakin_exec_project_toggle_item Toggled project item

Toggle a checklist item checked/unchecked by item ID. Returns updated progress percentage.

mcporter call bakin-<agent>.bakin_exec_project_toggle_item --args '{
  "projectId": "value",
  "itemId": "value",
  "checked": true
}'

Parameter	Type	Required	Notes
`projectId`	string	yes	Project ID
`itemId`	string	yes	Checklist item ID (e.g., t001)
`checked`	boolean	yes	true to mark as done, false to uncheck

bakin-bits-official/plugins/projects/index.ts:755

bakin_exec_project_update Updated a project

Update a project's title, status, body, or owner. Cannot set status to "completed" if unchecked items remain.

mcporter call bakin-<agent>.bakin_exec_project_update --args '{
  "projectId": "value",
  "title": "value",
  "status": "value",
  "body": "value",
  "owner": "value"
}'

Parameter	Type	Required	Notes
`projectId`	string	yes	Project ID
`title`	string	no	New title
`status`	choice	no	New status
`body`	string	no	New markdown body
`owner`	string	no	New owner

bakin-bits-official/plugins/projects/index.ts:569

bakin_exec_project_update_item Updated project item

Update a checklist item's title and/or description.

mcporter call bakin-<agent>.bakin_exec_project_update_item --args '{
  "projectId": "value",
  "itemId": "value",
  "title": "value",
  "description": "value"
}'

Parameter	Type	Required	Notes
`projectId`	string	yes	Project ID
`itemId`	string	yes	Checklist item ID (e.g., t001)
`title`	string	no	New title for the checklist item
`description`	string	no	New description for the checklist item

bakin-bits-official/plugins/projects/index.ts:776

Schedule

Schedule tools let agents create, inspect, pause, run, and update recurring Bakin jobs.

bakin_exec_schedule_briefing Generated schedule briefing

Today's schedule summary — which jobs fire, assigned agents, alerts. Designed for orchestrator daily briefing.

mcporter call bakin-<agent>.bakin_exec_schedule_briefing --args '{
  "date": "value"
}'

Parameter	Type	Required	Notes
`date`	string	no	ISO date to check (defaults to today)

plugins/schedule/index.ts:1173

bakin_exec_schedule_create Created a scheduled job

Create a new scheduled job that creates tasks on the board

mcporter call bakin-<agent>.bakin_exec_schedule_create --args '{
  "name": "value",
  "schedule": "value",
  "agentId": "value",
  "workflowId": "value",
  "taskPrompt": "value",
  "taskTitle": "value"
}'

Parameter	Type	Required	Notes
`name`	string	yes	Job name (required)
`schedule`	string	yes	Schedule expression: NL ("every day at 9am") or raw cron ("0 9 * * *") (required)
`agentId`	string	no	Agent to assign tasks to
`workflowId`	string	no	Workflow to attach to tasks
`taskPrompt`	string	no	Task description template
`taskTitle`	string	no	Task title template (supports {date}, {agent})

plugins/schedule/index.ts:926

bakin_exec_schedule_delete Deleted a scheduled job

Delete a scheduled job

mcporter call bakin-<agent>.bakin_exec_schedule_delete --args '{
  "jobId": "value"
}'

Parameter	Type	Required	Notes
`jobId`	string	yes	Job ID (required)

plugins/schedule/index.ts:1067

bakin_exec_schedule_get Read schedule details

Get details for a single scheduled job

mcporter call bakin-<agent>.bakin_exec_schedule_get --args '{
  "jobId": "value"
}'

Parameter	Type	Required	Notes
`jobId`	string	yes	Job ID (required)

plugins/schedule/index.ts:1083

bakin_exec_schedule_list Listed scheduled jobs

List all scheduled jobs (merged runtime cron + Bakin view)

mcporter call bakin-<agent>.bakin_exec_schedule_list --args '{
  "filter": "value",
  "agentId": "value"
}'

Parameter	Type	Required	Notes
`filter`	choice	no	Filter by job type
`agentId`	string	no	Filter by assigned agent

plugins/schedule/index.ts:897

bakin_exec_schedule_parse Parsed cron expression

Parse a natural language or raw cron schedule expression

mcporter call bakin-<agent>.bakin_exec_schedule_parse --args '{
  "input": "value"
}'

Parameter	Type	Required	Notes
`input`	string	yes	Schedule expression to parse (required)

plugins/schedule/index.ts:1158

bakin_exec_schedule_pause Paused a scheduled job

Pause, resume, or skip runs for a scheduled job

mcporter call bakin-<agent>.bakin_exec_schedule_pause --args '{
  "jobId": "value",
  "action": "value",
  "pauseUntil": "value",
  "skipN": 20
}'

Parameter	Type	Required	Notes
`jobId`	string	yes	Job ID (required)
`action`	choice	yes	Action to take (required)
`pauseUntil`	string	no	ISO date to auto-resume (for pause action)
`skipN`	number	no	Number of runs to skip (for skip action)

plugins/schedule/index.ts:1017

bakin_exec_schedule_run_now Triggered scheduled job

Trigger an immediate run of a scheduled job

mcporter call bakin-<agent>.bakin_exec_schedule_run_now --args '{
  "jobId": "value"
}'

Parameter	Type	Required	Notes
`jobId`	string	yes	Job ID (required)

plugins/schedule/index.ts:1121

bakin_exec_schedule_runs Listed schedule runs

Get run history for a scheduled job

mcporter call bakin-<agent>.bakin_exec_schedule_runs --args '{
  "jobId": "value",
  "limit": 20
}'

Parameter	Type	Required	Notes
`jobId`	string	yes	Job ID (required)
`limit`	number	no	Max runs to return (default 50)

plugins/schedule/index.ts:1142

bakin_exec_schedule_update Updated a scheduled job

Update an existing scheduled job

mcporter call bakin-<agent>.bakin_exec_schedule_update --args '{
  "jobId": "value",
  "name": "value",
  "schedule": "value",
  "agentId": "value",
  "workflowId": "value",
  "taskPrompt": "value",
  "taskTitle": "value"
}'

Parameter	Type	Required	Notes
`jobId`	string	yes	Job ID (required)
`name`	string	no	New job name
`schedule`	string	no	New schedule expression
`agentId`	string	no	New agent assignment
`workflowId`	string	no	New workflow binding
`taskPrompt`	string	no	New task prompt template
`taskTitle`	string	no	New task title template

plugins/schedule/index.ts:979

Search

Search tools query Bakin-indexed content across plugins or inside a specific surface.

bakin_exec_search_facets Search facets

Get facet value counts for a plugin. Useful for understanding data distribution (e.g., how many tasks per status).

mcporter call bakin-<agent>.bakin_exec_search_facets --args '{
  "plugin": "value",
  "facets": "value"
}'

Parameter	Type	Required	Notes
`plugin`	string	yes	Plugin id (tasks, assets, projects, etc.)
`facets`	string	yes	Comma-separated facet fields (e.g., "status,agent")

scripts/lib/search-tools.ts:158

bakin_exec_search_lookup Search lookup

Look up a specific indexed document by its key and plugin.

mcporter call bakin-<agent>.bakin_exec_search_lookup --args '{
  "plugin": "value",
  "key": "value"
}'

Parameter	Type	Required	Notes
`plugin`	string	yes	Plugin id (tasks, assets, projects, etc.)
`key`	string	yes	Document key to look up

scripts/lib/search-tools.ts:126

bakin_exec_search_query Search

Search across all Bakin content (tasks, assets, projects, workflows, schedule, team, memory, messaging) or a specific plugin. Returns ranked results with scores.

mcporter call bakin-<agent>.bakin_exec_search_query --args '{
  "q": "value",
  "limit": 20,
  "offset": 20
}'

Parameter	Type	Required	Notes
`q`	string	no	Search query text
`limit`	number	no	Maximum results to return (default: 20)
`offset`	number	no	Skip this many results (for pagination)

scripts/lib/search-tools.ts:48

bakin_exec_search_reindex Reindex search

Trigger a full reindex of all content types (or a specific plugin). Use after bulk data changes.

mcporter call bakin-<agent>.bakin_exec_search_reindex --args '{
  "plugin": "value",
  "rebuild": true,
  "verify": true
}'

Parameter	Type	Required	Notes
`plugin`	string	no	Specific plugin id to reindex (optional — omit for all)
`rebuild`	boolean	no	Drop and recreate indexes before reindexing (default: false)
`verify`	boolean	no	Re-query tables after reindex to verify doc counts (default: false)

scripts/lib/search-tools.ts:221

bakin_exec_search_similar Find similar

Find documents similar to a given text description. Uses semantic (vector) search for meaning-based matching.

mcporter call bakin-<agent>.bakin_exec_search_similar --args '{
  "text": "value",
  "plugin": "value",
  "limit": 20
}'

Parameter	Type	Required	Notes
`text`	string	yes	Text to find similar documents for
`plugin`	string	no	Limit to a specific plugin id (optional)
`limit`	number	no	Maximum results (default: 10)

scripts/lib/search-tools.ts:187

bakin_exec_search_stats Search stats

Get search system health: enabled status, per-table document counts, and index stats.

mcporter call bakin-<agent>.bakin_exec_search_stats

scripts/lib/search-tools.ts:256

bakin_exec_search_table Search plugin

Search a specific Bakin plugin with facet filtering. Returns results plus facet counts for filtering.

mcporter call bakin-<agent>.bakin_exec_search_table --args '{
  "q": "value",
  "limit": 20
}'

Parameter	Type	Required	Notes
`q`	string	no	Search query text
`limit`	number	no	Maximum results (default: 20)

scripts/lib/search-tools.ts:90

Submit

Workflow submission tools let agents submit step output back to the workflow engine.

bakin_exec_submit_step Submitted workflow step

Submit workflow step output with local pre-validation. Validates against the step schema BEFORE hitting the server, giving you detailed field-level errors without a round trip.

mcporter call bakin-<agent>.bakin_exec_submit_step --args '{
  "taskId": "value",
  "stepId": "value",
  "output": {
    "key": "value"
  }
}'

Parameter	Type	Required	Notes
`taskId`	string	yes	Task ID
`stepId`	string	yes	Step ID to submit for
`output`	record	yes	JSON output matching the step schema

plugins/workflows/index.ts:1668

Tasks

Task tools are the main agent interface for creating, reading, moving, logging, blocking, and completing work.

bakin_exec_tasks_assign Assigned a task

Assign a task to an agent.

mcporter call bakin-<agent>.bakin_exec_tasks_assign --args '{
  "taskId": "value",
  "agent": "value"
}'

Parameter	Type	Required	Notes
`taskId`	string	yes	Task ID
`agent`	string	yes	Agent to assign the task to

plugins/tasks/index.ts:792

bakin_exec_tasks_block Blocked a task

Mark a task as blocked with a reason. Use when you cannot proceed.

mcporter call bakin-<agent>.bakin_exec_tasks_block --args '{
  "taskId": "value",
  "reason": "value"
}'

Parameter	Type	Required	Notes
`taskId`	string	yes	Task ID
`reason`	string	yes	Why the task is blocked

plugins/tasks/index.ts:663

bakin_exec_tasks_complete Completed a task

Report that your task is complete. Moves the task to Done and notifies the orchestrator.

mcporter call bakin-<agent>.bakin_exec_tasks_complete --args '{
  "taskId": "value",
  "summary": "value"
}'

Parameter	Type	Required	Notes
`taskId`	string	yes	Task ID
`summary`	string	yes	Summary of what you accomplished

plugins/tasks/index.ts:683

bakin_exec_tasks_create Created a task

Create a new task on the task board. Workflows are auto-matched by title when workflowId is not provided. Provide workflowId to force a specific workflow, or skipWorkflowReason to explicitly skip.

mcporter call bakin-<agent>.bakin_exec_tasks_create --args '{
  "title": "value",
  "assignee": "value",
  "description": "value",
  "parentId": "value",
  "workflowId": "value",
  "skipWorkflowReason": "value",
  "projectId": "value"
}'

Parameter	Type	Required	Notes
`title`	string	yes	Task title
`assignee`	string	no	Agent to assign (basil, pixel, rolo, patch, nemo, etc.)
`description`	string	no	Task description and context
`parentId`	string	no	Parent task ID if this is a subtask
`workflowId`	string	no	Workflow to start (e.g. image-social-post, video-script). Use bakin_exec_workflows_list to see options.
`skipWorkflowReason`	string	no	Reason no workflow applies (required if workflowId is not set and this is not a subtask)
`projectId`	string	no	Project ID to link this task to

plugins/tasks/index.ts:593

bakin_exec_tasks_delete Deleted a task

Delete a task from the board.

mcporter call bakin-<agent>.bakin_exec_tasks_delete --args '{
  "taskId": "value"
}'

Parameter	Type	Required	Notes
`taskId`	string	yes	Task ID

plugins/tasks/index.ts:771

bakin_exec_tasks_get Read task details

Get details about a task — title, description, current column, logs, dependencies, project context.

mcporter call bakin-<agent>.bakin_exec_tasks_get --args '{
  "taskId": "value"
}'

Parameter	Type	Required	Notes
`taskId`	string	yes	Task ID

plugins/tasks/index.ts:570

bakin_exec_tasks_list Listed tasks

List all tasks on the board. Optionally filter by column or agent.

mcporter call bakin-<agent>.bakin_exec_tasks_list --args '{
  "column": "value",
  "agent": "value"
}'

Parameter	Type	Required	Notes
`column`	choice	no	Filter by column
`agent`	string	no	Filter by assigned agent

plugins/tasks/index.ts:540

bakin_exec_tasks_log_progress Logged progress

Log a human-readable progress update to the live activity feed. Call this at every significant step.

mcporter call bakin-<agent>.bakin_exec_tasks_log_progress --args '{
  "taskId": "value",
  "message": "value"
}'

Parameter	Type	Required	Notes
`taskId`	string	yes	Task ID (e.g. "fe84ac51")
`message`	string	yes	Human-readable status update

plugins/tasks/index.ts:703

bakin_exec_tasks_move Moved a task

Move a task to a different column on the task board.

mcporter call bakin-<agent>.bakin_exec_tasks_move --args '{
  "taskId": "value",
  "to": "value",
  "reason": "value"
}'

Parameter	Type	Required	Notes
`taskId`	string	yes	Task ID
`to`	choice	yes	Target column
`reason`	string	no	Required when moving to "blocked"

plugins/tasks/index.ts:638

bakin_exec_tasks_set_dependency Set task dependency

Register a dependency between tasks. Your task will be auto-re-dispatched when the dependency completes. After registering, exit — do not wait.

mcporter call bakin-<agent>.bakin_exec_tasks_set_dependency --args '{
  "taskId": "value",
  "dependsOn": "value"
}'

Parameter	Type	Required	Notes
`taskId`	string	yes	Your task ID (the one that depends)
`dependsOn`	string	yes	Task ID you depend on

plugins/tasks/index.ts:722

bakin_exec_tasks_update Updated a task

Update a task on the board — change title, description, or assigned agent.

mcporter call bakin-<agent>.bakin_exec_tasks_update --args '{
  "taskId": "value",
  "title": "value",
  "description": "value",
  "agent": "value"
}'

Parameter	Type	Required	Notes
`taskId`	string	yes	Task ID
`title`	string	no	New task title
`description`	string	no	New task description
`agent`	string	no	New assigned agent

plugins/tasks/index.ts:741

Team

Team tools expose agent roster, identity, status, messaging, and permission operations.

bakin_exec_team_create_agent Created agent

Create a new agent: registers it with the active runtime, writes persona files, configures dispatch permissions, optionally assigns it to a team. Returns next-step instructions.

mcporter call bakin-<agent>.bakin_exec_team_create_agent --args '{
  "id": "value",
  "name": "value",
  "emoji": "value",
  "role": "value",
  "vibe": "value",
  "primaryFunction": "value",
  "defaultMode": "value",
  "model": "value",
  "soul": "value",
  "tools": "value",
  "teamId": "value",
  "dispatchable": "value"
}'

Parameter	Type	Required	Notes
`id`	string	no	Agent ID (lowercase alphanumeric + hyphens). Auto-derived from name if omitted.
`name`	string	yes	Display name (e.g. "Jessica Fetcher")
`emoji`	string	no	Single emoji (e.g. "🔎")
`role`	string	no	One-line role description
`vibe`	string	no	Personality vibe
`primaryFunction`	string	no	What the agent does
`defaultMode`	string	no	How the agent operates by default
`model`	string	no	Full provider/model string. Uses default if omitted.
`soul`	string	no	Raw markdown for SOUL.md
`tools`	string	no	Raw markdown for TOOLS.md
`teamId`	string	no	Bakin team to assign the agent to
`dispatchable`	union	no	Who can dispatch tasks to this agent. Default: "main".

plugins/team/index.ts:1954

bakin_exec_team_delete_agent Deleted agent

Remove an agent from the active runtime and clean up Bakin state. Requires confirm=true as a safety guard.

mcporter call bakin-<agent>.bakin_exec_team_delete_agent --args '{
  "agentId": "value",
  "confirm": true
}'

Parameter	Type	Required	Notes
`agentId`	string	yes	Agent to delete
`confirm`	boolean	yes	Must be true — safety guard against accidental deletion

plugins/team/index.ts:2064

bakin_exec_team_list Listed team

List all agents with their current status (online/working/available/offline).

mcporter call bakin-<agent>.bakin_exec_team_list

plugins/team/index.ts:1771

bakin_exec_team_members Listed team members

Get agents that belong to a specific team (e.g. "builders", "creators").

mcporter call bakin-<agent>.bakin_exec_team_members --args '{
  "teamId": "value"
}'

Parameter	Type	Required	Notes
`teamId`	string	yes	Team ID (e.g. "builders", "creators")

plugins/team/index.ts:1909

bakin_exec_team_message Sent a message

Send a message to an agent via the active runtime.

mcporter call bakin-<agent>.bakin_exec_team_message --args '{
  "agentId": "value",
  "message": "value"
}'

Parameter	Type	Required	Notes
`agentId`	string	yes	Agent ID
`message`	string	yes	Message to send

plugins/team/index.ts:1885

bakin_exec_team_my_team Read own team

Get the team that a specific agent belongs to, including all teammates.

mcporter call bakin-<agent>.bakin_exec_team_my_team --args '{
  "agentId": "value"
}'

Parameter	Type	Required	Notes
`agentId`	string	yes	Agent ID

plugins/team/index.ts:1928

bakin_exec_team_org Read organization

Get the full org structure: teams with their members. Use this to understand who is on which team and reporting lines.

mcporter call bakin-<agent>.bakin_exec_team_org

plugins/team/index.ts:1899

bakin_exec_team_profile Read agent profile

Get the full profile for an agent including soul, rules, and tools.

mcporter call bakin-<agent>.bakin_exec_team_profile --args '{
  "agentId": "value"
}'

Parameter	Type	Required	Notes
`agentId`	string	yes	Agent ID

plugins/team/index.ts:1791

bakin_exec_team_read_file Read agent file

Read a workspace file for an agent (e.g., SOUL.md, AGENTS.md, TOOLS.md).

mcporter call bakin-<agent>.bakin_exec_team_read_file --args '{
  "agentId": "value",
  "filename": "value"
}'

Parameter	Type	Required	Notes
`agentId`	string	yes	Agent ID
`filename`	string	yes	File name (e.g., SOUL.md)

plugins/team/index.ts:1870

bakin_exec_team_set_permissions Updated permissions

Update dispatch permissions — which agents a given agent can dispatch tasks to (subagents.allowAgents).

mcporter call bakin-<agent>.bakin_exec_team_set_permissions --args '{
  "agentId": "value",
  "allowAgents": [
    "value"
  ]
}'

Parameter	Type	Required	Notes
`agentId`	string	yes	Agent whose allowAgents to modify
`allowAgents`	array	yes	Full replacement list of agent IDs this agent can dispatch to

plugins/team/index.ts:2109

bakin_exec_team_status Checked agent status

Get the heartbeat and health status for an agent.

mcporter call bakin-<agent>.bakin_exec_team_status --args '{
  "agentId": "value"
}'

Parameter	Type	Required	Notes
`agentId`	string	yes	Agent ID

plugins/team/index.ts:1805

bakin_exec_team_update_identity Updated agent identity

Update an existing agent's identity fields (name, emoji, role, vibe, etc.) and/or workspace files (SOUL.md, TOOLS.md).

mcporter call bakin-<agent>.bakin_exec_team_update_identity --args '{
  "agentId": "value",
  "name": "value",
  "emoji": "value",
  "role": "value",
  "vibe": "value",
  "primaryFunction": "value",
  "defaultMode": "value",
  "soul": "value",
  "tools": "value"
}'

Parameter	Type	Required	Notes
`agentId`	string	yes	Target agent ID
`name`	string	no	New display name
`emoji`	string	no	New emoji
`role`	string	no	Updated role
`vibe`	string	no	Updated vibe
`primaryFunction`	string	no	Updated primary function
`defaultMode`	string	no	Updated default mode
`soul`	string	no	Replace SOUL.md content
`tools`	string	no	Replace TOOLS.md content

plugins/team/index.ts:2029

Workflows

Workflow tools expose workflow definitions, active instances, current steps, and step completion.

bakin_exec_workflows_complete_step Completed workflow step

Complete a workflow step with output. Validates output against the step schema, advances the workflow to the next step. Returns success status and whether the workflow is complete.

mcporter call bakin-<agent>.bakin_exec_workflows_complete_step --args '{
  "taskId": "value",
  "stepId": "value",
  "output": {
    "key": "value"
  }
}'

Parameter	Type	Required	Notes
`taskId`	string	yes	Task ID
`stepId`	string	yes	Step ID to complete
`output`	record	yes	Step output object

plugins/workflows/index.ts:1612

bakin_exec_workflows_get_definition Read workflow definition

Get a workflow definition by filename. Returns the full definition with steps, inputs, and resolved sub-workflows.

mcporter call bakin-<agent>.bakin_exec_workflows_get_definition --args '{
  "name": "value"
}'

Parameter	Type	Required	Notes
`name`	string	yes	Workflow definition filename (e.g. "content-pipeline")

plugins/workflows/index.ts:1518

bakin_exec_workflows_get_instance Read workflow instance

Get the full state of a workflow instance for a task, including step states and history.

mcporter call bakin-<agent>.bakin_exec_workflows_get_instance --args '{
  "taskId": "value"
}'

Parameter	Type	Required	Notes
`taskId`	string	yes	Task ID

plugins/workflows/index.ts:1584

bakin_exec_workflows_get_step Read workflow step

Get the current workflow step for a task. Returns only the current step (information gating — future steps are hidden). Critical for agents to know what to do next.

mcporter call bakin-<agent>.bakin_exec_workflows_get_step --args '{
  "taskId": "value"
}'

Parameter	Type	Required	Notes
`taskId`	string	yes	Task ID

plugins/workflows/index.ts:1598

bakin_exec_workflows_list Listed workflows

List all workflow definitions (templates). Returns name, filename, description, and step count for each.

mcporter call bakin-<agent>.bakin_exec_workflows_list

plugins/workflows/index.ts:1499

bakin_exec_workflows_list_instances Listed workflow runs

List workflow instances. Optionally filter by status (in_progress, pending_approval, complete, failed, cancelled).

mcporter call bakin-<agent>.bakin_exec_workflows_list_instances --args '{
  "status": "value"
}'

Parameter	Type	Required	Notes
`status`	choice	no	Filter by instance status

plugins/workflows/index.ts:1571

bakin_exec_workflows_start Started a workflow

Start a workflow instance for a task. The task must exist on the board. Returns the created instance.

mcporter call bakin-<agent>.bakin_exec_workflows_start --args '{
  "taskId": "value",
  "workflowId": "value"
}'

Parameter	Type	Required	Notes
`taskId`	string	yes	Task ID to start workflow for
`workflowId`	string	yes	Workflow definition filename

plugins/workflows/index.ts:1536