# Icelandic Morphology MCP Server
An MCP (Model Context Protocol) server that provides Icelandic word inflection lookups using [BinPackage](https://github.com/mideind/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?)
## Installation
```bash
pip install icelandic-morphology-mcp
```
Or install from source:
```bash
git clone https://github.com/mideind/icelandic-morphology-mcp
cd icelandic-morphology-mcp
pip install -e .
```
## Tools
The server exposes three tools:
### `lookup_word`
Look up an Icelandic word form and return all matching entries.
```python
lookup_word("færi")
# Returns all interpretations: verb forms of "fara", "færa", noun "færi", etc.
```
### `get_variant`
Get a specific grammatical variant of a word.
```python
get_variant("hestur", "kk", ["ÞGF", "FT"])
# Returns: "hestum" (dative plural)
get_variant("fallegur", "lo", ["EVB", "KVK"])
# Returns: "fallegasta" (superlative weak, feminine)
```
### `get_lemma`
Find the lemma(s) and word class(es) for a word form.
```python
get_lemma("hestana")
# Returns: [{"lemma": "hestur", "word_class": "kk"}]
```
## Usage with Claude Desktop
Add to your Claude Desktop configuration (`claude_desktop_config.json`):
```json
{
"mcpServers": {
"icelandic-morphology": {
"command": "icelandic-morphology-mcp"
}
}
}
```
Or if running from source:
```json
{
"mcpServers": {
"icelandic-morphology": {
"command": "python",
"args": ["-m", "icelandic_mcp.server"],
"cwd": "/path/to/icelandic-morphology-mcp"
}
}
}
```
## Grammatical Tags
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](https://bin.arnastofnun.is/DMII/LTdata/tagset/).
## License
MIT License. See [LICENSE](LICENSE) for details.
The underlying BÍN data is licensed under [CC BY-SA 4.0](https://creativecommons.org/licenses/by-sa/4.0/) by The Árni Magnússon Institute for Icelandic Studies.
## Credits
- [BinPackage](https://github.com/mideind/BinPackage) by Miðeind ehf.
- [Database of Icelandic Morphology (BÍN)](https://bin.arnastofnun.is/) by The Árni Magnússon Institute
