Skip to content
MCP server

Aethis MCP

Eligibility decisions from compiled rules, with an explanation and no LLM at decision time

Runs locallyStatus and history
Install
Pricing
Freemium
Platforms
API, CLI
Runs
Locally
Version
0.24.0
Listing updated
3 days ago

About Aethis MCP

Aethis MCP is a freemium MCP server for legal and government. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

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

Add to claude_desktop_config.json

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

Add to ~/.cursor/mcp.json

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

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Configuration

  • AETHIS_API_KEYAPI key for rule authoring tools (create/generate/publish). Decision tools (decide/schema/explain on public rulesets) work without a key. Get one via 'aethis login' in aethis-cli.
  • AETHIS_BASE_URLAPI base URL. Defaults to https://api.aethis.ai — override for self-hosted or staging.

Tools this server provides (7)

Taken from the project documentation; the running server may differ.

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.

What it does

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

Pricing

Freemium

Public decisions free; authoring in invite-only beta

Prices change. Check docs.aethis.ai before you buy.

Aethis MCP 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 to Aethis MCP

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools