# Jev agent tools

This MCP server asks evidence-based repository questions, reviews finished diffs, and selects existing tests when code needs investigation.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 10
- Author: NomenAK
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/NomenAK/jev-tools
- Updated: 2026-10-07
- HTML: https://affpapa.org/en/nevibecode/mcp/jev-agent-tools

## What it does

Jev agent tools exposes six MCP tools for exploring unfamiliar repositories, asking typed questions about code evidence, checking completed changes, and choosing tests already present in the project. It works alongside ordinary reading, search, and command execution rather than replacing them.

The package runs as a stdio server and reads `JEV_TOOLS_URL`, `JEV_TOOLS_API_KEY`, `JEV_TOOLS_MODEL`, and `JEV_TOOLS_ALLOW_COMMAND`. Node.js 24 or newer is required. Git and Bash are needed when optional command evidence is enabled. Without Node.js 24 or newer, the server will not start.

You can register it with a host command or an `npx` MCP configuration. A saved API key is kept in plain text, so that storage choice matters when enabling persistent configuration.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `JEV_TOOLS_URL`, `JEV_TOOLS_API_KEY`, `JEV_TOOLS_MODEL`, `JEV_TOOLS_ALLOW_COMMAND` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env JEV_TOOLS_URL=<JEV_TOOLS_URL> --env JEV_TOOLS_API_KEY=<JEV_TOOLS_API_KEY> --env JEV_TOOLS_MODEL=<JEV_TOOLS_MODEL> --env JEV_TOOLS_ALLOW_COMMAND=<JEV_TOOLS_ALLOW_COMMAND> --transport stdio jev-agent-tools -- npx -y jev-agent-tools
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add jev-agent-tools --env JEV_TOOLS_URL=<JEV_TOOLS_URL> --env JEV_TOOLS_API_KEY=<JEV_TOOLS_API_KEY> --env JEV_TOOLS_MODEL=<JEV_TOOLS_MODEL> --env JEV_TOOLS_ALLOW_COMMAND=<JEV_TOOLS_ALLOW_COMMAND> -- npx -y jev-agent-tools
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "jev-agent-tools": {
            "command": "npx",
            "args": [
                "-y",
                "jev-agent-tools"
            ],
            "env": {
                "JEV_TOOLS_URL": "<JEV_TOOLS_URL>",
                "JEV_TOOLS_API_KEY": "<JEV_TOOLS_API_KEY>",
                "JEV_TOOLS_MODEL": "<JEV_TOOLS_MODEL>",
                "JEV_TOOLS_ALLOW_COMMAND": "<JEV_TOOLS_ALLOW_COMMAND>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "jev-agent-tools": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "jev-agent-tools"
            ],
            "env": {
                "JEV_TOOLS_URL": "<JEV_TOOLS_URL>",
                "JEV_TOOLS_API_KEY": "<JEV_TOOLS_API_KEY>",
                "JEV_TOOLS_MODEL": "<JEV_TOOLS_MODEL>",
                "JEV_TOOLS_ALLOW_COMMAND": "<JEV_TOOLS_ALLOW_COMMAND>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e JEV_TOOLS_URL=<JEV_TOOLS_URL> -e JEV_TOOLS_API_KEY=<JEV_TOOLS_API_KEY> -e JEV_TOOLS_MODEL=<JEV_TOOLS_MODEL> -e JEV_TOOLS_ALLOW_COMMAND=<JEV_TOOLS_ALLOW_COMMAND> jev-agent-tools npx -y jev-agent-tools
```
Replace <…> with your own values

## When to use it
- navigate an unfamiliar repository
- answer questions from repository evidence
- review completed code changes
- select existing tests to run

## Example prompts
- Inspect this repository and answer the question using evidence from the relevant files.
- Review the completed changes and connect each finding to the code that supports it.
- Select the existing tests that should cover these changes.

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119160
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47392
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43872

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
