# VERAX

> VERAX is an open-source MCP server for security. Open-source MCP gate that signs an allow, deny or hold before each agent tool call. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted, API
- **Website:** https://verax-ai.com
- **Repository:** https://github.com/verax-ai/verax
- **MCP Registry name:** io.github.verax-ai/verax
- **Categories:** security, developer tools
- **Listing updated:** 2026-11-14

## About

Think of it as a flight recorder for agents. Verax sits between an agent and its tools, and every call passes a policy gate that writes a signed decision before anything runs. Refusals are signed just like approvals, calls with no token are turned away and counted without a record, and the body will not start until authorization is configured, since there is no default token.

Calls the policy will not decide alone are held until an operator approves them at the machine or from another device with a passkey. Calls that ran leave an effect row that is later reconciled against the record. The ledger, keys and approvals stay in a local state directory, and a single-file verifier can read the ledger back without the service.

Setup needs Node 22.6 or newer and an issuer, JWKS URL, audience, state directory and policy file; the bundled default policy denies what it does not name. The demo is run with npx -y @verax-ai/body demo. The project is the gate in a family with Conarium for data masking, Tugra for memory and Cedulon for spend approvals, and the README offers a bounty of USD 100 per valid bypass report up to USD 500.

## Features

- **Signed decision records:** Every tool call gets a signed allow, deny or defer before it runs.
- **Scoped permissions:** Read, memory, act, pay, approve and audit scopes are granted one by one.
- **Human approval holds:** Sensitive calls such as spending wait for an operator, via CLI or passkey.
- **Effect reconciliation:** Calls that ran are checked against their decision records afterwards.
- **Local ledger:** Ledger, keys and approvals stay on the machine; verification does not need the service.
- **Demo command:** npx -y @verax-ai/body demo runs a temporary body and prints the signed records.

## Good for

- Put a policy gate in front of an agent's tools
- Require human approval before an agent spends money
- Keep a tamper-evident audit trail of agent actions
- Refuse unauthorised calls and still record the refusal

## Install

### Claude Code (Terminal)

```sh
claude mcp add verax --env VERAX_ISSUER='<VERAX_ISSUER>' --env VERAX_JWKS_URL='<VERAX_JWKS_URL>' --env VERAX_AUDIENCE='<VERAX_AUDIENCE>' --env VERAX_STATE_DIR='<VERAX_STATE_DIR>' --env VERAX_POLICY_FILE='<VERAX_POLICY_FILE>' -- npx -y @verax-ai/body
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "verax": {
      "command": "npx",
      "args": [
        "-y",
        "@verax-ai/body"
      ],
      "env": {
        "VERAX_ISSUER": "<VERAX_ISSUER>",
        "VERAX_JWKS_URL": "<VERAX_JWKS_URL>",
        "VERAX_AUDIENCE": "<VERAX_AUDIENCE>",
        "VERAX_STATE_DIR": "<VERAX_STATE_DIR>",
        "VERAX_POLICY_FILE": "<VERAX_POLICY_FILE>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "verax": {
      "command": "npx",
      "args": [
        "-y",
        "@verax-ai/body"
      ],
      "env": {
        "VERAX_ISSUER": "<VERAX_ISSUER>",
        "VERAX_JWKS_URL": "<VERAX_JWKS_URL>",
        "VERAX_AUDIENCE": "<VERAX_AUDIENCE>",
        "VERAX_STATE_DIR": "<VERAX_STATE_DIR>",
        "VERAX_POLICY_FILE": "<VERAX_POLICY_FILE>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "verax": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@verax-ai/body"
      ],
      "env": {
        "VERAX_ISSUER": "<VERAX_ISSUER>",
        "VERAX_JWKS_URL": "<VERAX_JWKS_URL>",
        "VERAX_AUDIENCE": "<VERAX_AUDIENCE>",
        "VERAX_STATE_DIR": "<VERAX_STATE_DIR>",
        "VERAX_POLICY_FILE": "<VERAX_POLICY_FILE>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "verax": {
      "command": "npx",
      "args": [
        "-y",
        "@verax-ai/body"
      ],
      "env": {
        "VERAX_ISSUER": "<VERAX_ISSUER>",
        "VERAX_JWKS_URL": "<VERAX_JWKS_URL>",
        "VERAX_AUDIENCE": "<VERAX_AUDIENCE>",
        "VERAX_STATE_DIR": "<VERAX_STATE_DIR>",
        "VERAX_POLICY_FILE": "<VERAX_POLICY_FILE>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "verax": {
      "command": "npx",
      "args": [
        "-y",
        "@verax-ai/body"
      ],
      "env": {
        "VERAX_ISSUER": "<VERAX_ISSUER>",
        "VERAX_JWKS_URL": "<VERAX_JWKS_URL>",
        "VERAX_AUDIENCE": "<VERAX_AUDIENCE>",
        "VERAX_STATE_DIR": "<VERAX_STATE_DIR>",
        "VERAX_POLICY_FILE": "<VERAX_POLICY_FILE>"
      }
    }
  }
}
```

## FAQ

### What does it need to run?

Node 22.6 or newer and settings for token issuer, JWKS URL, audience, state directory and policy file.

### Where is data stored?

The ledger stays on the machine the body runs on, in the configured state directory.

### What happens to a call with no token?

It is counted and turned away, and nothing is written to the ledger.

### Is it open source?

The website describes the Verax body as an open-source MCP gate.

### Is VERAX free?

Yes. VERAX is open source, so you can use and self-host it for free.

### How do I add VERAX to Claude Code?

Run this command in your terminal: claude mcp add verax --env VERAX_ISSUER='<VERAX_ISSUER>' --env VERAX_JWKS_URL='<VERAX_JWKS_URL>' --env VERAX_AUDIENCE='<VERAX_AUDIENCE>' --env VERAX_STATE_DIR='<VERAX_STATE_DIR>' --env VERAX_POLICY_FILE='<VERAX_POLICY_FILE>' -- npx -y @verax-ai/body

### What are the best alternatives to VERAX?

The closest alternatives to VERAX are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/verax
