An MCP (Model Context Protocol) server that provides Icelandic word inflection lookups using BinPackage.
This server enables LLMs to query the Database of Icelandic Morphology (BÍN) to answer questions about Icelandic word inflections, such as:
- "Hvernig beygist orðið hestur?" (How does the word hestur inflect?)
- "Hvað er þágufall fleirtölu af kona?" (What is the dative plural of kona?)
- "Er síamskattarkjóll rétt orð?" (Is síamskattarkjóll a correct word?)
pip install icelandic-morphology-mcpOr install from source:
git clone https://github.com/mideind/icelandic-morphology-mcp
cd icelandic-morphology-mcp
pip install -e .The server exposes three tools:
Look up an Icelandic word form and return all matching entries.
lookup_word("færi")
# Returns all interpretations: verb forms of "fara", "færa", noun "færi", etc.Get a specific grammatical variant of a word.
get_variant("hestur", "kk", ["ÞGF", "FT"])
# Returns: "hestum" (dative plural)
get_variant("fallegur", "lo", ["EVB", "KVK"])
# Returns: "fallegasta" (superlative weak, feminine)Find the lemma(s) and word class(es) for a word form.
get_lemma("hestana")
# Returns: [{"lemma": "hestur", "word_class": "kk"}]Add to your Claude Desktop configuration (claude_desktop_config.json):
{
"mcpServers": {
"icelandic-morphology": {
"command": "icelandic-morphology-mcp"
}
}
}Or if running from source:
{
"mcpServers": {
"icelandic-morphology": {
"command": "python",
"args": ["-m", "icelandic_mcp.server"],
"cwd": "/path/to/icelandic-morphology-mcp"
}
}
}The server uses standard BÍN grammatical tags:
| Tag | Meaning |
|---|---|
NF, ÞF, ÞGF, EF |
Cases: nominative, accusative, dative, genitive |
ET, FT |
Number: singular, plural |
gr, nogr |
Article: definite, indefinite |
kk, kvk, hk |
Gender: masculine, feminine, neuter |
so, lo, no |
Class: verb, adjective, noun |
FSB, FVB, MST, ESB, EVB |
Adjective degree/form |
GM, MM |
Voice: active, middle |
FH, VH, NH |
Mood: indicative, subjunctive, infinitive |
NT, ÞT |
Tense: present, past |
1P, 2P, 3P |
Person: 1st, 2nd, 3rd |
For full documentation, see BÍN tagset.
MIT License. See LICENSE for details.
The underlying BÍN data is licensed under CC BY-SA 4.0 by The Árni Magnússon Institute for Icelandic Studies.
- BinPackage by Miðeind ehf.
- Database of Icelandic Morphology (BÍN) by The Árni Magnússon Institute