Skip to main content
Glama

maid_validate

Validate MAID manifests against code, tests, or schema using three modes: implementation, behavioral, and schema.

Instructions

Validate a MAID manifest using MAID Runner.

When to use:

  • Phase 2 (Planning): After creating/updating a manifest, validate it passes

  • Phase 3 (Implementation): After writing code, verify it matches the manifest

  • Before committing: Ensure all manifests are valid

Validation modes:

  • implementation: Checks that code artifacts match manifest expectedArtifacts

  • behavioral: Checks that tests exist and reference the expected artifacts

  • schema: Checks that the manifest structure conforms to the JSON schema

Use manifest chain when:

  • Editing existing files (taskType: "edit")

  • The file has previous manifests that define its history

  • You need to verify the full history of changes is valid

Args: manifest_path: Path to the manifest JSON file validation_mode: Validation mode (implementation, behavioral, or schema) use_manifest_chain: Whether to use manifest chain for validation manifest_dir: Directory containing manifests (optional) quiet: Whether to suppress verbose output ctx: MCP context for accessing working directory

Returns: ValidateResult with validation outcome

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
manifest_pathYes
validation_modeNoimplementation
use_manifest_chainNo
manifest_dirNo
quietNo

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
successNo
modeNo
manifestNo
target_fileNo
used_chainNo
errorsNo
file_trackingNo
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, description discloses validation modes, behavior for editing files, and return type. Lacks mention of side effects, but validation is likely read-only. Good transparency overall.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Well-structured with headings and bullet points, but some redundancy (e.g., 'Validation modes' could be tighter). Still concise and easy to scan.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Covers all necessary aspects: purpose, usage guidelines, parameter explanations, and return value. With output schema present, the description is complete for an agent to use correctly.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters5/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 0%, but the description explains each parameter: manifest_path, validation_mode (with options), use_manifest_chain, manifest_dir, quiet. Adds significant meaning beyond the schema.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states 'Validate a MAID manifest using MAID Runner', specifying the verb and resource. It distinguishes from siblings like maid_files and maid_init, which have different purposes.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Explicit guidance on when to use: Phase 2 and 3, before committing. Also covers validation modes and manifest chain usage, providing clear context for selection.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Install Server

Other Tools

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/mamertofabian/maid-runner-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server