# CLI reference Generated from the command-line help at build time. ## `mcaligner` ```text Usage: mcaligner [OPTIONS] COMMAND [ARGS]... LLM agents for word alignment of parallel texts. ╭─ Options ────────────────────────────────────────────────────────────────────╮ │ --version Show the version and exit. │ │ --install-completion Install completion for the current shell. │ │ --show-completion Show completion for the current shell, to copy │ │ it or customize the installation. │ │ --help Show this message and exit. │ ╰──────────────────────────────────────────────────────────────────────────────╯ ╭─ Commands ───────────────────────────────────────────────────────────────────╮ │ evaluate Precision, recall and F1 over sure and over all links, and the │ │ alignment error rate (AER). │ │ lexicon Export the bilingual lexicon: lemma -> aligned lemmas with counts │ │ and parts of speech. │ │ rules Link near-certain word pairs without a model, or measure the │ │ rules' precision (--measure). │ │ run Align with rules, then aligner/scorer agents; prints tokens and │ │ estimated cost. │ │ settings Print the settings (defaults, or a file's values with defaults │ │ filled in) as YAML. │ │ mcp MCP server over the corpora and alignment sets, with alignment │ │ exploration tools. │ ╰──────────────────────────────────────────────────────────────────────────────╯ ``` ## `mcaligner rules` ```text Usage: mcaligner rules [OPTIONS] Link near-certain word pairs without a model, or measure the rules' precision (--measure). ╭─ Options ────────────────────────────────────────────────────────────────────╮ │ * --source -s [NAME=]PATH[:ro|rw[:CONF… │ │ CoNLL-U source (default │ │ ro). Repeatable. │ │ [required] │ │ * --alignment -a NAME=SOURCE_A,SOURCE_B,P… │ │ alignment set (default │ │ rw). Repeatable. │ │ [required] │ │ --target Writable alignment set to │ │ add the rules' links to. │ │ --measure Instead of writing, │ │ measure each rule's │ │ precision against this │ │ set. │ │ --evidence Alignment sets used as │ │ lexicon evidence (default │ │ all). Repeatable. │ │ --min-count Linked occurrences needed │ │ by the lexicon rule. │ │ [default: 5] │ │ --min-share Share of occurrences that │ │ must agree. │ │ [default: 0.95] │ │ --show-errors --no-show-errors With --measure, list the │ │ links not in the │ │ reference set. │ │ [default: no-show-errors] │ │ --help Show this message and │ │ exit. │ ╰──────────────────────────────────────────────────────────────────────────────╯ ``` ## `mcaligner run` ```text Usage: mcaligner run [OPTIONS] Align with rules, then aligner/scorer agents; prints tokens and estimated cost. ╭─ Options ────────────────────────────────────────────────────────────────────╮ │ * --source -s [NAME=]PATH[:ro|r… │ │ CoNLL-U source │ │ (default ro). │ │ Repeatable. │ │ [required] │ │ * --alignment -a NAME=SOURCE_A,SOU… │ │ alignment set │ │ (default rw). │ │ Repeatable. │ │ [required] │ │ * --target Writable alignment │ │ set to fill (an │ │ --alignment name). │ │ [required] │ │ --evidence Alignment sets │ │ used as evidence │ │ (default all). │ │ Repeatable. │ │ --sentence Only these pairs │ │ (sent_id). │ │ Repeatable. │ │ --max-sentences Only the first N │ │ pairs (after │ │ --sentence). │ │ --settings YAML settings file │ │ (see `settings`). │ │ --rounds Maximum │ │ align/score │ │ rounds. │ │ --concurrency Agent tasks at the │ │ same time. │ │ --batch-sentences Sentence pairs per │ │ agent task. │ │ --threshold Links below this │ │ confidence are │ │ revisited. │ │ --model One model for │ │ every role │ │ (overrides the │ │ tiers). │ │ --strong-model Strong tier model │ │ (aligner). │ │ --efficient-model Efficient tier │ │ model (scorer). │ │ --light-model Light tier model. │ │ --aligner-model Model for the │ │ aligner (overrides │ │ its tier). │ │ --scorer-model Model for the │ │ scorer (overrides │ │ its tier). │ │ --strong-thinking Reasoning effort │ │ for the strong │ │ tier: off, on, │ │ minimal..xhigh. │ │ --efficient-think… Reasoning effort │ │ for the efficient │ │ tier. │ │ --scorer --no-scorer Run the scorer │ │ (default from │ │ settings: on). │ │ --guidelines Annotation │ │ guidelines for the │ │ agents: a bundled │ │ name (grc-lat, the │ │ default), a file │ │ path, or none. │ │ --columns Columns shown for │ │ each word after id │ │ and form, e.g. │ │ lemma,upos,head,d… │ │ none = forms only. │ │ --tools Read tools the │ │ agents may call: │ │ all, none, or a │ │ comma-separated │ │ list. │ │ --link-punctuation --no-link-punctua… Allow links to │ │ punctuation │ │ (default: dropped │ │ in code). │ │ --report Write the run │ │ report (JSON) │ │ here. │ │ --help Show this message │ │ and exit. │ ╰──────────────────────────────────────────────────────────────────────────────╯ ``` ## `mcaligner evaluate` ```text Usage: mcaligner evaluate [OPTIONS] {predicted} {gold} Precision, recall and F1 over sure and over all links, and the alignment error rate (AER). ╭─ Arguments ──────────────────────────────────────────────────────────────────╮ │ * predicted Predicted alignment set (JSONL). [required] │ │ * gold Gold alignment set (JSONL); only its pairs are │ │ scored. │ │ [required] │ ╰──────────────────────────────────────────────────────────────────────────────╯ ╭─ Options ────────────────────────────────────────────────────────────────────╮ │ --annotated-only --no-annotated-only Score only pairs with at │ │ least one predicted │ │ link. │ │ [default: │ │ no-annotated-only] │ │ --min-confidence Ignore predicted links │ │ below this confidence. │ │ [default: 0.0] │ │ --per-sentence --no-per-sentence Print a row per sentence │ │ pair. │ │ [default: │ │ no-per-sentence] │ │ --json Print the full report as │ │ JSON. │ │ --help Show this message and │ │ exit. │ ╰──────────────────────────────────────────────────────────────────────────────╯ ``` ## `mcaligner lexicon` ```text Usage: mcaligner lexicon [OPTIONS] Export the bilingual lexicon: lemma -> aligned lemmas with counts and parts of speech. ╭─ Options ────────────────────────────────────────────────────────────────────╮ │ * --source -s [NAME=]PATH[:ro|rw[:CONFIDENCE]] │ │ CoNLL-U source (default ro). │ │ Repeatable. │ │ [required] │ │ * --alignment -a NAME=SOURCE_A,SOURCE_B,PATH[:ro|rw[:C… │ │ alignment set (default rw). │ │ Repeatable. │ │ [required] │ │ --output -o YAML (or .json) file; default stdout. │ │ --use Alignment sets to count (default all). │ │ Repeatable. │ │ --min-confidence Only links at least this confident │ │ count. │ │ [default: 0.8] │ │ --min-count Keep translations seen at least this │ │ often. │ │ [default: 1] │ │ --top Keep at most this many translations │ │ per lemma. │ │ --help Show this message and exit. │ ╰──────────────────────────────────────────────────────────────────────────────╯ ``` ## `mcaligner settings` ```text Usage: mcaligner settings [OPTIONS] Print the settings (defaults, or a file's values with defaults filled in) as YAML. ╭─ Options ────────────────────────────────────────────────────────────────────╮ │ --settings YAML settings file to check and show. │ │ --help Show this message and exit. │ ╰──────────────────────────────────────────────────────────────────────────────╯ ``` ## `mcaligner mcp serve` ```text Usage: mcaligner mcp serve [OPTIONS] Serve sources and alignment sets over MCP (stdio for Claude Desktop, or streamable HTTP). ╭─ Options ────────────────────────────────────────────────────────────────────╮ │ * --source -s [NAME=]PATH[:ro|rw[:CONFID… │ │ Repeat for several sources. │ │ Default mode is ro. │ │ [required] │ │ --transport MCP transport. │ │ [default: stdio] │ │ --host Host for streamable-http. │ │ [default: 127.0.0.1] │ │ --port Port for streamable-http. │ │ [default: 8000] │ │ --read-only Register only the read-only │ │ tools. │ │ --root-key MISC attribute holding the │ │ word's root. │ │ [default: Root] │ │ --name Server name shown to MCP │ │ clients. │ │ [default: mcaligner] │ │ --alignment -a NAME=SOURCE_A,SOURCE_B,PAT… │ │ word alignments between two │ │ sources. Repeatable. │ │ --corpus [NAME=]PATH[,PATH...]: │ │ unannotated text (one │ │ sentence or paragraph per │ │ line) that agents can │ │ search for how a word is │ │ used. Repeatable. │ │ --help Show this message and exit. │ ╰──────────────────────────────────────────────────────────────────────────────╯ ``` ## `mcaligner mcp config` ```text Usage: mcaligner mcp config [OPTIONS] Print the JSON to add to Claude Desktop's claude_desktop_config.json. ╭─ Options ────────────────────────────────────────────────────────────────────╮ │ * --source -s [NAME=]PATH[:ro|rw[:CONFIDENCE]]. Repeat for │ │ several sources. Default mode is ro. │ │ [required] │ │ --read-only Register only the read-only tools. │ │ --root-key MISC attribute holding the word's root. │ │ [default: Root] │ │ --name Server name shown to MCP clients. │ │ [default: mcaligner] │ │ --alignment -a NAME=SOURCE_A,SOURCE_B,PATH[:ro|rw[:CONFIDEN… │ │ word alignments between two sources. │ │ Repeatable. │ │ --corpus [NAME=]PATH[,PATH...]: unannotated text (one │ │ sentence or paragraph per line) that agents │ │ can search for how a word is used. │ │ Repeatable. │ │ --help Show this message and exit. │ ╰──────────────────────────────────────────────────────────────────────────────╯ ```