# Agnes

> Agnes is a freemium MCP server for developer tools. Read frontend code-health reports and rank fixes by points gained, via Agnes. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $20 a month
- **Platforms:** API, Web
- **Website:** https://agnes.dev/agents
- **MCP Registry name:** dev.agnes/agnes
- **Categories:** developer tools, security
- **Listing updated:** 2026-11-14

## About

Agnes scores frontend repositories, and this server lets an AI agent read those scores for your team. The agent can list projects, open a report, see which checks did not run and pull findings 50 per page, filtered by rule, category, severity or folder, each with file, line and a link to the rule.

The most useful call for planning is rank_fixes, which orders rules by the points their findings cost and shows how many points fixing each would gain. The agent can also fetch get_scoring so it can explain how findings turn into scores, and get_sbom for a CycloneDX software bill of materials with every installed package, its licence and known vulnerabilities.

Access is read-only and limited to the team a token was created in. Claude and ChatGPT can connect as a custom connector and sign in, or you can create a token under Settings, API and agents. An optional skill file walks the agent through reading the report, checking each finding in your code and writing a plan for you to approve before it changes anything.

## Features

- **Ranked fixes:** Lists rules by the points their findings cost and how many points each fix would gain.
- **Paged findings:** Returns 50 findings per page, filterable by rule, category, severity or folder, with file and line.
- **Per-category report:** Shows the overall score, scores per category and which checks did not run.
- **SBOM export:** Returns a CycloneDX bill of materials with packages, licences and known vulnerabilities.
- **Read-only access:** Tokens only read reports for the team they were created in and can be revoked at any time.
- **Plan-first skill:** An optional skill asks the agent to write a plan and wait for approval before changing code.

## Good for

- Ask an agent to plan how to raise a repository's health score
- Find which rule violations cost the most points
- Review a project's dependency licences and vulnerabilities
- Check which findings sit in a particular folder
- Explain to a team how scores are calculated

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http agnes https://app.agnes.dev/api/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://app.agnes.dev/api/mcp
```

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

```json
{
  "mcpServers": {
    "agnes": {
      "url": "https://app.agnes.dev/api/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "agnes": {
      "type": "http",
      "url": "https://app.agnes.dev/api/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "agnes": {
      "serverUrl": "https://app.agnes.dev/api/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "agnes": {
      "type": "http",
      "url": "https://app.agnes.dev/api/mcp"
    }
  }
}
```

## Tools

- `list_projects`: The projects of your team: each repository branch Agnes analyses, with its latest score.
- `get_report`: The overall score, the score per category, the findings per category and severity, and which checks did not run, for a project's latest successful analysis.
- `rank_fixes`: The rules whose findings cost the project the most points. Each entry says how many points the overall score and its category would gain if every finding of that rule were fixed (the report rescored without them), with one example finding.
- `get_findings`: A project's findings, most severe first, 50 per page, with file, line, message and a documentation link where there is one. Filter by rule, category, severity or file (or folder).
- `get_sbom`: The software bill of materials of a project's latest successful analysis (or the given run) as CycloneDX 1.6 JSON: every installed package with its purl, licence where known and dependencies, and the known vulnerabilities that affect them. Large for big projects; save it to a file rather than reading it all.
- `get_scoring`: How Agnes turns findings into scores: the categories, their weights in the overall score, and how severity, confidence and codebase size count.

## FAQ

### Does the agent change my code or Agnes settings?

No. The tools only read reports, and the optional workflow asks the agent to wait for your approval before changing code.

### How do I connect?

Add the address https://app.agnes.dev/api/mcp as a custom connector and sign in, or use a token with a Bearer header in Claude Code, Cursor or VS Code.

### What does Agnes cost?

There is a free plan; paid plans are Essentials at $20, Pro at $50 and Premium at $100 per month.

### Is open source analysed for free?

Yes. On every plan up to 10 public repositories of up to 100,000 lines each are analysed free.

### Is Agnes free?

Agnes has a free plan, with paid plans for more usage or features. Paid plans start at $20 a month.

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

Run this command in your terminal: claude mcp add --transport http agnes https://app.agnes.dev/api/mcp

### What are the best alternatives to Agnes?

The closest alternatives to Agnes 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/agnes
