VITNA — Claude Code MCP server: what it does and install
Intercepts stdio MCP server calls and halts risky tool actions until human approval. Keeps AI agents inside explicit execution boundaries.
claude mcp add --transport http vitna-compliance-preflight https://vitna.costrinity.xyz/api/mcpWhat VITNA – Containment for rogue AI agents does
VITNA wraps stdio MCP servers to inspect tool calls before execution. When a client triggers tools/call, the guard checks the requested tool against a JSON policy file set in VITNA_GUARD_POLICY. If an action matches hold rules, VITNA pauses the process until an operator confirms it in the web dashboard or the holding window expires.
Beyond stdio wrapping, the package provides 23 preflight compliance tools covering 24 statutory frameworks across 13 legal jurisdictions. Each check yields an immediate status of allowed, blocked, or flagged. Claiming an account with a passkey or GitHub enables cryptographically signed records that can be verified offline.
The guard only controls servers wrapped behind its process. A client's native terminal shell or any server launched without the guard bypasses enforcement completely.
What it helps with
- pause risky file modifications until a human approves them
- evaluate agent actions against statutory compliance rules
- keep signed audit receipts of tool execution decisions
- block unapproved tool calls across stdio MCP servers
Example prompts for the agent
- Wrap the filesystem server using VITNA guard and
policy.json - Run a preflight compliance check before editing this configuration
How to install VITNA – Containment for rogue AI agents
1Platform CLI: remote server
claude mcp add --transport http vitna-compliance-preflight https://vitna.costrinity.xyz/api/mcp2Platform CLI
claude mcp add --env VITNA_OWNER_ID=<VITNA_OWNER_ID> --env VITNA_API_KEY=<VITNA_API_KEY> --env VITNA_EMAIL=<VITNA_EMAIL> --env VITNA_BASE_URL=<VITNA_BASE_URL> --env VITNA_OPEN_CLAIM=<VITNA_OPEN_CLAIM> --transport stdio vitna-containment-for-rogue-ai-agents -- npx -y @costrinity/vitna-compliance-mcpReplace <…> with your own values
1Platform CLI: remote server
codex mcp add vitna-containment-for-rogue-ai-agents --url https://vitna.costrinity.xyz/api/mcp2Platform CLI
codex mcp add vitna-containment-for-rogue-ai-agents --env VITNA_OWNER_ID=<VITNA_OWNER_ID> --env VITNA_API_KEY=<VITNA_API_KEY> --env VITNA_EMAIL=<VITNA_EMAIL> --env VITNA_BASE_URL=<VITNA_BASE_URL> --env VITNA_OPEN_CLAIM=<VITNA_OPEN_CLAIM> -- npx -y @costrinity/vitna-compliance-mcpReplace <…> with your own values
Config file
{
"mcpServers": {
"vitna-containment-for-rogue-ai-agents": {
"url": "https://vitna.costrinity.xyz/api/mcp"
}
}
}{
"mcpServers": {
"vitna-containment-for-rogue-ai-agents": {
"command": "npx",
"args": [
"-y",
"@costrinity/vitna-compliance-mcp"
],
"env": {
"VITNA_OWNER_ID": "<VITNA_OWNER_ID>",
"VITNA_API_KEY": "<VITNA_API_KEY>",
"VITNA_EMAIL": "<VITNA_EMAIL>",
"VITNA_BASE_URL": "<VITNA_BASE_URL>",
"VITNA_OPEN_CLAIM": "<VITNA_OPEN_CLAIM>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"vitna-containment-for-rogue-ai-agents": {
"type": "http",
"url": "https://vitna.costrinity.xyz/api/mcp"
}
}
}{
"servers": {
"vitna-containment-for-rogue-ai-agents": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@costrinity/vitna-compliance-mcp"
],
"env": {
"VITNA_OWNER_ID": "<VITNA_OWNER_ID>",
"VITNA_API_KEY": "<VITNA_API_KEY>",
"VITNA_EMAIL": "<VITNA_EMAIL>",
"VITNA_BASE_URL": "<VITNA_BASE_URL>",
"VITNA_OPEN_CLAIM": "<VITNA_OPEN_CLAIM>"
}
}
}
}Replace <…> with your own values
1Platform CLI: remote server
gemini mcp add -t http vitna-containment-for-rogue-ai-agents https://vitna.costrinity.xyz/api/mcp2Platform CLI
gemini mcp add -e VITNA_OWNER_ID=<VITNA_OWNER_ID> -e VITNA_API_KEY=<VITNA_API_KEY> -e VITNA_EMAIL=<VITNA_EMAIL> -e VITNA_BASE_URL=<VITNA_BASE_URL> -e VITNA_OPEN_CLAIM=<VITNA_OPEN_CLAIM> vitna-containment-for-rogue-ai-agents npx -y @costrinity/vitna-compliance-mcpReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about VITNA – Containment for rogue AI agents
How to install VITNA in Claude Code?
Run claude mcp add --transport http vitna-containment-for-rogue-ai-agents https://vitna.costrinity.xyz/api/mcp in your terminal.
What does VITNA do?
It monitors tool invocations, suspending risky operations until an operator approves or denies them in the dashboard.
Does VITNA intercept agent terminal commands?
No. It monitors only stdio servers placed directly behind its wrapper; native shells remain outside the guard.
