MCP server

Suzlek is available to LLMs as an MCP server: an assistant helping someone learn Tatar or translate can look words up in the dictionary and read their inflection tables instead of relying on memory. It is free, read-only and needs no account.

Connect

The endpoint (Streamable HTTP, stateless):

https://suzlekdict.net/api/mcp

Claude Code:

claude mcp add --transport http suzlek https://suzlekdict.net/api/mcp

Claude (desktop or web): Settings → Connectors → Add custom connector, with the endpoint as its URL.

Cursor and other clients configured by JSON:

{
  "mcpServers": {
    "suzlek": {
      "url": "https://suzlekdict.net/api/mcp"
    }
  }
}

The endpoint takes JSON-RPC requests by POST only: opening it in a browser shows an error, not a page.

Tools

The descriptions below are the ones the model reads when it decides which tool to call.

tt_ru_lookup

Look up a Tatar word in the Tatar–Russian dictionaries: its entries with part of speech, numbered Russian meanings and labels (style, domain).

An inflected form finds its headword: found_by_form then names the form and its place in the inflection table, in the table's Russian labels ("Д., мн. ч." = dative plural). A word with several readings (an inflected form of one word and the headword of another) returns all of them, headwords first. Verbs are listed under their verbal noun (китү for китәргә «уйти»). No entries: the word is not in the dictionaries, which is not proof it doesn't exist.

  • word string, required

    A Tatar word as written, or any inflected form of it (балаларга, китмәдем). ә ө ү җ ң һ may be typed as е о у ж н х.

  • include_examples boolean, default false

    Add usage examples with their translations to each meaning. Set it when the meanings alone don't show how the word is used or which meaning fits.

  • include_phrases boolean, default false

    Add set phrases and idioms with the word, each with its own meanings. Set it when looking for an expression, or when a meaning may be idiomatic.

ru_tt_lookup

Look up a Russian word in the Russian–Tatar dictionary: its entries with part of speech and numbered meanings, each with its Tatar translations and the labels and Russian hints («(о человеке)») that tell the meanings apart.

Choose a translation by the meaning, not by its position, and check how it is used with tt_ru_lookup. Inflected Russian forms find nothing: pass the dictionary form.

  • word string, required

    A Russian word in its dictionary form (дом, идти, красивый); е also finds ё.

  • include_examples boolean, default false

    Add usage examples with their translations to each meaning. Set it when the meanings alone don't show how the word is used or which meaning fits.

  • include_phrases boolean, default false

    Add set phrases and idioms with the word, each with its own meanings. Set it when looking for an expression, or when a meaning may be idiomatic.

tatar_paradigm

The inflection tables of a Tatar word: declension of a noun, pronoun or adjective's comparison, conjugation of a verb. Use them to build or check a form instead of inflecting from memory.

Each table is a list of rows, cells joined by " | ", labelled in Russian as in the dictionary: Им. Прит. Д. В. М. Исх. = nominative, genitive, dative, accusative, locative, ablative; ед. ч. / мн. ч. = singular / plural; лицо = person; Принадлежность = possessive forms; a verb's rows name its tenses, moods and participles in full, «(отр. форма)» = negative. A table's source says whether it comes from Wiktionary or was generated by a morphological analyser — a generated one can be wrong, so say so when it matters. No paradigms: the word has no table in that part of speech (most adjectives and many rare words have none).

  • word string, required

    A Tatar word, its headword or any inflected form; for a verb, its verbal noun (китү) or infinitive (китәргә).

  • pos "noun" | "verb" | "adjective" | "pronoun", required

    The part of speech whose tables to return, as tt_ru_lookup gives it.

Example

Any HTTP client can call a tool directly:

curl -s https://suzlekdict.net/api/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc": "2.0", "id": 1, "method": "tools/call",
       "params": {"name": "tt_ru_lookup", "arguments": {"word": "балаларга"}}}'

Content and licenses

The tools return the dictionary's own text, each entry naming its source; the sources are described on the sources page. Wiktionary content is under CC BY-SA 4.0, and has to be credited wherever it is reused.