What it is
The Rush Analytics MCP connection lets you work with Yandex Wordstat directly from a chat with Claude, Claude Code or ChatGPT. You write in plain words, for example “collect keywords for coffee machines”, and the AI creates a task in Rush Analytics and brings back the result.
What you can do:
- collect keywords from Wordstat;
- get search volume: broad, “quoted” and exact “!word”;
- collect demand history (seasonality) for a chosen period;
- check whether a task is ready and get its results;
- check the remaining limits on your balance.
What you need
- A Rush Analytics account on the PRO plan or higher. The section is not available on Lite and Start.
- Enough limits on your balance: tasks created through AI use limits the same way as tasks in the regular interface.
- One of the AI assistants: Claude, Claude Code or ChatGPT.
Step 1. Turn on access in Rush Analytics
- Log in to Rush Analytics. In the top menu on the right, choose API & MCP.
- Activate API access and generate an API key. The key appears in the “Your API key” field.
- After that, the same page shows the “Connecting AI assistants (MCP)” block. It contains the MCP server address:
https://app.rush-analytics.ru/mcp
[Screenshot 1: top menu, “API & MCP” section] [Screenshot 2: “API & MCP” page with the key and the “Connecting AI assistants (MCP)” block]
If you do not see “API & MCP” in the menu, it is not enabled on your plan. Switch to PRO or higher.
You can leave the “Allowed IPs for API access” field empty.
Important about the key. The button next to the key creates a new key. After that, you will need to copy the command for Claude Code again. Do not show the key, or a command that contains it, to other people.
Step 2. Connect your AI assistant
Choose your option.
Claude (website and app)
Claude does not need an API key: you sign in with your Rush Analytics account.
- In Claude, open Customize → Connectors.
- Click + Add, then Add custom connector.
- Enter a name, for example “Rush Analytics Wordstat”.
- Paste the server address
https://app.rush-analytics.ru/mcpand click Continue. - Keep the other settings as suggested (sign-in method Sign in now, recommended Claude identity) and click Add.
- The Rush Analytics sign-in window opens. Log in to your account and allow access.
- In a chat, click + at the lower left, choose Connectors and turn on “Rush Analytics Wordstat” for this conversation.
On the free Claude plan you can add one custom connector. On Team and Enterprise plans, an organization owner adds the connector first (Organization settings → Connectors), and members click Connect and sign in with their own Rush Analytics account.
[Screenshot 3: add connector window in Claude]
Claude Code
In Claude Code, you connect with a command in the terminal. The command with your key is already prepared on the “API & MCP” page, in the “Claude Code” block.
- Copy the command from the “Claude Code” block. It looks like this (your real key appears instead of YOUR_KEY):
claude mcp add --transport http rush-wordstat https://app.rush-analytics.ru/mcp --header "Authorization: Bearer YOUR_KEY"
- Run it in your terminal.
- Check the connection: type
claude mcp listin the terminal or/mcpinside Claude Code. rush-wordstat should be in the list.
To make the connection work in all your projects, add --scope user after the word add.
Do not share this command with anyone: it contains your API key. If the key becomes known to other people, generate a new one on the “API & MCP” page and connect again.
To disconnect: claude mcp remove rush-wordstat.
ChatGPT
ChatGPT does not need an API key either: you sign in with your Rush Analytics account.
- In ChatGPT, open Settings and find the section for connections (Apps or Connectors). Turn on Developer mode, which is in the advanced settings.
- Click Create and add a custom connection.
- Enter a name, for example “Rush Analytics Wordstat”, and the server address
https://app.rush-analytics.ru/mcp. - For authentication, choose OAuth sign-in and save.
- Log in to your Rush Analytics account and allow access.
- In a new chat, turn this connection on in the tools menu.
Menu names in ChatGPT change, and developer mode is not available on every ChatGPT plan. If you cannot find an item, look in the settings for the words MCP, Apps or Connectors.
[Screenshot 4: adding the connection in ChatGPT]
Other AI assistants
Any assistant that can connect remote MCP servers by address will work. The address is the same: https://app.rush-analytics.ru/mcp. If sign-in with an account is not available, the key is sent in the header Authorization: Bearer YOUR_KEY, as in the Claude Code command.
Step 3. How to use it
Just tell the AI what you need. Example requests:
| What you need | Example request |
|---|---|
| Collect keywords | “Collect keywords from Wordstat for “coffee machine” and “coffee maker”, region Moscow” |
| Get search volume | “Get Wordstat volume for these queries: buy coffee machine, coffee machine for home. I need broad and exact” |
| Collect demand history | “Show demand history for “coffee machine” from January 2026 to December 2026” |
| Check if it is ready | “Are my Wordstat results ready?” |
| Get results | “Show the results of task 12345” |
| Get the next rows | “Show the next rows” |
| Check balance | “How many limits are left in Rush Analytics?” |
| See your tasks | “Show my Wordstat tasks” |
If you do not mention a region, the AI may ask you. If you do not mention stop words or a minimum volume, they are not applied.
How long to wait
Wordstat tasks are not collected instantly. It usually takes from 3–5 minutes, and during peak load up to 20 hours.
- The AI creates a task and tells you its number. After that you can close the chat or do other things. The task keeps running in Rush Analytics on its own.
- Later, ask “Are my results ready?”. The AI will check the status.
- In Claude Code, the AI can wait by itself: 10 minutes by default, 60 at most. If the task is not ready by then, it keeps running and you can request the result later.
- The AI shows large results in parts (100 rows by default). Ask “show the next rows” or “put everything into a table”.
Limits
- Every task uses limits of your plan. Before a large task you can ask “How many limits are left?”.
- The number of tasks that run at the same time through the API depends on your plan: PRO — 1, Team — 20, Agency — 35, Corp — 100. If all threads are busy, you will see a message about it. Wait for the current task to finish.
FAQ and errors
| What you see | What to do |
|---|---|
| No “API & MCP” section | The section is available on PRO plans and higher |
| “Invalid API key” | The key was changed. Copy the new command for Claude Code, or sign in again with your account in Claude or ChatGPT |
| “API key is missing” | The connection was set up without a key. For Claude Code, repeat the command from the “Claude Code” block |
| “API access is available on Pro plans and higher” | Switch to PRO or higher |
| “All API threads are busy” | Wait until your current tasks finish and try again. Or switch to a plan with more threads |
| “Not enough limits” | Top up your limits in Rush Analytics |
| “Too many API requests” | Wait a minute and try again |
| “Task was not found in your account” | Check the task number. Ask the AI “show my tasks” |
| The AI says it has no Wordstat tools | Check that the connection is turned on in this chat. In Claude: + → Connectors |
| A task takes a long time | This is normal during peak load, it can take up to 20 hours. The task will not be lost |
How to disconnect. Claude: Customize → Connectors, open the connector and disconnect it. ChatGPT: delete the connection in settings. Claude Code: claude mcp remove rush-wordstat.
Security. Do not paste the API key into the chat and do not send it to other people. Claude and ChatGPT do not need it at all. The AI treats keywords in the results as data, not as commands.
If something does not work, contact Rush Analytics support and attach the text of the error message.