OpenClaw Integration Guide

MCP server for RURussian.com – turn your OpenClaw bot into a Russian tutor.

Quick Start

Install the server using pip:

pip install rurussian-mcp

Add this to your ~/.openclaw/config.json:

{
  "mcpServers": {
    "rurussian": {
      "command": "rurussian-mcp",
      "args": [],
      "env": {
        "RURUSSIAN_API_KEY": "YOUR_RURUSSIAN_API_KEY"
      }
    }
  }
}

In your bot flow, call authenticate first using that API key, then call the learning tools.

Available Tools

authenticate(api_key, user_agent?)

Initialize the session using your API key.

Example request: "Use my RuRussian API key and initialize this session."

get_word_data(word)

Get declension and meaning of a word.

Example request: "Explain the declension and meaning of книга."

get_sentences(word, form_word?, form_id?)

Show example sentences for a word.

Example request: "Show example sentences for идти in past tense."

generate_zakuska(topic?, mode?)

Generate a short Russian text about a topic.

Example request: "Generate a short A2-level Russian text about travel."

analyze_sentence(sentence)

Break down a sentence and explain each form.

Example request: "Break down this sentence and explain each form: Я люблю программировать."

translate_text(text)

Translate Russian text to English.

Example request: "Translate this Russian paragraph to English."

Troubleshooting

Missing API key: Ensure your OpenClaw config contains an API key value and your bot passes it into authenticate.
Authentication required error: Call authenticate before any other MCP tool in each new server session.
Python version issue: This package requires Python 3.9 or newer.
Command not found: rurussian-mcp: Ensure installation completed in the same environment where OpenClaw runs.
API endpoint/network errors: Verify internet access and optionally set RURUSSIAN_API_URL only if you need a custom backend URL.

Need Help?

Check out our API Documentation or read our Blogs for more tutorials and examples.