Skip to main content
Glama

ArmLaw

Legal research on Armenian law for AI assistants, powered by ARLIS.

License: MIT Agent Plugins 1.0.0

ArmLaw combines a research skill for Armenian law with tools for searching ARLIS and retrieving documents.

Features

  • search_acts: find ARLIS acts by title or content, filter by status and enactment date.

  • get_act: download any ARLIS act, save it as Markdown with metadata and cross-links.

  • arlis-research skill: instructions covering act hierarchy, statutory authorisation, interpretation of provisions, collisions, temporal applicability, court decisions and application to facts.

  • Bundled text of the Law on Regulatory Legal Acts, in Armenian and English.

Related MCP server: Law7 MCP

Quickstart

See Installation for setup commands.

Example question:

Can an employer dismiss an employee during sick leave under Armenian law?
Cite the provisions and explain any exceptions.

The assistant searches ARLIS, reads the saved acts and answers with citations.

Usage

  • Explain a provision: conditions, definitions, exceptions, consequences.

  • Apply the law to facts: qualify each condition, state what must be proved.

  • Compare provisions: scope, legal force, collision rules.

  • Check a statement or citation against the retrieved text.

  • Find Cassation Court or ECtHR decisions on a question.

For the full method, read skills/arlis-research/SKILL.md.

Installation

Use the host's Agent Plugins 1.0 installer with this repository or an unchanged checkout. The repository root is the plugin.

Runtime prerequisite

The MCP backend needs uvx, which ships with uv. uv installs Python 3.11+ and dependencies on first start.

macOS/Linux:

curl -LsSf https://astral.sh/uv/install.sh | sh

Windows PowerShell:

irm https://astral.sh/uv/install.ps1 | iex

Check uvx --version in the environment that launches MCP servers. A desktop app may not inherit the terminal's PATH. If it cannot find uvx, install uv into a trusted directory already on the backend's PATH using UV_INSTALL_DIR.

POSIX, with UV_BIN_DIR set to that directory:

curl -LsSf https://astral.sh/uv/install.sh | env UV_INSTALL_DIR="$UV_BIN_DIR" UV_NO_MODIFY_PATH=1 sh

PowerShell, with $uvBinDir set to that directory:

$oldInstallDir = $env:UV_INSTALL_DIR
$oldNoModifyPath = $env:UV_NO_MODIFY_PATH
try {
    $env:UV_INSTALL_DIR = $uvBinDir
    $env:UV_NO_MODIFY_PATH = "1"
    irm https://astral.sh/uv/install.ps1 | iex
} finally {
    $env:UV_INSTALL_DIR = $oldInstallDir
    $env:UV_NO_MODIFY_PATH = $oldNoModifyPath
}

The installer replaces existing uv binaries in the target directory; inspect an existing installation first. Keep mcp.json unchanged and retry startup.

ChatGPT desktop

Request write access to the Codex data directory (CODEX_HOME, default ~/.codex), not individual files such as config.toml.

codex --enable plugins plugin marketplace add MMinasyan/arm-law
codex --enable plugins plugin add arm-law@arm-law --json
codex --enable plugins plugin list --marketplace arm-law --json

For a branch or tag, add --ref <ref> to the first command. The feature flag applies only to these commands; plugin support must also be enabled in the host. Check that the result lists arm-law@arm-law as installed and enabled.

Claude Code

Requires Claude Code 2.1.309 or later.

claude plugin install arm-law --marketplace MMinasyan/arm-law

Run /reload-plugins or start a new session to load the plugin. Acts are saved to .arlis/ in the session folder. The plugin lets Claude Code read the skill's bundled references without asking.

Hermes Agent

hermes plugins install MMinasyan/arm-law --enable
hermes plugins list

Start a new Hermes chat after installation to load the MCP tools. No manual MCP configuration is needed. Verify by calling search_acts; the development tests below are not required for installation.

hermes plugins doctor may report 0 tool(s), 0 hook(s) for this plugin. That is expected: search_acts and get_act are exposed through MCP, not native Hermes registrations.

First start

If the host times out while uv downloads Python and dependencies, warm the cache from a checkout in a writable directory, then retry plugin loading.

POSIX:

git clone https://github.com/MMinasyan/arm-law.git arm-law-warmup
cd arm-law-warmup
uvx --python ">=3.11" --from . arlis-mcp </dev/null

PowerShell:

git clone https://github.com/MMinasyan/arm-law.git arm-law-warmup
Set-Location arm-law-warmup
$null | uvx --python ">=3.11" --from . arlis-mcp

Reuse an existing checkout when available. Closed stdin lets the server exit after environment setup. This warms the cache; it does not install the plugin.

Verification

Confirm the arlis-research skill and both tools are available. Search with search_acts, retrieve a result with get_act, and read the saved Markdown.

Updates

Updates are managed by the host's plugin manager. Git marketplace installations can fetch updates from the configured branch; fixed commits remain pinned. Start a new chat after updating the bundled skill.

Run claude plugin update arm-law@arm-law.

Notes

  • Search returns the latest versions in ARLIS's default order. Use limit to set the maximum number of entries (default: 5); duplicates can appear.

  • get_act returns a file path; the assistant must read the file to use the text. Files are saved to .arlis under the host's PLUGIN_DATA directory, or under the server working directory when PLUGIN_DATA is unset or empty, unless output_dir is set.

  • A cloud-only assistant cannot read saved files through an MCP tunnel; local execution is required.

  • The server sends queries to ARLIS; tool results and text the assistant reads go to the client's model provider.

Development

From a writable checkout, run the checks without creating a project environment:

uv run --no-project --python ">=3.11" --with ".[verify]" python -B test_search.py
uv run --no-project --python ">=3.11" --with ".[verify]" python -B test_act.py
uv run --no-project --python ">=3.11" --with ".[verify]" python -B test_plugin.py

With Claude Code installed, also run claude plugin test ..

Build a Python wheel from the repository with:

uv build --wheel

The wheel goes into dist/. It is a Python-package artifact, not a separate self-contained plugin bundle; the repository directory remains the plugin.

Contributing

Open an issue or pull request at MMinasyan/arm-law.

License

MIT.

Available Tools

2 tools
get_actA

Fetch one ARLIS act URL and save it as a local markdown file.

Writes the act's plain-text metadata followed by its full text as markdown to <output_dir>/.md (default directory .arlis under PLUGIN_DATA, or the server working directory if PLUGIN_DATA is unset or empty). Returns only the absolute saved path, the metadata line range and a short line-numbered heading structure.

Inputs: url (required), output_dir.

search_actsA

Search ARLIS for acts and return their titles, URLs and metadata. Latest versions only, in ARLIS's default order. Use get_act to retrieve the text. Use only the search_string parameter; others default to what you will need in 99% of cases. Don't use optional parameters without a reason.

Inputs: search_string (required), limit, active, data_after, +3 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.2/5.0

    Scored across 2 tools

    Disambiguation5/5

    The two tools have clearly distinct roles: search_acts discovers acts and returns metadata/URLs, while get_act retrieves and saves the full text for a specific act URL. There is no realistic ambiguity about which tool to use for discovery versus retrieval.

    Naming Consistency5/5

    Both names follow the same snake_case verb_noun convention: search_acts and get_act. The pattern is predictable and directly reflects each tool's action.

    Tool Count4/5

    Two tools are slightly thin for the generic 3–15 range, but they map cleanly to the server's narrow search-and-retrieve purpose. Neither tool feels redundant or extraneous.

    Completeness4/5

    The surface covers the core workflow of finding an act and fetching its text, with metadata and local file output. Minor gaps exist around pagination, version handling, or more structured retrieval, but the main use case is supported.

    Maintenance

    ActivityActive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Provides programmatic access to Turkey's Ministry of Justice Legislation Information System (mevzuat.gov.tr), enabling users to search legislation, retrieve article hierarchies, and fetch article contents in Markdown format through natural language.
      1
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Provides AI assistants with up-to-date legal documents from official sources, enabling accurate legal information retrieval and analysis.
      21
      AGPL 3.0