Just-Magic MCP Server
An MCP server for the Just-Magic.org platform: query clustering, LSI text analysis and Wordstat frequency in one session
Medium risk
We rate an entry medium when the tool runs code, makes network calls or reads project files. Check what exactly it does before installing.
Why this level
- Every clustering or LSI-analysis task spends money from the Just-Magic balance with no built-in cap
- Call just_ask first so the agent doesn't spend the balance on an expensive task without confirmation
Install
Manual install
cd ~/code/just-magic-mcp && python3 -m venv venv && ./venv/bin/pip install "mcp>=1.0.0,<2" "httpx>=0.27.0"Install from the README: unpack the repo and install dependencies into a venv, then point Claude Desktop's config at that python and server.py.
This is third-party code. Review the repository files before installing.
What it does
The server wraps the Just-Magic.org API and gives an agent tools in four groups: account and tasks (balance, task list, task result), clustering and analysis (query clustering by Yandex/Google tops, on-page text optimization analysis, thematic classification), LSI and text (topical-relevance analysis and LSI word list generation) and frequency (Wordstat frequencies and suggestions, a suggestion-scraper with iterations). Just-Magic works asynchronously: the server creates a task, returns a tid, and the agent polls the status until it's done. Every tool supports just_ask: true to price a task before running it.
Who it is for. For SEO specialists with a paid Just-Magic tariff who want to cluster a keyword core and collect LSI words directly from an agent.
Good fit when
- You need to cluster a query list by Yandex or Google tops
- You need an LSI word list for writing a text on a given topic
- You need a text-optimization analysis of an already published page
Not a fit when
- You have no paid Just-Magic.org tariff at the "Etsilopp" level or above
- You want a simple synchronous answer, not a 30+ second wait for an async task
Example request
How much would clustering 1000 queries cost, and if it's cheap, run it for MoscowLimitations
You need a Just-Magic.org account with a paid tariff and an API key; every task spends money from the balance (the server passes this through but does not cap amounts). It requires the mcp library version 1.x: with mcp 2.0 the server will not start, as the README explicitly warns. There are no tests or CI in the repository.
How to disable. Remove the just-magic block from your Claude Desktop or Hermes config, and revoke the API key in the Just-Magic dashboard if needed.
MCP
- Transport
- stdio
- Authentication
- API key
| Environment variables | |
|---|---|
| JUSTMAGIC_API_KEY required, secret | API key from the Just-Magic.org dashboard. |
| JUSTMAGIC_DB_PATH | Path to a local SQLite database for results, defaults to ~/justmagic_results.db. |
Security check
- Every clustering or LSI-analysis task spends money from the Just-Magic balance with no built-in cap
- Call just_ask first so the agent doesn't spend the balance on an expensive task without confirmation
README in short
The Russian README lists all tools by section, gives a step-by-step venv and pip install, setup for Claude Desktop and the Hermes agent with a separate .env, example tasks, and a table of Yandex region codes.
FAQ
Can I see the task cost in advance?
Yes, every tool accepts just_ask: true, which prices the task without running it.
How often should I poll a task's status?
The README recommends at least 30 seconds; tasks run asynchronously.
Related
Official DataLens (Yandex) skills for Claude Code, Codex and OpenCode: SDK, HTML reports and RLS resolution
A Yandex Metrika MCP server generated from the API spec: 108 methods, 10 tools declared by default, transparent filters and response metadata
An open MCP server and agent skill set for SEO: keyword research, competitors, backlinks and site audits powered by DataForSEO
A Claude Code plugin for SEO audits: technical SEO, E-E-A-T, schema, local and AI search via parallel subagents