# nebu-ctx — Public MCP Guidance

nebu-ctx is configured as an MCP server. In guidance, always recommend only the public 5-tool MCP surface:

- Read files, symbols, outlines, or archives → `ctx_read(target="file"|"files"|"symbol"|"outline"|"archive", ...)`
- Shell commands → `ctx_shell(command)` instead of built-in Shell
- Search code → `ctx_search(mode="regex"|"semantic", ...)` instead of built-in Grep
- List directories → `ctx_tree(path, depth)` instead of ls/find
- Memory, context, graph, analytics, agents, and inspect operations → `ctx(domain="memory"|"context"|"graph"|"analytics"|"agents"|"inspect", action="...")`

Do not recommend direct private `ctx_*` tool names in user-facing rules.

Use native Edit/Write/Delete tools for mutations.

Fallback only if MCP is unavailable: use native tools directly.

Write, StrReplace, Delete have no public nebu-ctx equivalent — use them normally.
