Skip to main content

MCP tool catalog

Generated from crates/versionx-mcp/src/tools/. Workflow-shaped; tool count capped at ~10.

Summary​

ToolMutatingPurpose
bump_proposenoPropose version bumps
changelog_draftyesDraft a voice-aware changelog section
config_readnoRead versionx.toml
policy_checknoEvaluate policies
release_applyyesApply an approved release plan
release_proposeyesPropose a release plan
state_readnoRead persisted state
workspace_graphnoDependency graph
workspace_listnoList workspace components
workspace_statusnoWorkspace change state

Per-tool detail​

bump_propose​

Propose version bumps

Compute per-component bump levels from content-hash deltas vs. the lockfile baselines. Does not mutate disk. Use release_propose for the fuller plan artifact.

changelog_draft​

Draft a voice-aware changelog section

Use a configured BYO-API-key provider to draft a CHANGELOG section for the next release, matching the repo's prior voice. Does not commit — the draft is returned + written to .versionx/mcp/.

config_read​

Read versionx.toml

Return the contents of the workspace's versionx.toml. Treated as trusted (first-party config), but still fenced to keep downstream models consistent about provenance.

policy_check​

Evaluate policies

Load every policy under .versionx/policies/ and evaluate against the current workspace state. Returns findings grouped by severity with waiver hits resolved.

release_apply​

Apply an approved release plan

Apply a previously-proposed plan: write versions to manifests, refresh the lockfile, create release commit + tags. Requires an explicit plan_id — no auto-select. Set approve = true to approve in-place if the plan isn't yet approved.

release_propose​

Propose a release plan

Build a release plan from content-hash diffs + optional commit messages. Persists to .versionx/plans/<id>.toml. Unapproved — must be approved by a human (or the release_apply caller) before landing.

state_read​

Read persisted state

Summarize the workspace's on-disk state: lockfile, release plans, policy lockfile. Returns paths + parsed contents for the files that exist.

workspace_graph​

Dependency graph

Intra-workspace dependency DAG. Returns every node, every edge (from → to), and a topological order (leaves first) safe for release iteration.

workspace_list​

List workspace components

Discover every component (Node package, Rust crate, Python project, declared asset bundle, …) under the workspace root. Returns ids, kinds, versions, and intra-workspace dependency edges.

workspace_status​

Workspace change state

For every component, compute the BLAKE3 content hash and compare to the last-released hash in versionx.lock. Returns dirty/clean + transitive cascade of dependents that would need to re-release.

See also​