UA Slang

MCP server for live Ukrainian internet language — slang, memes, and phrases for AI agents.

Українська | English

---

🇬🇧 English

What is this?

AI agents write dead language. "This is not just a product — it's a solution." Long dashes, bureaucratic tone, templates.

Real Ukrainians on the internet write differently:

• "капець, це кринж" — not "this causes a feeling of discomfort"
• "залітай знайомитись" — not "we invite you to join our community"
• "горить жопа від дедлайнів" — not "I'm experiencing increased workload"
• "крч, скіпнула мітинг" — not "unfortunately, I missed the meeting"

ua-slang-mcp gives AI agents access to a living dictionary, updated daily from Threads. With dates, trends, and freshness checks — so your agents never use dead memes.

Install

npm install ua-slang-mcp

Connect to Claude Code

# Option 1: npx (always latest)
claude mcp add ua-slang -- npx ua-slang-mcp

# Option 2: after npm install
claude mcp add ua-slang -- node node_modules/ua-slang-mcp/dist/server.js

Three data streams

Stream	What	Updates
Slang	Active words with aging tracking	Daily frequency check
Streak	Stable expressions/templates, always relevant	Only added, never expire
Memes	Dynamic trends with lifecycle	Aggressive tracking: rising → peak → dead

Tools

Tool	Description
get_dataset_info	Dataset size, last update date, coverage
search_slang(query)	Search slang — meaning, example, freshness
search_streaks(query)	Search stable expressions
get_trending_memes(limit)	Top memes by virality_score
get_trending_slang(limit)	Rising slang
suggest_for_post(topic)	Suggest slang/memes for a post topic
check_freshness(word)	Is this word still relevant? (verdict: safe/outdated/dead)
get_daily_package()	Daily update package: what's new, what's deprecated
get_all_slang()	All active slang with dates
get_all_streaks()	All stable expressions

Every response includes:

• _dataset_last_updated — last dataset update date
• _freshness — today / this_week / this_month / stale
• verdict — safe to use / outdated / dead meme

How it works

Daily cron
  → Playwright scrapes Threads
  → Claude CLI parses posts, finds new words/memes
  → Cleanup script: deduplication, merge with existing data
  → npm publish → users get fresh data on next install/update

Auto-updates

The npm package is published daily with fresh data. To get updates:

# Always latest via npx
npx ua-slang-mcp@latest

# Or update manually
npm update ua-slang-mcp

Contributing

Dataset is currently 152 entries and growing daily. Help needed:

• New words/memes — see something fresh on Threads/TikTok/X? Open a PR or issue
• New sources — TikTok comments, X/Twitter UA, Reddit UA
• Niche slang — IT, psychology, parenting, business, gaming, military
• Tests — coverage for parser and MCP tools
• Integrations — other AI platforms

How to contribute

1. Fork → branch → PR
2. Or just create an issue with a new word/meme
3. Format for new entries — see DATASET_STRUCTURE.md

Your data is welcome in any format. Got a list of slang words in a Google Doc, a CSV, a screenshot, raw JSON, or just a messy text dump? Submit it via PR — we'll sort it out. Any format, any structure, any size. The more sources, the richer the dataset.

---

🇺🇦 Українська

Що це?

AI-агенти пишуть мертвою мовою. "Це не просто продукт — це рішення". Довге тире, канцелярит, шаблони.

Реальні українці в інтернеті пишуть інакше:

• "капець, це кринж" — а не "це викликає відчуття незручності"
• "залітай знайомитись" — а не "запрошуємо до нашої спільноти"
• "горить жопа від дедлайнів" — а не "відчуваю підвищене навантаження"
• "крч, скіпнула мітинг" — а не "на жаль, я пропустила зустріч"

ua-slang-mcp дає AI-агентам доступ до живого словника, який оновлюється щодня з Threads. З датами, трендами, і перевіркою актуальності — щоб не використовувати мертві меми.

Встановлення

npm install ua-slang-mcp

Підключення до Claude Code

# Варіант 1: npx (завжди остання версія)
claude mcp add ua-slang -- npx ua-slang-mcp

# Варіант 2: після npm install
claude mcp add ua-slang -- node node_modules/ua-slang-mcp/dist/server.js

Три напрямки даних

Напрямок	Що це	Оновлення
Сленг	Актуальні слова з трекінгом старіння	Щоденна перевірка частоти
Стрік	Стійкі вирази/шаблони, завжди актуальні	Тільки додаються, ніколи не старіють
Меми	Динамічні тренди з lifecycle	Агресивний трекінг: rising → peak → dead

Tools

Tool	Опис
get_dataset_info	Розмір датасету, дата оновлення
search_slang(query)	Пошук сленгу — значення, приклад, freshness
search_streaks(query)	Пошук стійких виразів
get_trending_memes(limit)	Топ мемів за virality_score
get_trending_slang(limit)	Сленг що росте
suggest_for_post(topic)	Підказки сленгу/мемів для теми поста
check_freshness(word)	Чи слово ще актуальне (verdict: safe/outdated/dead)
get_daily_package()	Щоденний пакет оновлень
get_all_slang()	Весь активний сленг з датами
get_all_streaks()	Всі стійкі вирази

Автооновлення

npm-пакет публікується щодня зі свіжими даними. Щоб отримувати оновлення:

# Завжди остання версія через npx
npx ua-slang-mcp@latest

# Або оновити вручну
npm update ua-slang-mcp

Контрибуції

Датасет зараз 152 записи і росте щодня. Потрібна допомога:

• Нові слова/меми — бачиш щось свіже? Кидай PR або issue
• Нові джерела — TikTok, X/Twitter UA, Reddit UA
• Нішевий сленг — IT, психологія, мами, бізнес, геймінг, ЗСУ
• Тести — покриття для парсера і MCP tools

Дані у будь-якому форматі — welcome. Є список слів у Google Doc, CSV, скрін, JSON, просто текстовий файл? Кидай PR — розберемось. Будь-який формат, будь-яка структура, будь-який розмір. Чим більше джерел — тим живіший датасет.

---

Contacts

Lazysoft — lazysoft.pl

• Telegram: @dcprn
• WhatsApp: Chat
• Email: [email protected]

Author: Daria Chuprina

License

MIT