Agentic MCP

[Architecture] Read-only analysis of file imports (outward) and dependents (inward) in the project. Does not execute code or modify files.

Permanently delete a workspace session from history and free its alias.

⚠️ DEPRECATED — use changed_files_summary instead. This alias is kept for backward compatibility but will be removed in a future version.

[Git] Read-only git diff showing uncommitted changes. Does not modify the repository.

[Git] Read-only git log showing recent commit history. Does not modify the repository.

[Git] Read-only git status showing branch, staged, unstaged, and untracked files. Does not modify the repository.

Find files by glob pattern inside an open workspace. Use this to discover filenames or narrow file sets before reading. Respects project ignore rules. Call open_workspace first and pass workspaceId.

Search lexically for a known symbol, identifier, string, or pattern without reading complete files. Best for locating declarations or references when the exact line is unknown. It does not infer semantic dependencies or behavioral relationships.

[Knowledge] Save a decision, invariant, or lesson learned to the workspace knowledge base (.agentic/knowledge/decisions/). Call this after completing a task to persist hard-won insights for future sessions. ScopedTo limits when this knowledge is injected back into context.

[Knowledge] Read-only search of past decisions and insights from the workspace knowledge base (.agentic/knowledge/). Optionally filter by scope.

List all known workspaces and their aliases.

List a directory inside an open workspace. Use this for directory inspection before reading files. Call open_workspace first and pass workspaceId.

[Architecture] Read-only listing of monorepo apps and packages with their dependencies from apps/ and packages/ directories.

[Architecture] Read-only bounded summary of Next.js route files (app/ and pages/) inside the opened workspace. Does not execute code, does not write files, returns a compact limited result.

⚠️ DEPRECATED — use next_route_map instead. This alias is kept for backward compatibility but will be removed in a future version.

Open a local project directory as a coding workspace. Call this once per project folder or worktree before reading, editing, searching, writing, showing changes, or running commands. Reuse the returned workspaceId for later calls in the same folder; do not call open_workspace again unless switching folders/worktrees, changing checkout/worktree mode, the workspaceId is rejected as unknown, or the user explicitly asks to reopen. By default this opens the actual checkout; set mode="worktree" when the user asks for an isolated or parallel coding session. Returns a workspaceId, loaded root project …

⚠️ DEPRECATED — use payload_schema_map instead. This alias is kept for backward compatibility but will be removed in a future version.

Read-only bounded summary of Payload CMS collection schemas extracted via AST. Does not execute code, does not write files, and returns a compact limited result. For monorepos, pass appPath (e.g. 'apps/web') to scan a specific app subdirectory.

⚠️ DEPRECATED — use edit_dry_run instead. This alias is kept for backward compatibility but will be removed in a future version.

[Context] Returns high-level workspace context: package manager, git status, tree, capabilities (nextjs, payload, monorepo, etc.), and project instructions. Start here when you need to understand what kind of project this is and which tools are relevant.

[PVDL] Log a structured plan for material, multi-step, uncertain, or high-risk changes. Do not add a planning round-trip to trivial exact edits when strict PVDL is disabled. When AGENTIC_STRICT_PVDL is enabled, propose_plan is required before edit/write and the server enforces it.

Description is built at runtime.

Inspect one already-known code file with automatic AST-aware compression based on size. Best for whole-file orientation when exact ranges are not known. Compressed output may omit implementation bodies, so obtain exact source text before changing an omitted region.

[General] Read a file using AST-aware semantic compression. Use this to save tokens when exploring large files. Compression levels: 'light' (removes large objects), 'balanced' (removes function bodies but keeps signatures), 'aggressive' (removes all bodies and objects), 'skeletal' (keeps only top-level declarations).

Batch related inspection in one round trip once the relevant area is known: exact reads/ranges, bounded lexical matches with context, and scoped globs. Items execute in order as priority under shared serialized-evidence, line, and file budgets; final payload cost is estimated separately. Literal matching is default and regex is an explicitly bounded opt-in. Prefer this over separate grep→read cycles in the same known area; it is not for project-wide architectural discovery.

Rename an existing workspace alias.

Reopen a previously opened workspace using its alias. Returns the workspace context.

[Security] Preview the active command-policy verdict without executing a command.

[Execution] Runs an npm run script from the workspace's package.json. Use outputMode: 'diagnostic-summary' (or 'summary') to get a compact error/warning report instead of full build logs.

[File System] Extracts imports and exports from large files to provide a quick summary.

[Context] Returns a compact, goal-relevant semantic pack of the workspace. Combines project context, architecture, routes, collections, recommendedFiles (with relevanceTier), and key file contents — all within a configurable token budget. Pass excludePaths to skip already-read files. Use this instead of multiple separate read calls for a focused overview. Optionally pass a goal to filter to relevant files.

Show aggregate file changes for an open workspace. Use when a turn changes multiple files, includes patch/shell/external mutations, needs an aggregate review, or the user explicitly asks to inspect all changes together. QUICK single-file edit/write mutations already carry their own review widget and do not need this extra call solely to repeat the same diff.

Plan proportionate verification after material code or configuration changes when the correct checks are not already obvious. QUICK low-risk work with an evident cheap check does not need an extra planning call. Recommendations are staged cheap-first; builds are reserved for release, build-sensitive, or higher-risk scope. It does not execute checks.

Return a minimal, fast, stateless, goal-directed map only when the relevant implementation files are not yet known. Discover primary candidates, nearby tests, and limited dependency evidence within a strict token budget, then stop. Skip this discovery step when the target file is already known; use composite inspection directly for a known target area.

[Context] Analyze token usage across all files read in the current turn. Returns which files consumed the most tokens, how much budget remains, and suggestions for reducing context bloat (use compression, skip non-essential files, etc).

[Tournament] Tear down tournament worktrees. Optionally keep a winner. Set force=true only to discard uncommitted worktree changes.

[Tournament] Run verification scripts on all tournament worktrees and compare results. Default: runs typecheck + build on each.

[Tournament] Spawn multiple managed git worktrees (one per strategy) from the same base ref for parallel experimentation. Each worktree is isolated; implement different strategies in each. After implementing, call tournament_judge to compare results.

[File System] Recursively list directory structure.

[Visual] Capture a running local web app at multiple responsive viewport sizes and return screenshots directly to the model for UX/UI evaluation. Defaults to desktop, laptop, tablet, and mobile. Use customViewports for breakpoint-specific inspection. The URL must be local (localhost, 127.0.0.1, or ::1).

Return an extremely compact overview of the current workspace: package metadata, scripts, dependencies, repository status, and top-level directories. Use only when this high-level pulse-check is actually needed.

[General] Hydrates dependencies (e.g., npm install or pnpm install) inside a managed git worktree sandbox.

Lists all currently active managed git worktrees created via open_workspace.

[General] Copies uncommitted changes from the main workspace to this managed worktree sandbox.

[General] Removes a managed git worktree that was created via open_workspace(mode: 'worktree'). If the worktree has uncommitted changes, pass force=true to discard them.

Create or completely overwrite one file in an open workspace. Small low-risk writes may be applied directly when strict PVDL is disabled; material or risky work should preserve an explicit rollback path.