MCP Tools

Vyasa exposes 86 tools over the Model Context Protocol. Tools are grouped by family below — each page carries its family's guide link, a parameter table, the return type, and a call shape.

Sessions

one bounded sitting of governed work — start, end, resume, inspect. Guide: Sessions.

Tool	Description
session_end	End a Vyasa session.
session_kind_vars	Record structure-kind path-template variables for a session.
session_list	List all sessions.
session_note	Write an agent-owned work note onto a session.
session_park	Park a session on a system issue (stays within TTL; resume later).
session_purge	Purge old ended sessions.
session_refresh	Refresh session TTL.
session_resume	Clear a parked session so the assistant can be re-invoked.
session_start	Start a new Vyasa session.
session_stats	Get apply statistics.
session_status	Get session lock status.

Governance

standing laws, secret patterns, fetched packs. Guide: Governance.

Tool	Description
governance_fetch	FETCH a governance rule pack over a connection (its rules CHECK the work).
governance_list	List governance rules (rules that CHECK the work).
governance_remove	Remove a governance source.
governance_rule_disable	Keep an inline governance rule without enforcing it.
governance_rule_enable	Enforce an inline governance rule (drops its enabled: False).
governance_rules_add	Add an inline governance rule (rules CHECK the work).
governance_rules_list	List inline governance rules (rules that CHECK the work).
governance_rules_remove	Remove an inline governance rule.
governance_update	Update linked governance sources.
governance_use	Link a rule pack so its rules CHECK the work (via a FETCH connection).

Nodes

atomic pieces of work and their relations. Guide: Nodes.

Tool	Description
node_create	Create a node.
node_link	Link a node to a parent.
node_list	List nodes.
node_note	Write an agent-owned work note onto a node.
node_set_depends	Set node dependencies.
node_show	Show a node.
node_supersede	Supersede a node.

Assistants

declare, launch, and track AI workers. Guide: Assistants.

Tool	Description
assistant_add	Register a coding assistant.
assistant_info	Show coding assistant details.
assistant_list	List coding assistants.
assistant_remove	Remove a coding assistant.
assistant_session	Record a coding assistant's real session ID.
assistant_set_active	Set the active coding assistant.
assistant_use	Launch a coding assistant.

Gates

human decisions before work advances. Guide: Gates.

Tool	Description
gate_approve	Approve a node gate (accept_guard = accept developer-marked expected out-of-scope changes).
gate_list	List gates.
gate_obsolete	Mark a gate as obsolete.
gate_reject	Reject a node gate.
gate_run	Evaluate gates for a node.

Workflows

template inspection, validation, enable/disable. Guide: Workflows.

Tool	Description
workflow_item_disable	Disable a workflow item (stage, node type, skill, gate, tool, verification, kind, or workflow via meta).
workflow_item_enable	Enable a workflow item (stage, node type, skill, gate, tool, verification, kind, or workflow via meta).
workflow_list	List installed workflow templates.
workflow_show	Show workflow details.
workflow_validate	Validate workflow template(s).

Violations

rule breaks recorded per node, with resolution. Guide: Violations.

Tool	Description
violations_list	List violation IDs.
violations_report	Generate violations report.
violations_resolve	Resolve a violation.
violations_show	Show a violation.

Checklists

the grading rubrics scoring consumes. Guide: Checklists.

Tool	Description
checklist_add	Add a checklist item.
checklist_list	List scoring checklist items.
checklist_remove	Remove a checklist item.
checklist_update	Update a checklist item.

Sub-nodes

decomposed leaves under a node instance. Guide: Sub-nodes.

Tool	Description
sub_node_add	Add a sub-node.
sub_node_list	List sub-nodes.
sub_node_show	Show a sub-node.

Apply

promote staged work or roll it back. Guide: Apply.

Tool	Description
apply_approve	Approve and apply a session proposal.
apply_preview	Preview what apply would do.
apply_reject	Reject and archive a session proposal.

Scoring

grade work against checklists, machine + human. Guide: Scoring.

Tool	Description
score_retry	Retry scoring.
score_run	Run scoring on a session.
score_status	Show score status.

Connections

verified transports that fetch governance packs. Guide: Connections.

Tool	Description
connections_add	Add a data connection.
connections_list	List governance transports (how rule packs are FETCHED).
connections_remove	Remove a data connection.

Appendages

worker equipment staged via stages. Guide: Appendages.

Tool	Description
appendage_add	Add a builder appendage (agent tools DO the work).
appendage_list	List builder appendages (section: tools|mcps|apis|clis|sdks) — tools the agent uses to DO the work.
appendage_remove	Remove a builder appendage (tools the agent uses to DO the work).

Lessons

carry prior-session notes forward. Guide: Lessons.

Tool	Description
lesson_add	Log a lesson.
lesson_list	List lessons.
lesson_resolve	Resolve a lesson.

Sandbox

isolation levels for tool execution. Guide: Sandbox.

Tool	Description
sandbox_setup	Generate sandbox hook scripts.
sandbox_status	Show host sandbox capabilities.

State

timeline reads over project history. Guide: State.

Tool	Description
state_log	Show state timeline log.
state_show	Show a state entry.

Review

human verdicts on proposals. Guide: Review.

Tool	Description
review_diff	Show diff for a proposal.
review_list	List proposals pending review.

Guards

real-time interdiction on worker calls. Guide: Guards.

Tool	Description
guard_audit	Run guard MD5 audit.

Files

scoped reads/writes inside the guardrail card. Guide: Files.

Tool	Description
file_read	Read a file from the project (guarded).

Project utilities

init, validate, sync, regenerate, doctor, tree, version. Guide: Project utilities.

Tool	Description
doctor	Run project health checks.
init	Initialize a new Vyasa project (tier/structure-packs/git like the CLI).
regenerate	Regenerate project assets.
sync	Sync project with remote.
tree	Render the project tree.
validate	Validate project config or a session proposal.
version	Show Vyasa version.

info

MCP reference pages are auto-generated from the Vyasa source via AST extraction. Run python tools/gen_mcp.py to regenerate.