estonian-mcp

paradigm

Read-onlyIdempotent

Generate possible inflection forms for one Estonian word, including case and verb forms, and show ambiguity from Vabamorf.

Instructions

Inflection paradigm of one Estonian word from Vabamorf, which generates what is possible, not necessarily idiomatic.

Nominals: up to 28 forms, 14 cases in singular and plural (iga has no plural), plus the short illative adt (majja beside majasse) where it exists. Verbs: about 39 common forms, impersonal included, not all Vabamorf can make. A word that does not inflect gets empty forms and a summary_estonian saying why.

forms entries: form (Vabamorf code), form_estonian (its Estonian name), surface. A list surface holds correct variants, any built on this paradigm's own stem first (raamatutele before the literary raamatuile).

Both illatives are correct and the short illative is often the commoner: never "correct" one into the other. adt is usually spelled like the singular partitive sg p (vend: venda), so a surface in this table does not confirm its case in a sentence.

paradigm_count > 1 means several inflection types (kott: koti or kota): forms is the first-ranked, named by paradigm_key (its singular genitive), and the rest are in other_paradigms, which give form_estonian only for a code forms lacks. Read ambiguity_estonian before quoting a form. Pass an inflected form (koti) to select the type you mean.

Input Schema

Name	Required	Description	Default
`word`	Yes	One Estonian word, lemma or inflected form.

Output Schema

Name	Required	Description	Default
`forms`	No
`lemma`	No
`invariant`	No
`word_class`	No
`paradigm_key`	No
`partofspeech`	No
`paradigm_count`	No
`other_paradigms`	No
`reading_estonian`	No
`summary_estonian`	No
`ambiguity_estonian`	No
`invariant_estonian`	No
`word_class_estonian`	No
`partofspeech_estonian`	No
`ranked_by_corpus_frequency`	No

Schema Changelog

Changes observed during successful MCP inspections.

Changed58 schema fields changedv0.9.0Oct 24, 2026
- changedInput schema / properties / word / description
```
Previous value: -"A single Estonian word (lemma or inflected form) to generate the full paradigm for."New value: +"One Estonian word, lemma or inflected form."
```
- removedInput schema / properties / word / title
```
Removed value: -"Word"
```
- removedInput schema / title
```
Removed value: -"paradigmArguments"
```
- removedOutput schema / properties / ambiguity_estonian / anyOf
```
Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]
```
- removedOutput schema / properties / ambiguity_estonian / default
```
Removed value: -null
```
- removedOutput schema / properties / ambiguity_estonian / title
```
Removed value: -"Ambiguity Estonian"
```
- addedOutput schema / properties / ambiguity_estonian / type
```
Added value: +"string"
```
- removedOutput schema / properties / forms / default
```
Removed value: -null
```
- removedOutput schema / properties / forms / items / additionalProperties
```
Removed value: -true
```
- removedOutput schema / properties / forms / title
```
Removed value: -"Forms"
```
- removedOutput schema / properties / input
```
Removed value: -{
-  "default": null,
-  "title": "Input",
-  "type": "string"
-}
```
- removedOutput schema / properties / invariant / anyOf
```
Removed value: -[
-  {
-    "type": "boolean"
-  },
-  {
-    "type": "null"
-  }
-]
```
- removedOutput schema / properties / invariant / default
```
Removed value: -null
```
- removedOutput schema / properties / invariant / title
```
Removed value: -"Invariant"
```
- addedOutput schema / properties / invariant / type
```
Added value: +"boolean"
```
- removedOutput schema / properties / invariant_estonian / anyOf
```
Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]
```
- removedOutput schema / properties / invariant_estonian / default
```
Removed value: -null
```
- removedOutput schema / properties / invariant_estonian / title
```
Removed value: -"Invariant Estonian"
```
- addedOutput schema / properties / invariant_estonian / type
```
Added value: +"string"
```
- removedOutput schema / properties / lemma / default
```
Removed value: -null
```
- removedOutput schema / properties / lemma / title
```
Removed value: -"Lemma"
```
- removedOutput schema / properties / note
```
Removed value: -{
-  "default": null,
-  "title": "Note",
-  "type": "string"
-}
```
- removedOutput schema / properties / other_paradigms / anyOf
```
Removed value: -[
-  {
-    "items": {
-      "additionalProperties": true,
-      "type": "object"
-    },
-    "type": "array"
-  },
-  {
-    "type": "null"
-  }
-]
```
- removedOutput schema / properties / other_paradigms / default
```
Removed value: -null
```
- addedOutput schema / properties / other_paradigms / items
```
Added value: +{
+  "type": "object"
+}
```
- removedOutput schema / properties / other_paradigms / title
```
Removed value: -"Other Paradigms"
```
- addedOutput schema / properties / other_paradigms / type
```
Added value: +"array"
```
- removedOutput schema / properties / paradigm_count / default
```
Removed value: -null
```
- removedOutput schema / properties / paradigm_count / title
```
Removed value: -"Paradigm Count"
```
- removedOutput schema / properties / paradigm_key / anyOf
```
Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]
```
- removedOutput schema / properties / paradigm_key / default
```
Removed value: -null
```
- removedOutput schema / properties / paradigm_key / title
```
Removed value: -"Paradigm Key"
```
- addedOutput schema / properties / paradigm_key / type
```
Added value: +"string"
```
- removedOutput schema / properties / partofspeech / default
```
Removed value: -null
```
- removedOutput schema / properties / partofspeech / title
```
Removed value: -"Partofspeech"
```
- removedOutput schema / properties / partofspeech_estonian / anyOf
```
Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]
```
- removedOutput schema / properties / partofspeech_estonian / default
```
Removed value: -null
```
- removedOutput schema / properties / partofspeech_estonian / title
```
Removed value: -"Partofspeech Estonian"
```
- addedOutput schema / properties / partofspeech_estonian / type
```
Added value: +"string"
```
- removedOutput schema / properties / ranked_by_corpus_frequency / anyOf
```
Removed value: -[
-  {
-    "type": "boolean"
-  },
-  {
-    "type": "null"
-  }
-]
```
- removedOutput schema / properties / ranked_by_corpus_frequency / default
```
Removed value: -null
```
- removedOutput schema / properties / ranked_by_corpus_frequency / title
```
Removed value: -"Ranked By Corpus Frequency"
```
- addedOutput schema / properties / ranked_by_corpus_frequency / type
```
Added value: +"boolean"
```
- removedOutput schema / properties / reading_estonian / anyOf
```
Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]
```
- removedOutput schema / properties / reading_estonian / default
```
Removed value: -null
```
- removedOutput schema / properties / reading_estonian / title
```
Removed value: -"Reading Estonian"
```
- addedOutput schema / properties / reading_estonian / type
```
Added value: +"string"
```
- removedOutput schema / properties / summary_estonian / default
```
Removed value: -null
```
- removedOutput schema / properties / summary_estonian / title
```
Removed value: -"Summary Estonian"
```
- removedOutput schema / properties / word_class / anyOf
```
Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]
```
- removedOutput schema / properties / word_class / default
```
Removed value: -null
```
- removedOutput schema / properties / word_class / title
```
Removed value: -"Word Class"
```
- addedOutput schema / properties / word_class / type
```
Added value: +"string"
```
- removedOutput schema / properties / word_class_estonian / anyOf
```
Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]
```
- removedOutput schema / properties / word_class_estonian / default
```
Removed value: -null
```
- removedOutput schema / properties / word_class_estonian / title
```
Removed value: -"Word Class Estonian"
```
- addedOutput schema / properties / word_class_estonian / type
```
Added value: +"string"
```
- removedOutput schema / title
```
Removed value: -"_ParadigmResult"
```

Changed25 schema fields changedv0.6.0Sep 8, 2026

addedOutput schema / properties / ambiguity_estonian / anyOf

Added value: +[
+  {
+    "type": "string"
+  },
+  {
+    "type": "null"
+  }
+]

removedOutput schema / properties / ambiguity_estonian / type
```
Removed value: -"string"
```

addedOutput schema / properties / invariant / anyOf

Added value: +[
+  {
+    "type": "boolean"
+  },
+  {
+    "type": "null"
+  }
+]

removedOutput schema / properties / invariant / type
```
Removed value: -"boolean"
```

addedOutput schema / properties / invariant_estonian / anyOf

Added value: +[
+  {
+    "type": "string"
+  },
+  {
+    "type": "null"
+  }
+]

removedOutput schema / properties / invariant_estonian / type
```
Removed value: -"string"
```

addedOutput schema / properties / lemma / anyOf

Added value: +[
+  {
+    "type": "string"
+  },
+  {
+    "type": "null"
+  }
+]

removedOutput schema / properties / lemma / type
```
Removed value: -"string"
```

addedOutput schema / properties / other_paradigms / anyOf

Added value: +[
+  {
+    "items": {
+      "additionalProperties": true,
+      "type": "object"
+    },
+    "type": "array"
+  },
+  {
+    "type": "null"
+  }
+]

removedOutput schema / properties / other_paradigms / items

Removed value: -{
-  "additionalProperties": true,
-  "type": "object"
-}

removedOutput schema / properties / other_paradigms / type
```
Removed value: -"array"
```

addedOutput schema / properties / paradigm_key / anyOf

Added value: +[
+  {
+    "type": "string"
+  },
+  {
+    "type": "null"
+  }
+]

removedOutput schema / properties / paradigm_key / type
```
Removed value: -"string"
```

addedOutput schema / properties / partofspeech / anyOf

Added value: +[
+  {
+    "type": "string"
+  },
+  {
+    "type": "null"
+  }
+]

removedOutput schema / properties / partofspeech / type
```
Removed value: -"string"
```

addedOutput schema / properties / partofspeech_estonian / anyOf

Added value: +[
+  {
+    "type": "string"
+  },
+  {
+    "type": "null"
+  }
+]

removedOutput schema / properties / partofspeech_estonian / type
```
Removed value: -"string"
```

addedOutput schema / properties / ranked_by_corpus_frequency / anyOf

Added value: +[
+  {
+    "type": "boolean"
+  },
+  {
+    "type": "null"
+  }
+]

removedOutput schema / properties / ranked_by_corpus_frequency / type
```
Removed value: -"boolean"
```

addedOutput schema / properties / reading_estonian / anyOf

Added value: +[
+  {
+    "type": "string"
+  },
+  {
+    "type": "null"
+  }
+]

removedOutput schema / properties / reading_estonian / type
```
Removed value: -"string"
```

addedOutput schema / properties / word_class / anyOf

Added value: +[
+  {
+    "type": "string"
+  },
+  {
+    "type": "null"
+  }
+]

removedOutput schema / properties / word_class / type
```
Removed value: -"string"
```

addedOutput schema / properties / word_class_estonian / anyOf

Added value: +[
+  {
+    "type": "string"
+  },
+  {
+    "type": "null"
+  }
+]

removedOutput schema / properties / word_class_estonian / type
```
Removed value: -"string"
```

Changed10 schema fields changedv0.5.6Aug 23, 2026

addedOutput schema / properties / ambiguity_estonian

Added value: +{
+  "default": null,
+  "title": "Ambiguity Estonian",
+  "type": "string"
+}

addedOutput schema / properties / invariant

Added value: +{
+  "default": null,
+  "title": "Invariant",
+  "type": "boolean"
+}

addedOutput schema / properties / invariant_estonian

Added value: +{
+  "default": null,
+  "title": "Invariant Estonian",
+  "type": "string"
+}

addedOutput schema / properties / other_paradigms

Added value: +{
+  "default": null,
+  "items": {
+    "additionalProperties": true,
+    "type": "object"
+  },
+  "title": "Other Paradigms",
+  "type": "array"
+}

addedOutput schema / properties / paradigm_count

Added value: +{
+  "default": null,
+  "title": "Paradigm Count",
+  "type": "integer"
+}

addedOutput schema / properties / paradigm_key

Added value: +{
+  "default": null,
+  "title": "Paradigm Key",
+  "type": "string"
+}

addedOutput schema / properties / partofspeech_estonian

Added value: +{
+  "default": null,
+  "title": "Partofspeech Estonian",
+  "type": "string"
+}

addedOutput schema / properties / ranked_by_corpus_frequency

Added value: +{
+  "default": null,
+  "title": "Ranked By Corpus Frequency",
+  "type": "boolean"
+}

addedOutput schema / properties / reading_estonian

Added value: +{
+  "default": null,
+  "title": "Reading Estonian",
+  "type": "string"
+}

addedOutput schema / properties / word_class_estonian

Added value: +{
+  "default": null,
+  "title": "Word Class Estonian",
+  "type": "string"
+}

First observedv0.2.4Jul 5, 2026

TDQS

A4.1/5.0

Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already cover the safety profile (readOnly, idempotent, closed-world), and the description still goes well beyond them: it discloses that output is generative not normative, that non-inflecting words yield empty `forms` with an explanatory `summary_estonian`, and the crucial caveat that `adt` surfaces often coincide with singular partitives and do not confirm case. That is exactly the kind of trap-flagging an agent cannot infer from structured fields.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

It is front-loaded with purpose and output shape, then the caveats, and every sentence carries substantive information about return structure or pitfalls. It is dense and jargon-heavy (form codes, `adt`, `sg p`) but not padded.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Despite an output schema existing, the description explains the return contract in detail: per-entry `form`/`form_estonian`/`surface`, list-valued surfaces with ordering rationale, `paradigm_key` naming the ranked type, `other_paradigms` coverage rules, and `ambiguity_estonian`. Nothing an agent needs to interpret or safely quote results is missing.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The single parameter is fully described in the schema, so the baseline is already high. The description earns extra credit by explaining a non-obvious behavior the schema does not: passing an inflected form rather than the lemma selects which paradigm type is returned when `paradigm_count` > 1.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description opens with a precise verb+resource: 'Inflection paradigm of one Estonian word from Vabamorf,' and immediately scopes the output ('generates what is possible, not necessarily idiomatic'). That is enough to separate it from morphological siblings like analyze_morphology or lemmatize, though it never names those alternatives explicitly.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

It gives real operational guidance – 'Read `ambiguity_estonian` before quoting a form' and 'Pass an inflected form (koti) to select the type you mean' – which tells the agent how to steer the tool. But it never states when to reach for this tool rather than the sibling morphology tools, so the when-to-use decision is left implicit.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.