Skip to content

vox-orchestrator-mcp API Reference (generated)

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.

Unified tool registry and dispatcher for the Vox MCP server.

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

FeatureDefault / Enables
defaulttoestub-gate, json-schema
eval-gatedep:wiremock
gui-visual-review—
heavy-browser—
json-schemavox-orchestrator/json-schema
news-publishdep:vox-publisher, vox-orchestrator/news-publish, vox-publisher/scientia-reddit, vox-publisher/scientia-youtube, vox-publisher/scholarly-external-jobs
oratio-rerankdep:vox-speech
populi-transportvox-orchestrator/populi-transport, vox-populi/transport
toestub-gatevox-orchestrator/toestub-gate
token-countingvox-orchestrator/token-counting
web-scrapevox-search/web-scrape
DependencyKind
vox-actor-runtimeNormal
vox-bounded-fsNormal
vox-capability-registryNormal
vox-cli-coreNormal
vox-code-auditNormal
vox-codegenNormal
vox-codegen-tsNormal
vox-compilerNormal
vox-configNormal
vox-corpusNormal
vox-cryptoNormal
vox-dbNormal
vox-diagramNormal
vox-foundationNormal
vox-gamifyNormal
vox-grammar-exportNormal
vox-graph-readerNormal
vox-http-clientNormal
vox-jsonschema-utilNormal
vox-lspNormal
vox-mcp-registryNormal
vox-mesh-typesNormal
vox-openaiNormal
vox-openclaw-runtimeNormal
vox-orchestratorNormal
vox-orchestrator-driverNormal
vox-orchestrator-typesNormal
vox-packageNormal
vox-plugin-catalogNormal
vox-plugin-hostNormal
vox-plugin-typesNormal
vox-populiNormal
vox-project-scaffoldNormal
vox-publisherNormal
vox-redactNormal
vox-repositoryNormal
vox-research-eventsNormal
vox-research-shimNormal
vox-scientiaNormal
vox-searchNormal
vox-secretsNormal
vox-similarityNormal
vox-skill-discoveryNormal
vox-skillsNormal
vox-speechNormal
vox-telemetryNormal
vox-orchestratorDevelopment
vox-plugin-apiDevelopment
ModuleDescription
servicesHTTP routes (moved from vox-orchestrator/services/routes).
autonomous_tool_dispatchT1.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_routeT2.2: vox mcp stdio server’s tool-call forwarding to vox-orchestrator-d.
feedback_tools—
hitl_rehydrateT1.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_allowlistT0.3: persisted per-repo “always allow this tool” allowlist (tier 3 of the dangerous-tool gate’s precedence order).
mcp_tool_accessMCP tool access matrix, 16 KiB model context, 20 KiB DOM shedding, and stateless DPoP auth (T3-HANDOFF-MCP-02..04).
permission_modesT0.3: registry-driven risk classification + PermissionMode auto-approve matrix (tier 2 of the dangerous-tool gate’s precedence order).
t3_wave3_toolsLive MCP tool handlers for T3 Wave 2/3 subsystems (T3-MCP-RPC-WIRE-01..03).
aci—
agent_toolsAgent native gateway and skill tools.
benchmark_toolsBenchmark telemetry query tools (research_metrics).
browser_toolsChromium CDP browser automation (vox_browser_*).
caller_roleTrusted caller role for browser control-lock authorization.
capability_toolsvox_capability_explain / vox_capability_features: answers from the embedded capability index.
chat_hop—
chat_model_resolveShared LLM model resolution for chat tools.
chat_socrates_metaSocrates grounding + telemetry helpers for chat tools.
chat_toolsChat, inline edit, ghost text, planning, and ambient editor decorations.
code_validatorStructured .vox diagnostics and repair tools.
codex_toolsCodex relational V17/V16 helpers over connected VoxDb.
compiler_toolscargo/LSP validation helpers (vox_validate_file, vox_run_tests, …).
db_toolsCodex schema digest + sample row tools for .vox modules.
diagram_toolsVoxDiagram validation (vox_validate_diagram).
dispatch—
dispatch_domains—
dispatch_timeoutT4.3: per-tool-call execution timeout table (outer tokio::time::timeout wrapping actual tool dispatch — independent of the HITL approval-wait).
exec_time_toolsExecution time tracking tools.
git_execCentral git executor with banned-command denylist and vox.vcs.exec telemetry.
git_toolsThin git CLI wrappers scoped to the discovered git root.
grammar_toolsGrammar export tools
graph_toolsGraphify corpus freshness and lexical search (vox_graphify_status, vox_graphify_search).
gui_opsGUI registry + validation tools (vox_gui_components, vox_gui_tokens, vox_gui_rules, vox_validate_vuv).
gui_registry_tools—
history_toolsvox_search_history: first-parent repo history for agents (same facade as vox graph history).
input_schemas—
introspection_toolsIntrospection tools for language visualization (AST, surface, pipeline).
llm_bridge—
news_toolsUnified News Publishing System tools
openclaw_toolsOpenClaw native gateway and skill tools.
operation_captureBest-effort, redacted capture of every MCP tool call into agent_operations.
oratio_toolsOratio speech-to-text (Candle Whisper).
persistence_toolsOrchestrator persistence outbox inspection helpers.
populi_toolsLocal mens registry status (vox_populi_local_status).
post_verificationAutomatic post-mutation .vox verification feedback (verification-driven agent loop).
project_init_toolsvox init parity scaffold (vox_project_init).
questioning_toolsSocrates questioning / clarification answer persistence (VoxDb).
rag_toolsMulti-modal Visual Retrieval-Augmented Generation RAG handler.
receipt_toolsTool execution receipt claim verification.
registry—
repo_catalog_toolsExplicit repo catalog + read-only polyrepo query tools.
repo_indexBounded repo walk + on-disk JSON cache under .vox/cache/repos/....
scientia_toolsScientia publication lifecycle tools (manifest, approval, submission).
scope_guard—
secrets_toolsSecrets credential tools.
session_identity—
speech_pipeline_toolsSpeech → codegen orchestration (vox_speech_to_code).
sync_poison—
task_toolsOrchestrator task submit/status/cancel/drain tools.
toestub_toolsTOESTUB (Todo/Stubs/Empty) finding ingestion and queue management.
tool_aliases—
tool_envelope—
tool_imagesStrip image_base64 from MCP tool JSON and build image parts for chat.
tool_searchvox_tool_search — keyword search over the tool registry (progressive disclosure).
training_toolsTraining-intent submission via orchestrator (Mens CLI remains canonical executor).
trust_toolsTrust rollup inspection tools (trust_rollups over VoxDb).
vcs_toolsSnapshot / oplog / workspace orchestrator VCS tools.
visus_reviewGUI visual AI adversarial review (advisory; never gates CI).
visus_toolsGUI 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—
mensVoxMens runtime integration — semantic tool retrieval (B3+).
schema_guidedB4 — 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—
Dependency Topology, diagram 119 nodes, 18 edges: vox-orchestrator-mcp → vox-actor-runtime; vox-orchestrator-mcp → vox-bounded-fs; vox-orchestrator-mcp → vox-capability-registry; vox-orchestrator-mcp → vox-cli-core; vox-orchestrator-mcp → vox-code-audit; vox-orchestrator-mcp → vox-codegen; vox-orchestrator-mcp → vox-codegen-ts;…vox-orchestrator-mcpvox-actor-runtimevox-bounded-fsvox-capability-registryvox-cli-corevox-code-auditvox-codegenvox-codegen-tsvox-compilervox-configvox-corpusvox-cryptovox-dbvox-clivox-cli-civox-cli-researchvox-guivox-integration-testsvox-orchestrator-d
Diagram source
graph {
direction: right
node vox_orchestrator_mcp: "vox-orchestrator-mcp"
node vox_actor_runtime: "vox-actor-runtime"
vox_orchestrator_mcp -> vox_actor_runtime
node vox_bounded_fs: "vox-bounded-fs"
vox_orchestrator_mcp -> vox_bounded_fs
node vox_capability_registry: "vox-capability-registry"
vox_orchestrator_mcp -> vox_capability_registry
node vox_cli_core: "vox-cli-core"
vox_orchestrator_mcp -> vox_cli_core
node vox_code_audit: "vox-code-audit"
vox_orchestrator_mcp -> vox_code_audit
node vox_codegen: "vox-codegen"
vox_orchestrator_mcp -> vox_codegen
node vox_codegen_ts: "vox-codegen-ts"
vox_orchestrator_mcp -> vox_codegen_ts
node vox_compiler: "vox-compiler"
vox_orchestrator_mcp -> vox_compiler
node vox_config: "vox-config"
vox_orchestrator_mcp -> vox_config
node vox_corpus: "vox-corpus"
vox_orchestrator_mcp -> vox_corpus
node vox_crypto: "vox-crypto"
vox_orchestrator_mcp -> vox_crypto
node vox_db: "vox-db"
vox_orchestrator_mcp -> vox_db
node vox_cli: "vox-cli"
vox_cli -> vox_orchestrator_mcp
node vox_cli_ci: "vox-cli-ci"
vox_cli_ci -> vox_orchestrator_mcp
node vox_cli_research: "vox-cli-research"
vox_cli_research -> vox_orchestrator_mcp
node vox_gui: "vox-gui"
vox_gui -> vox_orchestrator_mcp
node vox_integration_tests: "vox-integration-tests"
vox_integration_tests -> vox_orchestrator_mcp
node vox_orchestrator_d: "vox-orchestrator-d"
vox_orchestrator_d -> vox_orchestrator_mcp
}
Consumer CrateRole
vox-cliDirect workspace dependent
vox-cli-ciDirect workspace dependent
vox-cli-researchDirect workspace dependent
vox-guiDirect workspace dependent
vox-integration-testsDirect workspace dependent
vox-orchestrator-dDirect workspace dependent
KindSymbolSignatureSourceDescription
structa2a_tools::A2ASendParamspub struct A2ASendParamscrates/vox-orchestrator-mcp/src/a2a_tools.rs#L46-L63MCP tool arguments: point-to-point message on the orchestrator A2A bus.
structa2a_tools::A2AInboxParamspub struct A2AInboxParamscrates/vox-orchestrator-mcp/src/a2a_tools.rs#L67-L78MCP tool arguments: fetch unacknowledged inbox entries for one agent.
structa2a_tools::A2AAckParamspub struct A2AAckParamscrates/vox-orchestrator-mcp/src/a2a_tools.rs#L82-L89MCP tool arguments: mark one inbox message as read/processed.
structa2a_tools::A2ABroadcastParamspub struct A2ABroadcastParamscrates/vox-orchestrator-mcp/src/a2a_tools.rs#L93-L102MCP tool arguments: fan-out to every agent except the sender.
structa2a_tools::A2AHistoryParamspub struct A2AHistoryParamscrates/vox-orchestrator-mcp/src/a2a_tools.rs#L106-L111MCP tool arguments: audit trail query (since_ms filters by wall-clock ms; limit caps rows).
structa2a_tools::A2AMessageInfopub struct A2AMessageInfocrates/vox-orchestrator-mcp/src/a2a_tools.rs#L119-L134JSON row returned in inbox/history tool responses (mirrors orchestrator message bus records).
fna2a_tools::a2a_sendpub async fn a2a_send(state: &ServerState, params: A2ASendParams) -> Stringcrates/vox-orchestrator-mcp/src/a2a_tools.rs#L307Send a targeted A2A message from one agent to another (async).
fna2a_tools::a2a_inboxpub async fn a2a_inbox(state: &ServerState, params: A2AInboxParams) -> Stringcrates/vox-orchestrator-mcp/src/a2a_tools.rs#L589Read unacknowledged messages in an agent’s inbox (async).
fna2a_tools::a2a_ackpub async fn a2a_ack(state: &ServerState, params: A2AAckParams) -> Stringcrates/vox-orchestrator-mcp/src/a2a_tools.rs#L715-L770Acknowledge a message in an agent’s inbox (async).
fna2a_tools::a2a_broadcastpub async fn a2a_broadcast(state: &ServerState, params: A2ABroadcastParams) -> Stringcrates/vox-orchestrator-mcp/src/a2a_tools.rs#L773Broadcast an A2A message to all agents except sender (async).
fna2a_tools::a2a_historypub async fn a2a_history(state: &ServerState, params: A2AHistoryParams) -> Stringcrates/vox-orchestrator-mcp/src/a2a_tools.rs#L947-L993Query the A2A audit trail (async).
structaffinity_tools::FileOwnerParamspub struct FileOwnerParamscrates/vox-orchestrator-mcp/src/affinity_tools.rs#L19-L22MCP arguments: workspace-relative or absolute path to inspect for an owning agent.
structaffinity_tools::MyFilesParamspub struct MyFilesParamscrates/vox-orchestrator-mcp/src/affinity_tools.rs#L26-L29MCP arguments: list paths currently assigned to one agent.
structaffinity_tools::ClaimFileParamspub struct ClaimFileParamscrates/vox-orchestrator-mcp/src/affinity_tools.rs#L33-L38MCP arguments: agent takes exclusive affinity for path if unowned or already owned by them.
structaffinity_tools::TransferFileParamspub struct TransferFileParamscrates/vox-orchestrator-mcp/src/affinity_tools.rs#L42-L49MCP arguments: move affinity from from_agent to to_agent when the source owns the file.
structaffinity_tools::FileOwnerResponsepub struct FileOwnerResponsecrates/vox-orchestrator-mcp/src/affinity_tools.rs#L53-L58JSON fragment: resolved owner for a single path (owner is None if unassigned).
structaffinity_tools::MyFilesResponsepub struct MyFilesResponsecrates/vox-orchestrator-mcp/src/affinity_tools.rs#L62-L67JSON fragment: paths the affinity map associates with agent_id.
fnaffinity_tools::file_ownerpub async fn file_owner(state: &ServerState, params: FileOwnerParams) -> Stringcrates/vox-orchestrator-mcp/src/affinity_tools.rs#L70-L81Return JSON describing which agent (if any) owns params.path in the affinity map.
fnaffinity_tools::my_filespub async fn my_files(state: &ServerState, params: MyFilesParams) -> Stringcrates/vox-orchestrator-mcp/src/affinity_tools.rs#L84-L97Return JSON listing all file paths owned by params.agent_id.
fnaffinity_tools::claim_filepub async fn claim_file(state: &ServerState, params: ClaimFileParams) -> Stringcrates/vox-orchestrator-mcp/src/affinity_tools.rs#L100-L118Assign params.path to params.agent_id when not owned by another agent; mutates affinity map.
fnaffinity_tools::transfer_filepub async fn transfer_file(state: &ServerState, params: TransferFileParams) -> Stringcrates/vox-orchestrator-mcp/src/affinity_tools.rs#L121-L153Release then re-assign params.path from from_agent to to_agent; errors if ownership mismatches.
fnagent_tools::agent_list_remotepub async fn agent_list_remote(_state: &ServerState) -> Stringcrates/vox-orchestrator-mcp/src/agent_tools.rs#L62-L87List remote/local agent skills.
fnagent_tools::agent_gateway_callpub async fn agent_gateway_call(_state: &ServerState, params: OpenClawGatewayCallParams) -> Stringcrates/vox-orchestrator-mcp/src/agent_tools.rs#L90-L115Generic agent gateway method call.
fnagent_tools::agent_subscriptionspub async fn agent_subscriptions(_state: &ServerState) -> Stringcrates/vox-orchestrator-mcp/src/agent_tools.rs#L118-L143List agent gateway subscriptions for the current session.
fnagent_tools::agent_subscribepub async fn agent_subscribe(_state: &ServerState, params: OpenClawDomainParams) -> Stringcrates/vox-orchestrator-mcp/src/agent_tools.rs#L146-L171Subscribe this session to a gateway domain.
fnagent_tools::agent_unsubscribepub async fn agent_unsubscribe(_state: &ServerState, params: OpenClawDomainParams) -> Stringcrates/vox-orchestrator-mcp/src/agent_tools.rs#L174-L199Unsubscribe this session from a gateway domain.
fnagent_tools::agent_notifypub async fn agent_notify(_state: &ServerState, params: OpenClawNotifyParams) -> Stringcrates/vox-orchestrator-mcp/src/agent_tools.rs#L202-L227Notify a domain with a message payload.
enumagy_doctor::AgyStatuspub enum AgyStatuscrates/vox-orchestrator-mcp/src/agy_doctor.rs#L8-L12—
fnagy_doctor::known_install_dirspub fn known_install_dirs() -> Vec<PathBuf>crates/vox-orchestrator-mcp/src/agy_doctor.rs#L15-L25Best-effort platform install locations the installer documents, in addition to PATH.
fnagy_doctor::resolve_agypub fn resolve_agy() -> Option<PathBuf>crates/vox-orchestrator-mcp/src/agy_doctor.rs#L38-L49Resolve the binary path via PATH (which) then known install dirs.
fnagy_doctor::detectpub fn detect() -> AgyStatuscrates/vox-orchestrator-mcp/src/agy_doctor.rs#L53-L70Synchronous, fast classification (no long network calls). version is probed via agy --version; auth state is best-effort (see note in detect()).
fnagy_doctor::remediationpub fn remediation(status: &AgyStatus) -> Stringcrates/vox-orchestrator-mcp/src/agy_doctor.rs#L72-L91—
structagy_exec::AgySpecpub struct AgySpeccrates/vox-orchestrator-mcp/src/agy_exec.rs#L12-L16—
structagy_exec::AgyOutputpub struct AgyOutputcrates/vox-orchestrator-mcp/src/agy_exec.rs#L19-L25—
enumagy_exec::AgyExecErrorpub enum AgyExecErrorcrates/vox-orchestrator-mcp/src/agy_exec.rs#L28-L35—
fnagy_exec::validate_specpub fn validate_spec(spec: &AgySpec) -> Result<(), AgyExecError>crates/vox-orchestrator-mcp/src/agy_exec.rs#L37-L42—
fnagy_exec::build_argspub fn build_args(spec: &AgySpec) -> Vec<String>crates/vox-orchestrator-mcp/src/agy_exec.rs#L44-L57—
fnagy_exec::sanitize_slugpub fn sanitize_slug(s: &str) -> Stringcrates/vox-orchestrator-mcp/src/agy_exec.rs#L61-L76Lowercase, [a-z0-9-] only, collapsed dashes, max 40 chars. Prevents path traversal / illegal worktree paths.
structagy_exec::AgyExecpub struct AgyExeccrates/vox-orchestrator-mcp/src/agy_exec.rs#L79-L81—
fnagy_exec::newpub fn new(cwd: impl Into<PathBuf>) -> Selfcrates/vox-orchestrator-mcp/src/agy_exec.rs#L84-L86—
fnagy_exec::cwdpub fn cwd(&self) -> &Pathcrates/vox-orchestrator-mcp/src/agy_exec.rs#L87-L89—
fnagy_exec::runpub async fn run(&self, spec: &AgySpec) -> Result<AgyOutput, AgyExecError>crates/vox-orchestrator-mcp/src/agy_exec.rs#L91-L143—
fnagy_exec::classify_failurepub fn classify_failure(stderr: &str, exit_code: i32, timed_out: bool) -> Option<&'static str>crates/vox-orchestrator-mcp/src/agy_exec.rs#L147-L156Classify outcome for retry + ledger category. None on success.
fnagy_exec::should_retrypub fn should_retry(class: &str, attempt: u32, max_attempts: u32) -> boolcrates/vox-orchestrator-mcp/src/agy_exec.rs#L159-L168Pure retry decision. attempt 0-based; max_attempts the cap.
structagy_gates::Gatepub struct Gatecrates/vox-orchestrator-mcp/src/agy_gates.rs#L16-L23—