arlis-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@arlis-mcp Can an employer dismiss an employee during sick leave under Armenian law?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
ArmLaw
Legal research on Armenian law for AI assistants, powered by ARLIS.
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-researchskill: 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 | shWindows PowerShell:
irm https://astral.sh/uv/install.ps1 | iexCheck 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 shPowerShell, 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 --jsonFor 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-lawRun /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 listStart 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/nullPowerShell:
git clone https://github.com/MMinasyan/arm-law.git arm-law-warmup
Set-Location arm-law-warmup
$null | uvx --python ">=3.11" --from . arlis-mcpReuse 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
limitto set the maximum number of entries (default: 5); duplicates can appear.get_actreturns 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.pyWith Claude Code installed, also run claude plugin test ..
Build a Python wheel from the repository with:
uv build --wheelThe 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 toolsget_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
Scored across 2 tools
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.
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.
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.
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
Related MCP Connectors
Current law as data for AI: search, read and verify statutes and citations. CIS countries first.
Resolve, search and verify legal citations against the official sources, with provenance.
Verify legal citations and search case law and legislation from your AI assistant.
Official EU and national law for AI assistants: cited provisions as in force on any date.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceProvides 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.1MIT
- AlicenseNot gradedqualityBmaintenanceProvides AI assistants with up-to-date legal documents from official sources, enabling accurate legal information retrieval and analysis.21AGPL 3.0
- AlicenseNot gradedqualityFmaintenanceEnables querying and searching Romanian legislation, including statutes, provisions, and EU law integration, directly from AI clients.57 npm5Apache 2.0
- AlicenseNot gradedqualityFmaintenanceEnables AI assistants to search, retrieve, validate, and cross-reference Hungarian statutes and EU law, including full-text provisions, citation checks, and compliance status via MCP.55 npmApache 2.0