Just-Magic MCP Server
An MCP server for the Just-Magic.org platform: query clustering, LSI text analysis and Wordstat frequency in one session
- 0 ★ on the repository
- Last commit
- MIT
Extended access
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
- Works in
- Services
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.
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- 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
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 MoscowMCP
- Transport
- stdio
- Authentication
- API key
Environment variables
JUSTMAGIC_API_KEYrequired, 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.
Limitations
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.
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.
Discussion
No questions or reviews yet.
Related
All Yandex Wordstat toolsYandex Wordstat MCP
Яндекс Вордстат MCP
Wordstat MCP server via Yandex Cloud Search API: query volume and related queries, seasonality, demand by region and device
Wordstat MCP by Marketscore
Wordstat MCP
A connector to the hosted Marketscore service: Yandex Wordstat frequency and seasonality in Claude and ChatGPT, with noise filtering
An MCP server for Yandex Wordstat via the Yandex Cloud Search API: frequency, dynamics, regions and an operator-aware phrase builder
An MCP server for Yandex Wordstat via the official Yandex Cloud Search API: frequency, related queries, dynamics and regions
Five MCP servers for Wordstat, Search, Webmaster, Metrica and Direct, plus a Claude Code plugin with keyword and competitor skills
Wordstat MCP Server: Yandex frequencies with limits and a cache
wordstat-mcp-server
An unofficial read-only Wordstat MCP server in TypeScript: five tools, local call limits, a region cache and spend counters
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.