vox-orchestrator-mcp API Reference (generated)

`vox-orchestrator-mcp`

Crate: vox-orchestrator-mcp · Version: 0.6.0 · Target: Library (lib.rs)

MCP (Model Context Protocol) tool layer for vox-orchestrator. Extracted in 2026-05-08 reorg Phase 4.

Crate Overview

Unified tool registry and dispatcher for the Vox MCP server.

Extracted from vox-orchestrator/src/mcp_tools/ in 2026-05-08 reorg Phase 4.

Features

Feature	Default / Enables
`default`	toestub-gate, json-schema
`eval-gate`	dep:wiremock
`gui-visual-review`	—
`heavy-browser`	—
`json-schema`	vox-orchestrator/json-schema
`news-publish`	dep:vox-publisher, vox-orchestrator/news-publish, vox-publisher/scientia-reddit, vox-publisher/scientia-youtube, vox-publisher/scholarly-external-jobs
`oratio-rerank`	dep:vox-speech
`populi-transport`	vox-orchestrator/populi-transport, vox-populi/transport
`toestub-gate`	vox-orchestrator/toestub-gate
`token-counting`	vox-orchestrator/token-counting
`web-scrape`	vox-search/web-scrape

Workspace Dependencies

Dependency	Kind
`vox-actor-runtime`	Normal
`vox-bounded-fs`	Normal
`vox-capability-registry`	Normal
`vox-cli-core`	Normal
`vox-code-audit`	Normal
`vox-codegen`	Normal
`vox-codegen-ts`	Normal
`vox-compiler`	Normal
`vox-config`	Normal
`vox-corpus`	Normal
`vox-crypto`	Normal
`vox-db`	Normal
`vox-foundation`	Normal
`vox-gamify`	Normal
`vox-grammar-export`	Normal
`vox-graph-reader`	Normal
`vox-http-client`	Normal
`vox-jsonschema-util`	Normal
`vox-lsp`	Normal
`vox-mcp-registry`	Normal
`vox-mesh-types`	Normal
`vox-openai`	Normal
`vox-openclaw-runtime`	Normal
`vox-orchestrator`	Normal
`vox-orchestrator-driver`	Normal
`vox-orchestrator-types`	Normal
`vox-package`	Normal
`vox-plugin-catalog`	Normal
`vox-plugin-host`	Normal
`vox-plugin-types`	Normal
`vox-populi`	Normal
`vox-project-scaffold`	Normal
`vox-publisher`	Normal
`vox-redact`	Normal
`vox-repository`	Normal
`vox-research-events`	Normal
`vox-research-shim`	Normal
`vox-scientia`	Normal
`vox-search`	Normal
`vox-secrets`	Normal
`vox-similarity`	Normal
`vox-skill-discovery`	Normal
`vox-skills`	Normal
`vox-speech`	Normal
`vox-telemetry`	Normal
`vox-orchestrator`	Development
`vox-plugin-api`	Development

Public API Surface

Modules

Module	Description
`services`	HTTP routes (moved from vox-orchestrator/services/routes).
`autonomous_tool_dispatch`	T1.5 follow-up: bridges `AiTaskProcessor`’s autonomous `@tool` intent lines into real MCP dispatch (`handle_tool_call_with_mode`), so autonomous dangerous-tool calls go through the same approval gate as GUI-invoked ones, with `task_id` threaded through as an explicit parameter.
`chat_fallback_tools`	`<TOOL_CALLS>` XML fallback for LLM providers without native function-call support.
`daemon_extra`	—
`daemon_route`	T2.2: `vox mcp` stdio server’s tool-call forwarding to `vox-orchestrator-d`.
`feedback_tools`	—
`hitl_rehydrate`	T1.4: restore visibility for open approvals/feedback from the durable op-log on `ServerState` boot (MCP stdio + `vox-orchestrator-d`).
`params`	—
`pending_approvals`	—
`profiles`	—
`server_state`	—
`skill_promotion`	—
`approval_allowlist`	T0.3: persisted per-repo “always allow this tool” allowlist (tier 3 of the dangerous-tool gate’s precedence order).
`permission_modes`	T0.3: registry-driven risk classification + `PermissionMode` auto-approve matrix (tier 2 of the dangerous-tool gate’s precedence order).
`aci`	—
`agent_tools`	Agent native gateway and skill tools.
`benchmark_tools`	Benchmark telemetry query tools (`research_metrics`).
`browser_tools`	Chromium CDP browser automation (`vox_browser_*`).
`caller_role`	Trusted caller role for browser control-lock authorization.
`capability_tools`	`vox_capability_explain` / `vox_capability_features`: answers from the embedded capability index.
`chat_hop`	—
`chat_model_resolve`	Shared LLM model resolution for chat tools.
`chat_socrates_meta`	Socrates grounding + telemetry helpers for chat tools.
`chat_tools`	Chat, inline edit, ghost text, planning, and ambient editor decorations.
`code_validator`	Structured .vox diagnostics and repair tools.
`codex_tools`	Codex relational V17/V16 helpers over connected `VoxDb`.
`compiler_tools`	`cargo`/LSP validation helpers (`vox_validate_file`, `vox_run_tests`, …).
`db_tools`	Codex schema digest + sample row tools for `.vox` modules.
`dispatch`	—
`dispatch_timeout`	T4.3: per-tool-call execution timeout table (outer `tokio::time::timeout` wrapping actual tool dispatch — independent of the HITL approval-wait).
`exec_time_tools`	Execution time tracking tools.
`git_exec`	Central `git` executor with banned-command denylist and `vox.vcs.exec` telemetry.
`git_tools`	Thin `git` CLI wrappers scoped to the discovered git root.
`grammar_tools`	Grammar export tools
`graph_tools`	Graphify corpus freshness and lexical search (`vox_graphify_status`, `vox_graphify_search`).
`gui_ops`	GUI registry + validation tools (`vox_gui_components`, `vox_gui_tokens`, `vox_gui_rules`, `vox_validate_vuv`).
`gui_registry_tools`	—
`history_tools`	`vox_search_history`: first-parent repo history for agents (same facade as `vox graph history`).
`input_schemas`	—
`introspection_tools`	Introspection tools for language visualization (AST, surface, pipeline).
`llm_bridge`	—
`news_tools`	Unified News Publishing System tools
`openclaw_tools`	OpenClaw native gateway and skill tools.
`operation_capture`	Best-effort, redacted capture of every MCP tool call into `agent_operations`.
`oratio_tools`	Oratio speech-to-text (Candle Whisper).
`persistence_tools`	Orchestrator persistence outbox inspection helpers.
`populi_tools`	Local mens registry status (`vox_populi_local_status`).
`post_verification`	Automatic post-mutation `.vox` verification feedback (verification-driven agent loop).
`project_init_tools`	`vox init` parity scaffold (`vox_project_init`).
`questioning_tools`	Socrates questioning / clarification answer persistence (`VoxDb`).
`rag_tools`	Multi-modal Visual Retrieval-Augmented Generation RAG handler.
`receipt_tools`	Tool execution receipt claim verification.
`registry`	—
`repo_catalog_tools`	Explicit repo catalog + read-only polyrepo query tools.
`repo_index`	Bounded repo walk + on-disk JSON cache under `.vox/cache/repos/...`.
`scientia_tools`	Scientia publication lifecycle tools (manifest, approval, submission).
`scope_guard`	—
`secrets_tools`	Secrets credential tools.
`session_identity`	—
`speech_pipeline_tools`	Speech → codegen orchestration (`vox_speech_to_code`).
`sync_poison`	—
`task_tools`	Orchestrator task submit/status/cancel/drain tools.
`toestub_tools`	TOESTUB (Todo/Stubs/Empty) finding ingestion and queue management.
`tool_aliases`	—
`tool_envelope`	—
`tool_images`	Strip `image_base64` from MCP tool JSON and build image parts for chat.
`tool_search`	`vox_tool_search` — keyword search over the tool registry (progressive disclosure).
`training_tools`	Training-intent submission via orchestrator (Mens CLI remains canonical executor).
`trust_tools`	Trust rollup inspection tools (`trust_rollups` over VoxDb).
`vcs_tools`	Snapshot / oplog / workspace orchestrator VCS tools.
`visus_review`	GUI visual AI adversarial review (advisory; never gates CI).
`visus_tools`	GUI Visual Intelligence tools.
`a2a_tools`	—
`affinity_tools`	—
`gamify_tools`	—
`memory_tools`	—
`qa_tools`	—
`models_tools`	—
`skill_permissions`	—
`skill_search_index`	—
`skills_hydrate`	—
`skills_resources`	—
`skills_tools`	—
`workspace_mcp`	—
`plugin_tools`	—
`trace_tools`	—
`dei_tools`	—
`kb_resources`	—
`kb_tools`	—
`mcp_context`	—
`mcp_client`	—
`dei_ipc`	—
`http_gateway`	—
`journey_envelope`	—
`populi_startup`	—
`speech_constraints`	—
`mens`	VoxMens runtime integration — semantic tool retrieval (B3+).
`schema_guided`	B4 — Schema-constrained decoding helpers (`GuidedDecodingSpec`, `attach_guided_decoding`).
`agy_doctor`	—
`agy_exec`	—
`agy_gates`	—
`agy_ledger`	—
`agy_pipeline`	—
`agy_tools`	—
`agy_worktree`	—
`lifecycle`	—
`plugin_skills_bridge`	—
`server`	—