# Aethis MCP

> Aethis MCP is a freemium MCP server for legal and government. Eligibility decisions from compiled rules, with an explanation and no LLM at decision time. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API, CLI
- **Website:** https://docs.aethis.ai
- **Repository:** https://github.com/aethis-ai/aethis-mcp
- **MCP Registry name:** io.github.Aethis-ai/aethis-mcp
- **Categories:** legal and government, developer tools
- **Listing updated:** 2026-11-14

## About

Aethis compiles source documents into deterministic rules, then answers eligibility questions in under a millisecond with the reasons behind the answer. The MCP server has 36 tools across six groups; decision tools work against public rulesets with no key, while authoring tools (create, generate, publish) need an AETHIS_API_KEY and are in invite-only private beta.

Decision tools return a decision, ruleset version and fields evaluated, and can guide a user to the shortest path to a determination through next-question and explain tools. The docs example uses a UK free school meals child-eligibility ruleset. It runs locally over stdio from npm and the API base URL can be overridden for self-hosted or staging use.

## Features

- **Deterministic decisions:** Same inputs give the same decision, with no model at decision time.
- **Explanations:** Explains why a decision was reached and why one failed.
- **Next-question guidance:** Suggests the shortest path to a determination.
- **Public ruleset catalogue:** Browse and decide against published rulesets without a key.
- **Rule authoring:** Private beta tools compile documents into tested rules.

## Good for

- Check eligibility against a published ruleset
- Explain a decision to an applicant
- Author rules from policy documents
- Graph how rules depend on each other

## Install

### Claude Code (Terminal)

```sh
claude mcp add aethis-mcp --env AETHIS_API_KEY='<AETHIS_API_KEY>' -- npx -y aethis-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "aethis-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "aethis-mcp"
      ],
      "env": {
        "AETHIS_API_KEY": "<AETHIS_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "aethis-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "aethis-mcp"
      ],
      "env": {
        "AETHIS_API_KEY": "<AETHIS_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "aethis-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "aethis-mcp"
      ],
      "env": {
        "AETHIS_API_KEY": "<AETHIS_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "aethis-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "aethis-mcp"
      ],
      "env": {
        "AETHIS_API_KEY": "<AETHIS_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "aethis-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "aethis-mcp"
      ],
      "env": {
        "AETHIS_API_KEY": "<AETHIS_API_KEY>"
      }
    }
  }
}
```

## Tools

- `aethis_decide`: Decides against a ruleset.
- `aethis_schema`: Reads a ruleset's schema.
- `aethis_next_question`: Suggests the next question to ask.
- `aethis_explain`: Explains a ruleset or decision.
- `aethis_explain_failure`: Explains why a decision failed.
- `aethis_graph`: Graphs a ruleset.
- `aethis_discover_rulesets`: Browses the public catalogue.

## FAQ

### Do I need a key?

Not for decision tools on public rulesets; authoring needs AETHIS_API_KEY.

### Is authoring open?

It is an invite-only private beta.

### How many tools?

36 across six groups.

### Can I point it elsewhere?

Yes, set AETHIS_BASE_URL.

### Is Aethis MCP free?

Aethis MCP has a free plan, with paid plans for more usage or features.

### How do I add Aethis MCP to Claude Code?

Run this command in your terminal: claude mcp add aethis-mcp --env AETHIS_API_KEY='<AETHIS_API_KEY>' -- npx -y aethis-mcp

### What are the best alternatives to Aethis MCP?

The closest alternatives to Aethis MCP 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/aethis-mcp
