# Church Slavonic dictionary access

> A grounding service over the English Wiktionary's Old Church Slavonic entries —
> the normalized scholarly orthography of the oldest attested Slavic literary
> language, which liturgical Church Slavonic descends from. Use it to read and
> write Church Slavonic with attested words and correct inflected forms instead of
> inventing them. Read-only.

## What it does
- Looks an Old Church Slavonic word up (Cyrillic; any form) and returns its senses
  plus full declension/conjugation tables — singular, dual AND plural.
- Finds the OCS equivalents of an ENGLISH word (search_language=eng): each sense's
  translations from Wiktionary's translation tables (the result's translations
  block), expanded into their full dictionary entries.
- Resolves an inflected query to its dictionary lemma automatically via paradigms
  already cached — the result says so (search_method=lemma_index, with
  resolved_from/resolved_lemma). No external analyzer exists for OCS, so a form
  not yet in any cached paradigm won't resolve — look the lemma up directly.
- Transliterates Cyrillic or Glagolitic to the scientific Latin scheme (богъ →
  bogŭ, ⰱⱁⰳⱏ → bogŭ); liturgical reading marks (titlos, accents) are dropped, so
  copied liturgical text works as-is.

## How to connect (MCP)
Remote streamable-HTTP endpoint (no auth, read-only): https://slavonic.valksor.com/mcp
  Claude Code:  claude mcp add --transport http slavonic https://slavonic.valksor.com/mcp
  Cursor / Cline (~/.cursor/mcp.json):
    {"mcpServers": {"slavonic": {"url": "https://slavonic.valksor.com/mcp"}}}
  stdio-only clients — bridge with mcp-remote:
    {"mcpServers": {"slavonic": {"command": "npx",
       "args": ["-y", "mcp-remote", "https://slavonic.valksor.com/mcp"]}}}
Tools (each returns Markdown plus typed structuredContent per its outputSchema):
- search_slavonic(query, search_language='chu'|'eng', include_forms=true, max_forms=N)
    Senses plus inflection handles (entry_id = the lemma/page title, word_class =
    the part-of-speech section). With include_forms (default TRUE on MCP; the JSON
    API defaults it false), each match's full table comes back inline. With
    search_language='eng' the query is an English word and the result lists its
    per-sense OCS equivalents plus their entries (English→Church Slavonic).
- get_inflections(entry_id, word_class)
    The full paradigm for one handle. Its structuredContent nests the paradigm
    under a "result" key (the other tools' payloads are unwrapped); the JSON API
    returns it directly. Both shapes are discriminated by "category":
    nominal gives cases -> {singular, dual, plural} (gender and short/long
    variant prefixed into the case key on split tables); verbal gives finite
    "<tense/mood>" -> "<person> <number>" -> form plus non-finite sections
    (infinitive, supine, l-participle); "not_found" when no table exists.
- transliterate_slavonic(text)
    Scientific Latin transliteration of Cyrillic and/or Glagolitic text.
Search tips: one OCS word per call; normalized OCS spelling works best, but
titlos/accents and modern respellings (ы for ꙑ) are folded; for English→Church
Slavonic pass search_language='eng' (multiword entries like 'apple tree' work).
Prompts & resources (MCP):
- Prompts translate_to_slavonic(text) and translate_from_slavonic(text, target_language)
  package the grounded-translation method.
- Resource slavonic://glossary/transliteration carries the full Cyrillic/Glagolitic →
  scientific Latin letter tables; this document is the llms.txt resource.

## How to call (JSON API)
- GET https://slavonic.valksor.com/api/search?query=богъ
- GET https://slavonic.valksor.com/api/search?query=water&search_language=eng
- GET https://slavonic.valksor.com/api/inflections?entry_id=глаголати&word_class=verb
- GET https://slavonic.valksor.com/api/transliterate?text=ⰱⱁⰳⱏ
- GET https://slavonic.valksor.com/api/health
- Interactive docs: https://slavonic.valksor.com/api/docs  ·  schema: https://slavonic.valksor.com/api/openapi.json

## Caching and politeness
Dictionary responses are cached server-side with a long TTL (Wiktionary content
changes slowly). Upstream calls are serialised with a polite minimum interval.
Calls are rate limited per client IP — on a 429, wait a few seconds and retry.

## Source and licence
- Dictionary: Wiktionary, the free dictionary (en.wiktionary.org), Old Church Slavonic entries. Wikimedia Foundation. Text available under CC BY-SA 4.0; attribution and share-alike required when republishing.
- Licence: CC BY-SA 4.0 — attribute and share alike when republishing dictionary text.