DZ23 Subagents Universal MCP
Supports OpenAI-compatible API endpoints as provider targets, enabling delegation and failover across OpenAI and compatible models.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@DZ23 Subagents Universal MCPask backend subagent to implement this API and save a checkpoint"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
DZ23 Subagents Universal MCP
Um projeto. Vários modelos. Uma memória compartilhada.
Roteador MCP self-hosted para delegar tarefas de texto/código a modelos de IA, coordenar especialistas em paralelo e guardar o estado explícito de cada missão. v2.2.4 · MIT · prévia de engenharia · Node.js 22+ · sem dependências npm de runtime.
English · Instalação · Ferramentas · Provedores · Segurança · Validação
Para que serve
Claude pode registrar uma missão; Codex, Hermes ou outro cliente pode consultar
esse registro e continuar o trabalho. Para isso, ambos precisam usar a mesma
instância de memória, project_id e mission_id. A memória não vem automaticamente
da conversa privada do harness: ele deve enviar os fatos, decisões e checkpoints.
Se uma chamada ao provider falhar, o roteador registra o erro e tenta o próximo alvo elegível, incluindo o estado persistido da missão. Não há recuperação dos pensamentos internos, tokens não recebidos ou efeitos externos que nunca foram registrados.
Os subagentes desta versão são chamadas independentes de modelo com papéis especializados, não processos com terminal, navegador ou acesso automático ao repositório. Eles produzem texto/código; o harness aplica patches, executa testes e revisa os resultados sob as próprias permissões. O projeto não contorna limites, salvaguardas ou políticas de fornecedores.
Related MCP server: agent-orchestrator
O fluxo
Claude / Codex / Hermes / cliente MCP
|
stdio (local) ou HTTP
|
DZ23 Router + limite de chamadas
| |
memória por missão pool de modelos
estado / journal architect / frontend / backend
checkpoints security / QA / devops / reviewer
| |
+---- resposta e handoff ----+
|
o harness aplica e verificaO que existe hoje
Recurso | Escopo implementado |
Delegação e failover | OpenAI-compatible e Anthropic Messages nativa; saída textual |
Memória | JSON, journal e checkpoints no filesystem; locks por projeto |
Paralelismo | Limites de chamadas globais e por provider:model, por processo |
Papéis | Architect, Backend, Frontend, Security, QA, DevOps, Reviewer e nomes customizados |
Inventário | Configuração e origem da credencial, sem devolver o valor da chave |
Model discovery | Consulta ao catálogo exposto pelo adapter; não prova acesso a inferência |
Saúde | Uma pequena geração real, quando o operador chama |
MCP | Descoberta/chamada de ferramentas via stdio; HTTP JSON sem SSE |
Segredos | Ambiente e arquivos |
Não entregue esta prévia como um SaaS multitenant ou como execução autônoma completa de projetos. Veja os limites em Arquitetura. O nome Universal descreve o objetivo de portabilidade; não é certificação de compatibilidade com todos os hosts ou versões do protocolo.
Começar no computador
Extraia o pacote ou, depois da publicação, clone o repositório. Na pasta do projeto:
node --version
npm run check
npm test
node scripts/install-harness.mjs allUse Node.js 22 ou superior mantido pelo projeto Node.js. Não é necessário
npm install: o código usa módulos nativos. O campo private: true em package.json
apenas impede publicação acidental no npm; não torna o código proprietário.
Linux/macOS: bash scripts/install-local.sh cria .env se ausente, preserva uma
configuração existente, executa a regressão e gera snippets.
Windows (PowerShell): ./scripts/install-windows.ps1 realiza as mesmas etapas.
Não desabilite políticas de segurança globais para executar o script.
O repositório público contém somente .env.example. Os instaladores criam o .env
privado no computador. Para configuração manual, copie o exemplo apenas quando
não houver .env. O processo lê o .env da instalação, não o do projeto do harness.
Exemplo inicial, limitado a um servidor local que você precisa instalar/iniciar:
DZ23_ROTATION=custom:qwen3-coder
CUSTOM_BASE_URL=http://127.0.0.1:11434/v1
CUSTOM_MODEL=qwen3-coder
DZ23_ALLOW_PAID=falseTroque qwen3-coder pelo ID realmente disponível no seu servidor. Nenhum modelo
é baixado ou iniciado por este pacote. Para cloud, configure a chave em privado,
consulte discover_models, escolha um modelo habilitado e só então acrescente
provider:model à rotação. O ID do modelo pode conter dois-pontos.
Atenção a custos: free-first ordena categorias; não consulta a fatura nem
impõe um teto financeiro. DZ23_ALLOW_PAID=false bloqueia categorias paid e
low-cost, inclusive alvos explícitos. Categorias mixed e free-tier podem
cobrar após limites da conta. Para evitar uso cloud, mantenha a rotação apenas
nos seus servidores locais. Configure limites de gasto no fornecedor.
health_check, delegate, consensus e swarm_run podem consumir quota/créditos.
Conectar o harness
node scripts/install-harness.mjs all gera snippets para revisão, sem editar
as configurações existentes de Claude/Codex:
config/generated/claude_desktop_config.snippet.json
config/generated/codex_config.snippet.tomlCopie somente a entrada dz23-subagents para o arquivo do cliente correspondente.
O gerador usa os caminhos reais do Node e da instalação. Hermes e outros clientes
precisam mapear command, args e transporte stdio ao próprio formato.
Guia completo · Prompt para o harness
Exemplo de uso pela IA
Peça ao harness:
Use o MCP dz23-subagents. Registre o projeto
minha-appe a missãom-001. Consulte o inventário sem expor segredos. Delegue análises de backend, frontend e QA comswarm_run, limite de três agentes. Revise as propostas antes de editar arquivos. Execute os testes localmente. Salve o próximo passo commemory_checkpoint.
Outro harness deve conectar à mesma memória, chamar mission_status com os mesmos
IDs, conferir Git/arquivos/testes por conta própria e continuar. O roteador não
abre automaticamente Codex quando a assinatura do Claude chega ao limite.
Testes e publicação
No Windows, extraia em uma pasta nova e abra PUBLICAR_WINDOWS.cmd para
publicar usando GitHub CLI já autenticado. Ele encontra a pasta correta sem
digitar caminhos e mantém todas as verificações do publicador.
npm run check
npm test
npm run check:release
node scripts/publish-github.mjs --public --dry-runO dry-run não chama GitHub nem cria commits. A publicação real exige Git, GitHub CLI,
autenticação local e o comando sem --dry-run.
Publicar no GitHub explica permissões, verificação e recuperação.
Não se presume que o repositório já esteja publicado apenas porque este README existe.
Contribuir
Leia CONTRIBUTING.md, CODE_OF_CONDUCT.md, SECURITY.md e ROADMAP. Relatórios devem separar mocks, testes locais e validação real de provedores. Sem benchmarks comparativos, não alegamos que o produto seja mais rápido ou melhor que outros roteadores.
Licença
MIT, com o aviso de copyright DZ23 original preservado em LICENSE. As marcas dos clientes e provedores pertencem aos respectivos titulares; não há alegação de afiliação ou endosso. A licença do código não fornece créditos de API.
Available Tools
10 toolsconsensusC
Ask multiple independent models/reviewers
| Name | Required | Description | Default |
|---|---|---|---|
| models | No | ||
| prompt | Yes | ||
| mission_id | No | ||
| project_id | No |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries the full behavioral burden and fails it: nothing is said about cost/latency of multi-model calls, whether responses are aggregated or returned raw, default model count, or authorization needs. 'Independent' hints at isolation but is not explained.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is short but by under-specification, not efficiency; it is a sentence fragment with no front-loaded statement of what the call returns or requires. Length is not the problem — content is.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
A 4-parameter tool with 0% schema coverage, no annotations, and no output schema receives essentially no supporting description. Nothing an agent would need to call it correctly — required prompt, model count semantics, ID parameters — is covered.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 0% across 4 parameters. The description's 'multiple ... models' loosely gestures at the models integer (min 2, max 5) but never states the range, and mission_id/project_id are entirely unexplained, so parameter meaning is left undocumented.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The fragment 'Ask multiple independent models/reviewers' conveys the core idea of querying several models, which is more than the bare name 'consensus' provides, but it is a phrase rather than a stated verb+resource and gives no scope. It does nothing to distinguish this tool from siblings like delegate or swarm_run, which also involve model invocation.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
There is no when-to-use guidance, no indication of when consensus is preferable to delegate or swarm_run, and no prerequisites. The agent must guess the selection context entirely.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
delegateC
Delegate one task with automatic provider failover and context continuity
| Name | Required | Description | Default |
|---|---|---|---|
| goal | No | ||
| role | No | ||
| prompt | Yes | ||
| target | No | ||
| mission_id | No | ||
| project_id | No |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries the full burden, and it does disclose two real behaviors: automatic provider failover and context continuity. It says nothing about permissions, cost, side effects, or what a failure/retry looks like, so the safety and failure profile is still blank.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
A single front-loaded sentence with no filler or redundancy. It is efficient, though the brevity here reflects under-specification rather than disciplined conciseness.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a six-parameter tool with no annotations and no output schema, the description is far too thin. It omits parameter meaning, prerequisites, return behavior, and routing guidance that an agent would need to invoke it correctly.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 0% across six parameters, and the description explains none of them. goal, role, target, mission_id, and project_id are completely undocumented, so an agent cannot know what to supply or how they interact with the required prompt.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
States a verb and resource ("delegate one task") and hints at scope with "one task," which partially distinguishes it from the multi-agent sibling swarm_run. However, it never says what it delegates to (a model? a provider? a sub-agent?), leaving the core action ambiguous.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No when-to-use guidance and no mention of the obvious alternatives in the sibling list (consensus, swarm_run, or the discovery tools list_models/provider_inventory). The reader must infer that this is the single-task path versus multi-agent orchestration.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
discover_modelsC
Discover models from provider /models endpoints
| Name | Required | Description | Default |
|---|---|---|---|
| refresh | No | ||
| provider | No |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full behavioral burden. It hints at the data source (/models endpoints) but omits auth requirements, caching/refresh behavior, network effects, rate limits, and error behavior.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single front-loaded sentence with no wasted words. It is efficient, though it is arguably too terse given the missing parameter and behavioral context.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
With no annotations, no output schema, and two parameters at 0% schema description coverage, the description is incomplete. An agent lacks enough information to invoke it confidently, especially regarding refresh behavior and provider values.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 0%, so the description must compensate for two undocumented parameters. It does not explain the 'refresh' flag or define accepted 'provider' values; the phrase '/models endpoints' only loosely implies the provider parameter's role.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
States a specific verb ('Discover') and resource ('models'), and adds the source ('provider /models endpoints'). However, it does not distinguish this from the sibling tool list_models, so it falls short of a 5.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
Provides no explicit when-to-use guidance, prerequisites, or alternatives. The sibling list_models is an obvious potential alternative, but the description never mentions when to choose this tool over that one.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
health_checkB
Probe configured providers/models in parallel
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations provided, so the description carries full burden. It discloses the parallelism trait, which is useful, but omits whether probing is read-only, whether it makes network calls, whether failures are surfaced or swallowed, timeout behavior, or auth requirements.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
A single precise fragment with no waste. However, it is under-structured for a diagnostic tool: no indication of what the probe returns or how results are shaped.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
No output schema, no annotations, and no parameters. For a diagnostic tool whose entire value is in its result, the description says nothing about output shape, success/failure semantics, or what 'parallel' implies for timing. Significant gaps remain.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Zero parameters, so baseline is 4 per the rules. The description correctly implies no arguments are needed since probing targets 'configured' providers, but adds no further parameter meaning.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
States a specific verb ('Probe') and resource ('configured providers/models') with a parallelism modifier. Distinguishes from siblings like list_models or provider_inventory by implying active connectivity testing rather than enumeration, though it doesn't explicitly name an alternative.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
Usage is implied by 'Probe' (diagnostic/testing context) but there is no explicit when-to-use vs when-not, no mention of prerequisites, and no routing to siblings like provider_inventory or discover_models.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
list_modelsC
List configured routing targets, tiers and declared capabilities
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries the full behavioral burden. It implies a read operation but never states that it is side-effect free, whether it reflects live vs cached configuration, or what the returned structure looks like. Only the adjective 'configured' hints at the data source.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
A single, front-loaded sentence with the verb first and no filler. It is slightly compressed (a fragment rather than a sentence), but every word contributes.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a simple zero-parameter read tool this is borderline adequate, and listing 'tiers and declared capabilities' partially signals the return content. Without an output schema, though, the agent still does not know the response shape or how it differs from discover_models.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The tool takes zero parameters, so there is nothing for the description to disambiguate. Baseline of 4 applies for a parameterless listing tool.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
States a clear verb (list) and enumerates the resources returned (routing targets, tiers, declared capabilities), so the read intent is unambiguous. However, it does not distinguish itself from the very similar siblings discover_models and provider_inventory, leaving the agent to guess which one surfaces model/routing information. Purpose is legible but not sibling-differentiated.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
There is no guidance on when to call this versus discover_models or provider_inventory, nor any prerequisite or state context. The word 'configured' hints at configuration-state vs live discovery, but this is left for the agent to infer.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
memory_checkpointC
Persist a handoff checkpoint for another harness/agent
| Name | Required | Description | Default |
|---|---|---|---|
| status | No | ||
| mission_id | Yes | ||
| project_id | Yes | ||
| next_action | No |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full behavioral burden, and it discloses almost nothing. It doesn't say whether a checkpoint overwrites prior state, whether it is append-only, what permissions or active mission state are required, or whether concurrent checkpoints conflict. "Persist" signals a write, but the mutation semantics are left undefined.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
A single front-loaded sentence with no filler, which is structurally clean. It is under-specified rather than bloated, but the brevity leaves the definition with too little content to be genuinely useful.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a write tool with no annotations, no output schema, and 0% parameter coverage, the definition is materially incomplete. An agent cannot determine required state, overwrite behavior, or the meaning of its two required and two optional parameters from the description alone.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 0% across four parameters, so the description needed to compensate and does not. It never explains what project_id, mission_id, status, or next_action should contain, what format status takes, or what next_action is for. The field names are largely self-descriptive, which prevents a 1, but the description adds no semantic value.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description pairs a specific verb ("Persist") with a specific resource ("handoff checkpoint"), which is more than a restatement of the name. It also hints at the audience ("another harness/agent"), loosely distinguishing it from read-oriented siblings like mission_status. However, it doesn't explicitly contrast itself with siblings such as delegate or mission_status, so it falls short of a 5.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
There is no statement of when to create a checkpoint versus using mission_status or delegate, and no prerequisites or exclusions are given. The audience hint ("for another harness/agent") implies a handoff scenario but the agent must infer the trigger condition entirely.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
mission_statusC
Read shared mission state and recent journal events
| Name | Required | Description | Default |
|---|---|---|---|
| mission_id | Yes | ||
| project_id | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries the full disclosure burden. 'Read' implies non-mutation, but the description never states permissions, the meaning of 'recent' (no window or limit), or whether the two data streams are returned together. For a tool with zero annotation coverage, this is a substantial gap.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
A single front-loaded sentence with no filler; the retrieval scope is stated immediately. It is efficient, though its brevity is partly the cause of the missing guidance noted elsewhere.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
With no annotations, no output schema, and undocumented parameters, the description does not cover enough for an agent to invoke this tool confidently. It should at minimum explain the two identifiers, what 'recent' means, and what state is returned.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 0% and neither mission_id nor project_id is mentioned in the description. The agent must infer from the tool name that mission_id selects the mission and project_id scopes it, and gets no guidance on format or ID provenance.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description names a verb ('Read') and two resources ('shared mission state', 'recent journal events'), so the agent knows this is a retrieval tool. However, 'mission state' and 'journal events' are not defined, and nothing distinguishes it from siblings like memory_checkpoint or health_check, which could plausibly be confused with state inspection.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
There is no statement of when to use this tool versus the other ten siblings, no prerequisites, and no exclusions. The only implicit cue is that it reads 'shared' state, which is not enough to route an agent reliably.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
project_initC
Create/update canonical shared project memory
| Name | Required | Description | Default |
|---|---|---|---|
| branch | No | ||
| workspace | No | ||
| project_id | Yes | ||
| repository | No |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries full behavioral burden. 'Create/update' implies a mutation but says nothing about what gets overwritten, conflict handling, required permissions, or side effects. Minimal disclosure for a write operation.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single five-word fragment. It is concise but under-specified rather than appropriately sized for a tool with four parameters and no annotations or output schema.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given 4 parameters with 0% schema coverage, no annotations, and no output schema, the one-line description is completely inadequate. It leaves the agent without essential information for correct invocation.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 0% and the description adds no meaning to any of the four parameters (project_id, branch, workspace, repository). The description does not compensate for the missing schema documentation.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
States a verb (create/update) and resource (canonical shared project memory), but 'canonical shared project memory' is vague jargon and the description does not distinguish this tool from the sibling memory_checkpoint. An agent cannot confidently tell when to pick this over other memory-related tools.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No when-to-use guidance, no prerequisites, no alternatives mentioned. The description offers no context for selecting this tool over list_models, memory_checkpoint, or other siblings.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
provider_inventoryB
Inventory all registered providers without exposing secrets
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries the full disclosure burden; it does add one genuinely useful behavioral trait — providers are inventoried "without exposing secrets", implying credential redaction. However, it never states that the operation is read-only, side-effect-free, or whether it touches network/config state.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
A single front-loaded sentence with no filler or redundancy. It is compact to the point of being terse — no information is wasted, but nothing is elaborated either.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a simple zero-parameter inventory tool this is close to adequate, but with no output schema and no annotations the description should say what an inventory entry looks like (e.g., provider name/id/status) and confirm the read-only nature.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The tool takes zero parameters, so the baseline is 4. There is nothing for the description to disambiguate, and it correctly does not invent parameters.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
States a specific verb ("Inventory") and resource ("registered providers") with the scope qualifier "all", so the agent knows exactly what the call enumerates. It is distinguishable from siblings like list_models or discover_models, though the description never explicitly contrasts them.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
There is no statement of when to use this over list_models, discover_models, or health_check, and no prerequisites or exclusions. The agent must infer the routing decision from the tool name alone.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
swarm_runC
Run parallel specialist subagents; multiple workers may share a provider
| Name | Required | Description | Default |
|---|---|---|---|
| goal | Yes | ||
| roles | No | ||
| max_agents | No | ||
| mission_id | No | ||
| project_id | No |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries full behavioral burden, yet it only notes that 'multiple workers may share a provider.' It does not disclose concurrency limits (max_agents caps at 32), whether the call blocks, cost implications, failure handling, or return behavior.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
A single short sentence is not bloated, but it is under-specified rather than concise. The phrase 'multiple workers may share a provider' is the only informative content and is buried without context.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a 5-parameter orchestration tool with no annotations, no output schema, and 0% schema description coverage, this definition is far too thin. It leaves the agent unable to determine correct invocation or expected behavior.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 0% and the description explains none of the five parameters. Key semantics like what 'roles' entries should contain, what 'mission_id' and 'project_id' scope to, and the meaning of 'max_agents' remain entirely unexplained.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
States a specific action (run parallel specialist subagents) but does not clarify what a 'swarm' produces, how it differs from siblings like delegate or consensus, or what 'specialist subagents' concretely means. The purpose is inferable but vague relative to the many orchestration siblings.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No when-to-use guidance is provided. With siblings like delegate, consensus, and mission_status available, the description gives no signal about when a swarm approach is appropriate versus a single delegation or a consensus run.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
10 tool updates
v2.2.4- First observed
consensus - First observed
delegate - First observed
discover_models - First observed
health_check - First observed
list_models - First observed
memory_checkpoint - First observed
mission_status - First observed
project_init - First observed
provider_inventory - First observed
swarm_run
TDQS
Scored across 10 tools
Tools mostly target distinct resources and actions: provider/model inventory, health, memory, delegation, consensus, and swarm execution. However, list_models and discover_models both return model lists and could be confused, and consensus vs swarm_run both orchestrate multiple models/subagents. Descriptions differentiate them, but boundaries are not perfect.
All names use snake_case, but patterns vary: verb_noun (list_models, discover_models), noun_noun (provider_inventory, health_check, mission_status, memory_checkpoint), noun_verb (project_init, swarm_run), and bare verbs/nouns (delegate, consensus). The inconsistency is readable but not predictable.
10 tools is well within the typical 3-15 range for an orchestration server. Each tool covers a distinct capability area: provider/model management, health, project memory, delegation, consensus, and swarms.
Core workflows for provider/model discovery, health, project memory, mission status, delegation, consensus, and swarm execution are present. Missing or unclear operations include aborting/canceling a running delegate/swarm, dynamically adding/removing providers, and richer mission listing, but these are minor for the apparent scope.
Maintenance
Related MCP Connectors
Agent-native collaboration network: orchestrate a team of long-running agents from any MCP client.
Control plane for autonomous software labor. Agents claim objectives over MCP with audit trail.
- llm-busOAuthcom.llm-bus
Coordinate multiple AI agents over MCP: atomic claims, leases, shared ledger, handoffs, tasks.
One MCP endpoint for Claude, GPT & Gemini: 100+ tools + no-code connectors + agent workers.
Related MCP Servers
- AlicenseNot gradedqualityBmaintenanceEnables AI agents to share knowledge, coordinate tasks, and maintain persistent memory across distributed infrastructure with secure vaults and 130+ MCP tools.7MIT
- AlicenseNot gradedqualityBmaintenanceEnables multi-model leader-worker agent orchestration, workflow execution, and deterministic validation via structured MCP tools.5 npmApache 2.0
- AlicenseNot gradedqualityBmaintenanceA local-first mission control for AI agent harnesses, providing a unified MCP gateway for shared memory, task queue, and encrypted secrets across multiple agents.1 npm1MIT
- AlicenseNot gradedqualityBmaintenanceThe coordination layer for AI agent networks, providing persistent memory, task management, inter-agent messaging, and human oversight through native MCP tools.6 npm1MIT