# Arnesa

> Arnesa is an open-source MCP server for developer tools. Verified rankings of AI coding-agent harnesses with local setup recommendations. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI
- **Repository:** https://github.com/arnesa-ai/arnesa-cli
- **MCP Registry name:** io.github.arnesa-ai/arnesa
- **Categories:** [developer tools](https://ai-powered.com/categories/developer-tools), [AI models and LLM tooling](https://ai-powered.com/categories/ai-and-llm)
- **Listing updated:** 2026-11-18

## About

Arnesa describes itself as an independent benchmark for AI coding-agent harnesses, and this package is its command line client plus MCP entry. It profiles your project on your machine, asks Arnesa which verified harnesses fit, and can install or remove the chosen one with backups. Point it at a deployment with the --api flag or the ARNESA_API_URL environment variable.

The README is specific about what leaves your computer. detect sends nothing. recommend and install send only a closed vocabulary of languages, frameworks and runtimes, never file names or contents. doctor lists the agent configuration files it would upload, asks first, caps uploads at 200 files, 256 KiB per file and 1 MiB total, and deletes them within an hour. Tokens go in the operating system keychain.

Install treats the server response as untrusted: files are written only into allowed agent directories after a preview and confirmation, every write is backed up under .arnesa/backups/, and arnesa remove restores the project. Rate limits are listed for anonymous and keyed callers, and Node.js 22 or newer is required.

## Features

- **Project detection:** Print your project's profile without sending anything out.
- **Harness recommendations:** Ask which verified harnesses fit your languages and frameworks.
- **Previewed installs:** Files are written only to allowed directories after confirmation.
- **Backups and removal:** Writes are backed up and arnesa remove restores the project.
- **Config scan:** doctor checks agent configuration files, uploading only after asking.
- **JSON output:** Add --json for one JSON document on stdout.

## Good for

- Find a verified harness for a TypeScript project
- Install a recommended harness with a safe preview
- Audit agent configuration files for problems
- Roll back an installed harness cleanly
- Script recommendations in CI with JSON output

## Install

### Claude Code (Terminal)

```sh
claude mcp add arnesa -- npx -y arnesa
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "arnesa": {
      "command": "npx",
      "args": [
        "-y",
        "arnesa"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "arnesa": {
      "command": "npx",
      "args": [
        "-y",
        "arnesa"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "arnesa": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "arnesa"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "arnesa": {
      "command": "npx",
      "args": [
        "-y",
        "arnesa"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "arnesa": {
      "command": "npx",
      "args": [
        "-y",
        "arnesa"
      ]
    }
  }
}
```

## FAQ

### What data leaves my machine?

detect sends nothing; recommend and install send a closed-vocabulary profile; doctor uploads only the config files it lists after asking.

### What do I need to run it?

Node.js 22 or newer, run with npx.

### What licence is it under?

MIT for the code; the Arnesa name and logo are not covered.

### What are the rate limits?

Anonymous callers get 10 recommend calls per 10 minutes; keyed callers 200 a day, with lower limits for installs.

### How are tokens stored?

In the operating system keychain, never in a file.

### Is Arnesa free?

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

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

Run this command in your terminal: claude mcp add arnesa -- npx -y arnesa

### What are the best alternatives to Arnesa?

The closest alternatives to Arnesa are REA, Context7, Chrome DevTools MCP, Codebase Memory and GitHub.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Context7](https://ai-powered.com/mcp/context7): Context7 is a freemium MCP server for developer tools.
- [Chrome DevTools MCP](https://ai-powered.com/mcp/chrome-devtools-mcp-2): Chrome DevTools MCP is an open-source MCP server for browser automation.
- [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.
- [awesome-mcp-servers](https://ai-powered.com/mcp/awesome-mcp-servers-2): awesome-mcp-servers 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.

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