Ukrainian Language Reference (vitalinguist) MCP server

<!-- mcp-name: io.github.vitalinguist/ukr-vitalinguist-mcp -->

ukr-vitalinguist-mcp

MCP server for Ukrainian language grammar, surzhyk detection, and authentic phrasing.

Wraps the public ukr.vitalinguist.com API as Model Context Protocol tools. Install in Claude Desktop, Cursor, Cline, Continue, Windsurf, or Claude Code and your AI gains four Ukrainian-language capabilities backed by curated open data (Балла EN-UA 1996, Сербенська's Антисуржик, Караванський, Антоненко-Давидович, plus e2u.org.ua and modern corpora — 29,524 senses, 6k+ calque pairs).

Tools

Every response includes a citation block with the source URL the AI should include when surfacing the result to the user.

Install

Claude Desktop

Add to ~/Library/Application Support/Claude/claudedesktopconfig.json (macOS) or %APPDATA%\Claude\claudedesktopconfig.json (Windows):

{
  "mcpServers": {
    "ukr-vitalinguist": {
      "command": "uvx",
      "args": ["ukr-vitalinguist-mcp"]
    }
  }
}

Restart Claude Desktop. The four tools appear in the tools menu.

Cursor

Edit ~/.cursor/mcp.json or workspace .cursor/mcp.json:

{
  "mcpServers": {
    "ukr-vitalinguist": {
      "command": "uvx",
      "args": ["ukr-vitalinguist-mcp"]
    }
  }
}

Cline / Continue / Windsurf

Use the same command + args in their MCP config UI.

Claude Code

claude mcp add ukr-vitalinguist -- uvx ukr-vitalinguist-mcp

Without uvx

If you don't have uv installed, use pip:

pip install ukr-vitalinguist-mcp

Then point the command to your Python's ukr-vitalinguist-mcp entrypoint:

{
  "mcpServers": {
    "ukr-vitalinguist": {
      "command": "ukr-vitalinguist-mcp"
    }
  }
}

Example interactions

User: "Is this Ukrainian sentence natural? На протязі дня я зайнятий."

The AI calls checknatural → gets back calque-prone: 'На протязі' → 'упродовж' sourced from Сербенська's Антисуржик*, and replies:

"На протязі" is a calque from Russian. Use «упродовж дня я зайнятий» —

"упродовж" is the natural Ukrainian preposition for "during/throughout."

Source: Сербенська, Антисуржик via ukr.vitalinguist.com

User: "How do you say 'cling' in Ukrainian?"

The AI calls render("cling") → gets back sense-split renderings:

Several options depending on the sense:

- cling (on) to sth (physically grip): горнутися, чіплятися

- cling to a belief: триматися (чогось)

Full entry: ukr.vitalinguist.com/sense/cling

What's in the corpus

with e2u.org.ua, modern news/literary corpora, and confidence scoring.

• 29,524 EN→UA senses from Балла EN-UA Dictionary (1996), corroborated

Антоненко-Давидович, validator-cleaned to drop noisy entries.

• 6,073 antisurzhyk calque pairs from Сербенська, Караванський, and

rendering meets the confidence threshold yet (transparent about what we don't have).

• 22,848 documented coverage gaps at /gaps/ — senses where no UA

rule-based layer misses.

• A russianism detection model (fine-tuned MarianMT) for cases the

License

This MCP server: MIT.

The data the server returns: CC BY-SA 4.0. When you surface results in your own product or response, attribute to ukr.vitalinguist.com with a clickable link. The citation field in each response gives you the exact URL to use.

Authority and citations

Shortened. The full README is on GitHub.