
Workspace-scoped MCP server for coding agents: files, search, shell, checkpoints, PR/CI, audit.
Public tool metadata for what this MCP can expose to an agent.
project_list_filesList files/dirs, depth 1–3, limit ≤ 200List files/dirs, depth 1–3, limit ≤ 200
No parameter schema in public metadata yet.
project_read_fileRead a file by line range; optional `ranges[]` (up to 16)Read a file by line range; optional `ranges[]` (up to 16)
No parameter schema in public metadata yet.
project_get_file_infoFile/dir metadata (kind, size, mtime)File/dir metadata (kind, size, mtime)
No parameter schema in public metadata yet.
project_searchSearch by file/dir name, content, regex, or symbol; `hybrid: 1` tags hits with `source`+`confidence`Search by file/dir name, content, regex, or symbol; `hybrid: 1` tags hits with `source`+`confidence`
No parameter schema in public metadata yet.
project_recent_filesRecently modified files (index-first, scan-fallback)Recently modified files (index-first, scan-fallback)
No parameter schema in public metadata yet.
project_read_batchUp to 8 read-only ops in one call; each item takes the same arguments as its standalone toolUp to 8 read-only ops in one call; each item takes the same arguments as its standalone tool
No parameter schema in public metadata yet.
project_healthDiagnostics: capability, queue, cache hit-rates, p50/p95, security limits notice, and server.workspace_switchingDiagnostics: capability, queue, cache hit-rates, p50/p95, security limits notice, and server.workspace_switching
No parameter schema in public metadata yet.
project_read_auditRead recent audit log rowsRead recent audit log rows
No parameter schema in public metadata yet.
project_write_fileCreate/overwrite/append; `expected_sha256` guards blind overwritesCreate/overwrite/append; `expected_sha256` guards blind overwrites
No parameter schema in public metadata yet.
project_edit_fileReplace `old_text`→`new_text`; `edits[]` (up to 64); fuzzy edit opt-inReplace `old_text`→`new_text`; `edits[]` (up to 64); fuzzy edit opt-in
No parameter schema in public metadata yet.
project_edit_batchMultiple edits; stops at first failure and attempts checkpoint rollbackMultiple edits; stops at first failure and attempts checkpoint rollback
No parameter schema in public metadata yet.
project_createCreate file or directoryCreate file or directory
No parameter schema in public metadata yet.
project_delete_pathDelete file/dir; not undoableDelete file/dir; not undoable
No parameter schema in public metadata yet.
project_snapshotCheckpoints: create/list/restore/delete. Content-addressed, deduplicated, atomic per-file restoreCheckpoints: create/list/restore/delete. Content-addressed, deduplicated, atomic per-file restore
No parameter schema in public metadata yet.
project_outline_symbolParse a file's symbols (functions, classes, types) with line numbersParse a file's symbols (functions, classes, types) with line numbers
No parameter schema in public metadata yet.
project_diff_filesUnified diff between two filesUnified diff between two files
No parameter schema in public metadata yet.
project_symbol_referencesFind all occurrences of a named symbolFind all occurrences of a named symbol
No parameter schema in public metadata yet.
project_selective_searchMulti-query search with AND/NOT + fuzzy scoringMulti-query search with AND/NOT + fuzzy scoring
No parameter schema in public metadata yet.
project_dependency_graphTS/JS/Python/Rust/Go/Java/Kotlin import/symbol graph (JSON/DOT/Mermaid)TS/JS/Python/Rust/Go/Java/Kotlin import/symbol graph (JSON/DOT/Mermaid)
No parameter schema in public metadata yet.
project_change_impactWhat breaks if I edit this? Bounded reverse/forward closureWhat breaks if I edit this? Bounded reverse/forward closure
No parameter schema in public metadata yet.
project_shell_runRun a command; background 0 blocks for final output, 1 returns run_idRun a command; background 0 blocks for final output, 1 returns run_id
No parameter schema in public metadata yet.
project_shell_statusPoll a running command (not queued, not audit-logged)Poll a running command (not queued, not audit-logged)
No parameter schema in public metadata yet.
project_shell_cancelKill a running command by run_idKill a running command by run_id
No parameter schema in public metadata yet.
project_shell_cancel_sessionKill all shell runs in this sessionKill all shell runs in this session
No parameter schema in public metadata yet.
project_pr_createGit provider PR/CI tool: create pull requestGit provider PR/CI tool: create pull request
No parameter schema in public metadata yet.
project_ci_statusGit provider PR/CI tool: CI statusGit provider PR/CI tool: CI status
No parameter schema in public metadata yet.
project_ci_waitOne bounded long-poll for CI resultOne bounded long-poll for CI result
No parameter schema in public metadata yet.
project_ci_controlCI control: cancel / retry-failedCI control: cancel / retry-failed
No parameter schema in public metadata yet.
project_secretStore/inspect/remove credentials by name; AES-256-GCMStore/inspect/remove credentials by name; AES-256-GCM
No parameter schema in public metadata yet.
project_github_connectGitHub Device Flow, tokens in vaultGitHub Device Flow, tokens in vault
No parameter schema in public metadata yet.
project_explain_errorTurn an error into a cause + next tool callsTurn an error into a cause + next tool calls
No parameter schema in public metadata yet.
project_plan_read_batchPlan which files to read for a task, returns ready project_read_batch callPlan which files to read for a task, returns ready project_read_batch call
No parameter schema in public metadata yet.
project_execute_jsRun synchronous JS (opt-in, VENIRA_ALLOW_JS_EXEC=1)Run synchronous JS (opt-in, VENIRA_ALLOW_JS_EXEC=1)
No parameter schema in public metadata yet.
Sponsors
VENIRA_WORKSPACEAbsolute path of the project folder the server works in. Defaults to the current directory.
VENIRA_DATA_DIRFolder for the audit database and encrypted secrets. Defaults to <workspace>/data.
Fast, workspace-scoped MCP server for coding agents (OpenCode, Claude Desktop, any MCP client).
Three tool modes — Core (31 tools: coding set minus code intelligence, for small models) · Default (38 coding tools + shell, no CI/CD) · Expert (51 tools: default + CI/CD). VENIRA_JS_EXEC_MODE=off hides execute_js in every mode (51 → 50, 38 → 37, 31 → 30); otherwise it is registered and approval-gated. VENIRA_SETUP_TOOLS=1 adds the two setup tools detect_harnesses and install_self (+2); npx venira-mcp --install and --print-config do the same from a terminal.
Pure Node, 1 native dependency (better-sqlite3), no GUI, no external binary.
venira-mcp