MCP

Updated May 28, 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:835

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:750

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:1011

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:633

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:776

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:616

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:798

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:663

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:1025

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:818

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:965

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, or an existing managed assets/store/... path to return idempotently
`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:724

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:987

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:1877

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:342

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:1801

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:513

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:484

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:1824

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_deliverable_approve Approved content deliverable

Approve a Deliverable after review.

mcporter call bakin-<agent>.bakin_exec_messaging_deliverable_approve --args '{
  "deliverableId": "value"
}'

Parameter	Type	Required	Notes
`deliverableId`	string	yes	Deliverable ID (required)

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

bakin_exec_messaging_deliverable_create Created content deliverable

Create a Quick Post Deliverable. Plan Deliverables are created only by Plan activation.

mcporter call bakin-<agent>.bakin_exec_messaging_deliverable_create --args '{
  "planId": "value",
  "channel": "value",
  "contentType": "value",
  "tone": "value",
  "agent": "value",
  "title": "value",
  "brief": "value",
  "publishAt": "value",
  "prepStartAt": "value",
  "prepStartAtOverride": "value",
  "status": "value",
  "draft": {
    "key": "value"
  }
}'

Parameter	Type	Required	Notes
`planId`	union	no	Optional Plan ID; null creates a Quick Post
`channel`	string	yes	Runtime channel ID
`contentType`	string	yes	Messaging content type ID
`tone`	string	yes	Tone
`agent`	string	yes	Prep agent
`title`	string	yes	Deliverable title
`brief`	string	yes	Deliverable brief
`publishAt`	string	yes	Publish datetime
`prepStartAt`	string	no	Optional explicit prep start datetime
`prepStartAtOverride`	string	no	Optional prep start override datetime
`status`	string	no	Optional initial status; defaults to planned
`draft`	object	no	Optional draft fields

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

bakin_exec_messaging_deliverable_get Read content deliverable

Get a content Deliverable

mcporter call bakin-<agent>.bakin_exec_messaging_deliverable_get --args '{
  "deliverableId": "value"
}'

Parameter	Type	Required	Notes
`deliverableId`	string	yes	Deliverable ID (required)

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

bakin_exec_messaging_deliverable_list Listed content deliverables

List content Deliverables with optional filters

mcporter call bakin-<agent>.bakin_exec_messaging_deliverable_list --args '{
  "planId": "value",
  "status": "value",
  "channel": "value",
  "publishAfter": "value",
  "publishBefore": "value"
}'

Parameter	Type	Required	Notes
`planId`	union	no	Filter by Plan ID; null returns Quick Posts
`status`	string	no	Filter by Deliverable status
`channel`	string	no	Filter by channel
`publishAfter`	string	no	Filter by publishAt at or after this date
`publishBefore`	string	no	Filter by publishAt at or before this date

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

bakin_exec_messaging_deliverable_ready_for_review Marked content deliverable ready for review

Signal that a bare-task Deliverable draft is ready for user review or auto-approval.

mcporter call bakin-<agent>.bakin_exec_messaging_deliverable_ready_for_review --args '{
  "deliverableId": "value"
}'

Parameter	Type	Required	Notes
`deliverableId`	string	yes	Deliverable ID (required)

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

bakin_exec_messaging_deliverable_reject Rejected content deliverable

Request changes for a Deliverable after review.

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

Parameter	Type	Required	Notes
`deliverableId`	string	yes	Deliverable ID (required)
`note`	string	no	Review note for the prep agent

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

bakin_exec_messaging_deliverable_update Updated content deliverable

Update a content Deliverable. Draft fields are deep-merged.

mcporter call bakin-<agent>.bakin_exec_messaging_deliverable_update --args '{
  "deliverableId": "value",
  "planId": "value",
  "channel": "value",
  "contentType": "value",
  "tone": "value",
  "agent": "value",
  "title": "value",
  "brief": "value",
  "publishAt": "value",
  "prepStartAt": "value",
  "prepStartAtOverride": "value",
  "status": "value",
  "rejectionNote": "value",
  "draft": {
    "key": "value"
  }
}'

Parameter	Type	Required	Notes
`deliverableId`	string	yes	Deliverable ID (required)
`planId`	union	no	Optional Plan ID; null makes it a Quick Post
`channel`	string	no	Runtime channel ID
`contentType`	string	no	Messaging content type ID
`tone`	string	no	Tone
`agent`	string	no	Prep agent
`title`	string	no	Deliverable title
`brief`	string	no	Deliverable brief
`publishAt`	string	no	Publish datetime
`prepStartAt`	string	no	Optional explicit prep start datetime
`prepStartAtOverride`	string	no	Optional prep start override datetime
`status`	string	no	Deliverable status
`rejectionNote`	string	no	Optional rejection note
`draft`	object	no	Draft fields to deep-merge

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

bakin_exec_messaging_plan_activate Activated content plan

Activate a content Plan and create scheduled kickoff tasks for its configured channels.

mcporter call bakin-<agent>.bakin_exec_messaging_plan_activate --args '{
  "planId": "value"
}'

Parameter	Type	Required	Notes
`planId`	string	yes	Plan ID (required)

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

bakin_exec_messaging_plan_channel_delete Deleted content plan channel

Delete one configured Plan channel, its Deliverables, and linked board tasks.

mcporter call bakin-<agent>.bakin_exec_messaging_plan_channel_delete --args '{
  "planId": "value",
  "channelId": "value",
  "deleteLinkedTasks": true
}'

Parameter	Type	Required	Notes
`planId`	string	yes	Plan ID (required)
`channelId`	string	yes	Plan channel ID (required)
`deleteLinkedTasks`	boolean	no	Delete linked board tasks; defaults to true

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

bakin_exec_messaging_plan_create Created content plan

Create a content Plan

mcporter call bakin-<agent>.bakin_exec_messaging_plan_create --args '{
  "title": "value",
  "targetDate": "value",
  "agent": "value",
  "brief": "value",
  "campaign": "value",
  "channels": [
    "value"
  ],
  "id": "value",
  "channel": "value",
  "contentType": "value",
  "publishAt": "value",
  "prepStartAt": "value",
  "workflowId": "value",
  "tone": "value"
}'

Parameter	Type	Required	Notes
`title`	string	yes	Plan title
`targetDate`	string	yes	Target ISO date
`agent`	string	yes	Lead agent
`brief`	string	no	Plan brief
`campaign`	string	no	Campaign tag
`channels`	array	yes
`id`	string	no
`channel`	string	yes
`contentType`	string	yes
`publishAt`	string	yes
`prepStartAt`	string	no
`workflowId`	string	no
`agent`	string	no
`tone`	string	no
`title`	string	no
`brief`	string	no	Concrete channel deliverables to create when the Plan is activated

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

bakin_exec_messaging_plan_delete Deleted content plan

Delete a content Plan, its content pieces, and linked board tasks.

mcporter call bakin-<agent>.bakin_exec_messaging_plan_delete --args '{
  "planId": "value",
  "deleteLinkedTasks": true
}'

Parameter	Type	Required	Notes
`planId`	string	yes	Plan ID (required)
`deleteLinkedTasks`	boolean	no	Delete linked board tasks; defaults to true

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

bakin_exec_messaging_plan_get Read content plan

Get a content Plan and its Deliverables

mcporter call bakin-<agent>.bakin_exec_messaging_plan_get --args '{
  "planId": "value"
}'

Parameter	Type	Required	Notes
`planId`	string	yes	Plan ID (required)

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

bakin_exec_messaging_plan_list Listed content plans

List content Plans with optional filters

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

Parameter	Type	Required	Notes
`status`	string	no	Filter by Plan status
`agent`	string	no	Filter by lead agent
`campaign`	string	no	Filter by campaign

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

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",
  "targetDate": "value",
  "suggestedChannels": [
    "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
`targetDate`	string	no	Updated Plan target date
`suggestedChannels`	array	no	Updated suggested channels
`rejectionNote`	string	no	Note explaining rejection

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

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",
  "scope": "value"
}'

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

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

bakin_exec_messaging_session_delete Deleted brainstorm session

Delete a planning session without deleting Plans prepared from it.

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:2140

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:2079

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, archived)
`agentId`	string	no	Filter by agent ID

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

bakin_exec_messaging_session_materialize Prepared Plans from brainstorm proposals

Prepare Plans from accepted brainstorm proposals

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

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

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

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:2158

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, archived)

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

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:745

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:726

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:121

Projects

MCP tools discovered from registered exec tool definitions.

bakin_exec_projects_add_item Added project item

Add a new checklist item to a project.

mcporter call bakin-<agent>.bakin_exec_projects_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:740

bakin_exec_projects_apply_plan Applied a project plan

Apply a confirmed project plan update in one operation. Use this after the user confirms exact body/checklist changes so agents do not need shell scripts or multiple low-level calls.

mcporter call bakin-<agent>.bakin_exec_projects_apply_plan --args '{
  "projectId": "value",
  "title": "value",
  "status": "value",
  "body": "value",
  "appendBody": "value",
  "owner": "value",
  "checklistItems": [
    "value"
  ]
}'

Parameter	Type	Required	Notes
`projectId`	string	yes	Project ID
`title`	string	no	Optional new project title
`status`	choice	no	Optional new status
`body`	string	no	Replacement markdown body for the project plan
`appendBody`	string	no	Markdown to append to the existing project body; cannot be combined with body
`owner`	string	no	Optional new owner
`checklistItems`	array	no	New unchecked checklist item titles to append

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

bakin_exec_projects_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_projects_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:930

bakin_exec_projects_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 projects_get — use asset tools to read full content when needed.

mcporter call bakin-<agent>.bakin_exec_projects_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:842

bakin_exec_projects_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_projects_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:642

bakin_exec_projects_delete Deleted a project

Delete a project by ID.

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

Parameter	Type	Required	Notes
`projectId`	string	yes	Project ID

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

bakin_exec_projects_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_projects_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:862

bakin_exec_projects_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_projects_get --args '{
  "projectId": "value"
}'

Parameter	Type	Required	Notes
`projectId`	string	yes	Project ID

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

bakin_exec_projects_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_projects_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:794

bakin_exec_projects_list Listed projects

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

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

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

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

bakin_exec_projects_mark_item Marked project item

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

mcporter call bakin-<agent>.bakin_exec_projects_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:755

bakin_exec_projects_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_projects_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:818

bakin_exec_projects_remove_item Removed project item

Remove a checklist item from a project.

mcporter call bakin-<agent>.bakin_exec_projects_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:775

bakin_exec_projects_toggle_item Toggled project item

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

mcporter call bakin-<agent>.bakin_exec_projects_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:881

bakin_exec_projects_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_projects_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:664

bakin_exec_projects_update_item Updated project item

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

mcporter call bakin-<agent>.bakin_exec_projects_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:902

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:1390

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:1142

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:1286

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:1300

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:1113

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:1375

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:1236

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:1338

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:1359

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:1195

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:1821

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:849

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:711

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:731

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",
  "availableAt": "value",
  "dueAt": "value",
  "sourcePluginId": "value",
  "sourceEntityType": "value",
  "sourceEntityId": "value",
  "sourcePurpose": "value"
}'

Parameter	Type	Required	Notes
`title`	string	yes	Task title
`assignee`	string	no	Agent to assign (chef, pixel, rolo, patch, trainer, 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
`availableAt`	string	no	ISO timestamp before which dispatch should not pick up the task
`dueAt`	string	no	ISO timestamp representing the task deadline or target delivery time
`sourcePluginId`	string	no	Plugin that owns the source entity for this task
`sourceEntityType`	string	no	Source entity type, such as plan or deliverable
`sourceEntityId`	string	no	Source entity ID
`sourcePurpose`	string	no	Source purpose, such as kickoff or publish

plugins/tasks/index.ts:626

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:828

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:603

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:573

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:751

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:686

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:770

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",
  "availableAt": "value",
  "dueAt": "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
`availableAt`	string	no	ISO timestamp before which dispatch should not pick up the task
`dueAt`	string	no	ISO timestamp representing the task deadline or target delivery time

plugins/tasks/index.ts:789

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")
`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:1958

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:2068

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:1775

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:1913

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:1889

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:1932

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:1903

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:1795

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:1874

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:2113

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:1809

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:2033

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:1765

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:1671

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:1737

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:1751

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:1652

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:1724

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:1689