MCP Tool Reference
Auto-generated from the registered MCP tool descriptions and input schemas (
pnpm docs:tools). Do not edit by hand.
nexus-agents exposes 47 MCP tools via stdio. Each tool below links to its full parameter reference.
| Tool | Summary |
|---|---|
orchestrate |
Task orchestration with Orchestrator coordination |
create_expert |
Create a specialized expert agent |
execute_expert |
Run a task through a previously-created expert (by expertId) |
run_workflow |
Run a linear workflow template (use run_graph_workflow for DAGs) |
delegate_to_model |
Pick the best-fit existing model for a task (no registry change) |
list_experts |
Inventory of expert ROLES for create_expert |
list_workflows |
Inventory of multi-step TEMPLATES for run_workflow |
consensus_vote |
Multi-model consensus voting on proposals |
research_query |
Query research registry (status, overlap, stats, search) |
research_add |
Add an arXiv PAPER to the registry (for non-paper sources use research_add_source) |
research_add_source |
Add a NON-PAPER source (repo/tool/blog) — for arXiv papers use research_add |
research_discover |
Discover papers/repos from external sources |
research_analyze |
Analyze registry for gaps, trends, coverage |
research_catalog_review |
Review auto-cataloged research references |
research_synthesize |
Synthesize registry into topic clusters with themes |
survey_oss_landscape |
Transient OSS project search (license, stars, last-commit) via GitHub |
vendor_publishing_audit |
Look up a vendor’s signing infrastructure (GPG keys, URL patterns, signature shape) |
compare_data_feeds |
Diff two YAML/JSON feeds: coverage + per-field axes |
memory_query |
Query across all memory backends |
memory_stats |
Memory system statistics dashboard |
memory_write |
Write to typed memory backends |
weather_report |
Multi-CLI performance weather report |
issue_triage |
Triage GitHub issues with trust classification |
run_graph_workflow |
Run a DAG workflow with per-node checkpoints + audit trail (linear → run_workflow) |
execute_spec |
Execute AI software factory spec pipeline |
registry_import |
Draft YAML for a NEW model entry (for picking existing models use delegate_to_model) |
query_trace |
Query execution traces for observability |
query_task_state |
Query the structured task-state log for a task ID |
get_job_result |
Read result of an async-mode dispatch by jobId (#3042 / #2631) |
list_jobs |
List async-mode jobs across all tools — cross-session discovery (#3046 / #2631) |
cancel_job |
Cancel an async-mode job; aborts in-flight voters and workers — idempotent (#3042) |
ci_health_check |
CI infrastructure health — composes GitHub status + recent-runs activity (#3076) |
verify_audit_chain |
Verify hash chain of a FileAuditStorage audit log directory |
repo_analyze |
Analyze GitHub repository structure |
repo_security_plan |
Generate security scanning pipeline for a repo |
extract_symbols |
TypeScript-compiler-API AST symbols from a SINGLE file (functions/classes/types) |
search_codebase |
Cross-file search over declared symbol NAMES (declarations only, not usages) |
search_usages |
Structural usage/call-site search for a symbol via ast-grep (calls, member calls, new, imports, references) — the “where is X used” gap search_codebase cannot fill |
run_dev_pipeline |
Full dev pipeline: research, plan, vote, implement, QA |
run_pipeline |
Execute a pipeline plugin by name with typed input |
pr_review |
Multi-voter PR review with verification gate (experimental) |
supply_chain_tradeoff_panel |
Per-axis tradeoff vote for build-vs-buy / supply-chain decisions |
improvement_review |
Threshold-gated observability loop — surfaces routing/tech-debt/bug/security signals from outcome+fitness data; files candidate issues |
run_quality_gate |
Run the QA quality gate (typecheck/lint/tests/build/security) over a project dir; returns structured pass/fail verdict + feedback |
suggest_research_tasks |
SUGGEST-ONLY: candidate pipeline tasks from research_discover findings for review — files/executes nothing (#1715) |
list_available_models |
Probe all model-discovery transports (OpenRouter API + opencode/claude/codex/gemini CLIs) and report per-transport health — validates the CLIs/APIs are reachable (#3406) |
run |
Default entry point — give a goal, MetaOrchestrator picks the strategy; returns the routing decision (execute:false, read-only) or runs it inline (execute:true; dev-pipeline+pipeline+research+consensus wired) (#3548) |