# Interslavic MCP server

> A read-only MCP server and JSON API over the community Interslavic dictionary
> (Medžuslovjansky slovnik). Interslavic is a CONSTRUCTED pan-Slavic auxiliary
> language — designed for mutual intelligibility across Slavic languages, NOT a
> natural or historically attested one. Use it to read and write Interslavic with
> real dictionary words and correctly generated inflected forms instead of inventing
> them. Fully offline (bundled snapshot). Read-only.

## What it does
- Looks an Interslavic word up (any form, Latin or Cyrillic) and returns its
  translation matrix (English + 11 Slavic languages: Russian, Belarusian,
  Ukrainian, Polish, Czech, Slovak, Slovene, Croatian, Serbian, Macedonian,
  Bulgarian) plus its full declension/conjugation table.
- Inflection tables are ALGORITHMICALLY GENERATED by the official @interslavic/utils
  engine at build time (Interslavic grammar is fully regular) — nouns, adjectives
  and verbs; pronouns, numerals and indeclinables carry none.
- Finds the Interslavic equivalents of an ENGLISH word (search_language=eng) via the
  gloss index, expanded into full entries.
- Resolves an inflected query to its headword automatically via the bundled reverse
  form index — the result says so (search_method=lemma_index). Latin and Cyrillic
  both work for headwords; diacritics are optional ('delati' finds 'dělati').
- Only isv and eng are QUERYABLE in v1; the matrix's other 11 languages are
  read-only (returned in each entry, not searchable).

## How to connect (MCP)
Remote streamable-HTTP endpoint (no auth, read-only): https://interslavic.valksor.com/mcp
  Claude Code:  claude mcp add --transport http interslavic https://interslavic.valksor.com/mcp
  Cursor / Cline (~/.cursor/mcp.json):
    {"mcpServers": {"interslavic": {"url": "https://interslavic.valksor.com/mcp"}}}
  stdio-only clients — bridge with mcp-remote:
    {"mcpServers": {"interslavic": {"command": "npx",
       "args": ["-y", "mcp-remote", "https://interslavic.valksor.com/mcp"]}}}
Tools (each returns Markdown plus typed structuredContent per its outputSchema):
- interslavic_search(query, search_language='isv'|'eng', include_forms=true, max_forms=N)
    Translation matrix plus inflection handles (entry_id = the numeric word id,
    word_class = the paradigm class). 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
    Interslavic equivalents plus their entries (English→Interslavic).
- interslavic_get_inflections(entry_id, word_class)
    The full paradigm for one handle. Its structuredContent nests the paradigm under
    a "result" key. Discriminated by "category": noun gives case → [singular, plural];
    adjective gives singular/plural case → gender forms plus short & comparison; verb
    gives the finite series (positional person lists), imperative, participles and
    verbal noun; "not_found" when the word carries no table.
- interslavic_transliterate(text, target='cyrillic'|'latin' optional)
    Transliterate ONE word between Latin and Cyrillic. Bidirectional: auto-detects the
    input's script and returns the attested spelling in the OTHER script (or force it
    with target). An EXACT dataset lookup (both spellings stored per entry) — it never
    guesses; a word not in the dataset returns empty candidates.
Search tips: one word per call; any form and either script works, diacritics
optional; for English→Interslavic pass search_language='eng'.
Prompts & resources (MCP):
- Prompts interslavic_translate_to(text) and interslavic_translate_from(text,
  target_language) package the grounded-translation method.
- Resource interslavic://glossary/grammar-labels documents the paradigm keys; this
  document is the llms.txt resource.

## How to call (JSON API)
- GET https://interslavic.valksor.com/api/search?query=slovo
- GET https://interslavic.valksor.com/api/search?query=word&search_language=eng
- GET https://interslavic.valksor.com/api/inflections?entry_id=33555&word_class=noun
- GET https://interslavic.valksor.com/api/transliterate?text=slovo   (Latin→Cyrillic; add &target=latin to force)
- GET https://interslavic.valksor.com/api/health
- Interactive docs: https://interslavic.valksor.com/api/docs  ·  schema: https://interslavic.valksor.com/api/openapi.json

## Data, generation and rate limits
Dictionary content is a bundled build-time snapshot — the server makes no upstream
calls. Inflection tables are generated by @interslavic/utils. Calls are rate limited
per client IP — on a 429, wait a few seconds and retry.

## Source and licence
- Dictionary: Interslavic dictionary (Medžuslovjansky slovnik), J. van Steenbergen et al. — steen.free.fr / medzuslovjansky (interslavic-dictionary.com). Morphology by @interslavic/utils. Reuse licence unconfirmed; reused here with attribution.
- Licence: Licence unconfirmed — reused with attribution. Interslavic itself is a constructed language in the public
  interest; the dictionary data's reuse terms are unconfirmed — attribute the source
  (van Steenbergen et al. / medzuslovjansky) and do not assume a specific open licence.