SkillFoxx

Type a name, a task or a service

SuperJob MCP server

superjob-mcp

An MCP server for the SuperJob job site: vacancies, employers, cities and professions through an AI agent

MCP server

Low risk

We rate an entry low when it mostly gives the agent instructions and reference material.

Why this level

  • All tools are read-only over vacancies and reference data, no changes are made
  • The API key grants read access to the application account's data
All reasons and checks
Russian stack

theyahia/superjob-mcpAuthor:theYahia

Install

In your terminal, with SkillFoxx CLI

npx skillfoxx add mcp/superjob-mcp

Detects the agents on your machine, checks the risk and pins the version.

Other ways to install

Run in a terminal

claude mcp add --transport stdio --env 'SUPERJOB_SECRET_KEY=<your SUPERJOB_SECRET_KEY>' superjob -- npx -y @theyahia/superjob-mcp

Or add to the file .mcp.json, in the project

{
  "mcpServers": {
    "superjob": {
      "command": "npx",
      "args": [
        "-y",
        "@theyahia/superjob-mcp"
      ],
      "env": {
        "SUPERJOB_SECRET_KEY": "<your SUPERJOB_SECRET_KEY>"
      }
    }
  }
}

If the file already exists, add the server inside the mcpServers key.

Keys and settings

SUPERJOB_SECRET_KEYsecret, required
SUPERJOB_APP_IDoptional

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Install in Cursor

The button opens the agent and offers to add the server. If nothing happens, copy the config below.

Add to the file ~/.cursor/mcp.json, for all projects

{
  "mcpServers": {
    "superjob": {
      "command": "npx",
      "args": [
        "-y",
        "@theyahia/superjob-mcp"
      ],
      "env": {
        "SUPERJOB_SECRET_KEY": "<your SUPERJOB_SECRET_KEY>"
      }
    }
  }
}

If the file already exists, add the server inside the mcpServers key. For a single project, put the same block into .cursor/mcp.json.

Keys and settings

SUPERJOB_SECRET_KEYsecret, required
SUPERJOB_APP_IDoptional

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Install in VS Code

The button opens the agent and offers to add the server. If nothing happens, copy the config below.

Run in a terminal

code --add-mcp '{"name":"superjob","type":"stdio","command":"npx","args":["-y","@theyahia/superjob-mcp"],"env":{"SUPERJOB_SECRET_KEY":"<your SUPERJOB_SECRET_KEY>"}}'

Or add to the file .vscode/mcp.json, in the project

{
  "servers": {
    "superjob": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@theyahia/superjob-mcp"
      ],
      "env": {
        "SUPERJOB_SECRET_KEY": "<your SUPERJOB_SECRET_KEY>"
      }
    }
  }
}

If the file already exists, add the server inside the servers key.

Keys and settings

SUPERJOB_SECRET_KEYsecret, required
SUPERJOB_APP_IDoptional

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Run in a terminal

codex mcp add superjob --env 'SUPERJOB_SECRET_KEY=<your SUPERJOB_SECRET_KEY>' -- npx -y @theyahia/superjob-mcp

Or add to the file ~/.codex/config.toml, for all projects

[mcp_servers.superjob]
command = "npx"
args = ["-y", "@theyahia/superjob-mcp"]
env = { SUPERJOB_SECRET_KEY = "<your SUPERJOB_SECRET_KEY>" }

If the file already exists, append the block to the end.

Keys and settings

SUPERJOB_SECRET_KEYsecret, required
SUPERJOB_APP_IDoptional

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Add to the file ~/.gemini/settings.json, for all projects

{
  "mcpServers": {
    "superjob": {
      "command": "npx",
      "args": [
        "-y",
        "@theyahia/superjob-mcp"
      ],
      "env": {
        "SUPERJOB_SECRET_KEY": "<your SUPERJOB_SECRET_KEY>"
      }
    }
  }
}

If the file already exists, add the server inside the mcpServers key.

Keys and settings

SUPERJOB_SECRET_KEYsecret, required
SUPERJOB_APP_IDoptional

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Add to the file ~/.config/devin/mcp_config.json, for all projects

{
  "mcpServers": {
    "superjob": {
      "command": "npx",
      "args": [
        "-y",
        "@theyahia/superjob-mcp"
      ],
      "env": {
        "SUPERJOB_SECRET_KEY": "<your SUPERJOB_SECRET_KEY>"
      }
    }
  }
}

If the file already exists, add the server inside the mcpServers key. Legacy Cascade keeps the MCP config in ~/.codeium/windsurf/mcp_config.json.

Keys and settings

SUPERJOB_SECRET_KEYsecret, required
SUPERJOB_APP_IDoptional

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Formerly Windsurf.

Add to the file cline_mcp_settings.json, for all projects

{
  "mcpServers": {
    "superjob": {
      "command": "npx",
      "args": [
        "-y",
        "@theyahia/superjob-mcp"
      ],
      "env": {
        "SUPERJOB_SECRET_KEY": "<your SUPERJOB_SECRET_KEY>"
      }
    }
  }
}

If the file already exists, add the server inside the mcpServers key. Open the settings file in Cline: MCP Servers tab, Configure MCP Servers.

Keys and settings

SUPERJOB_SECRET_KEYsecret, required
SUPERJOB_APP_IDoptional

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Add to the file .roo/mcp.json, in the project

{
  "mcpServers": {
    "superjob": {
      "command": "npx",
      "args": [
        "-y",
        "@theyahia/superjob-mcp"
      ],
      "env": {
        "SUPERJOB_SECRET_KEY": "<your SUPERJOB_SECRET_KEY>"
      }
    }
  }
}

If the file already exists, add the server inside the mcpServers key.

Keys and settings

SUPERJOB_SECRET_KEYsecret, required
SUPERJOB_APP_IDoptional

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

A fork of Roo Code, same .roo folders.

Add to the file opencode.json, in the project

{
  "mcp": {
    "superjob": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "@theyahia/superjob-mcp"
      ],
      "environment": {
        "SUPERJOB_SECRET_KEY": "<your SUPERJOB_SECRET_KEY>"
      }
    }
  }
}

If the file already exists, add the server inside the mcp key.

Keys and settings

SUPERJOB_SECRET_KEYsecret, required
SUPERJOB_APP_IDoptional

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Add to the file ~/.config/zed/settings.json, for all projects

{
  "context_servers": {
    "superjob": {
      "command": "npx",
      "args": [
        "-y",
        "@theyahia/superjob-mcp"
      ],
      "env": {
        "SUPERJOB_SECRET_KEY": "<your SUPERJOB_SECRET_KEY>"
      }
    }
  }
}

If the file already exists, add the server inside the context_servers key.

Keys and settings

SUPERJOB_SECRET_KEYsecret, required
SUPERJOB_APP_IDoptional

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

Add to the file .codeassistant/mcp.json, in the project

{
  "mcpServers": {
    "superjob": {
      "command": "npx",
      "args": [
        "-y",
        "@theyahia/superjob-mcp"
      ],
      "env": {
        "SUPERJOB_SECRET_KEY": "<your SUPERJOB_SECRET_KEY>"
      }
    }
  }
}

If the file already exists, add the server inside the mcpServers key.

Keys and settings

SUPERJOB_SECRET_KEYsecret, required
SUPERJOB_APP_IDoptional

Replace the values in angle brackets with your own. Keys never go into install links and are not stored by us.

You will need: Node.js

Checked against the repository on Sep 25, 2026, commit 7eac43c.

Text for your agent

Get SUPERJOB_SECRET_KEY at api.superjob.ru, then connect the server with claude mcp add superjob -e SUPERJOB_SECRET_KEY=ваш-ключ -- npx -y @theyahia/superjob-mcp.

Other ways from the author
claude mcp add superjob -e SUPERJOB_SECRET_KEY=ваш-ключ -e SUPERJOB_APP_ID=ваш-app-id -- npx -y @theyahia/superjob-mcp

Command from the README for Claude Code.

This is third-party code. Review the repository files before installing.

What it does

The server talks to the SuperJob.ru API using an application key and gives an agent five tools: vacancy search by keywords, city and salary, full vacancy details by ID, employer search by name and city, a city directory with search and country filtering, and a directory of professions and industries. Two Claude Code skills run a vacancy search by specialty and a salary analysis by specialty with one command.

Who it is for. For people looking for a job or employees through SuperJob who want listings and salary analysis through an agent.

Good fit when

  • You want vacancies filtered by specialty, city and salary range
  • You want to see which employers are hiring in a given city
  • You want an overview of salary levels for a specialty

Not a fit when

  • You do not have a SUPERJOB_SECRET_KEY from api.superjob.ru
  • You need to apply to a vacancy or manage your resume: the server only reads reference data

Example request

Find Python developer vacancies in Moscow with a salary from 200000 rubles on SuperJob

Limitations

The project has a single author and is part of the same author's larger series of Russian API MCP servers. All five tools are read-only. The SUPERJOB_API_KEY variable is noted as a deprecated fallback; the current key is SUPERJOB_SECRET_KEY.

How to disable. Remove the superjob server from your MCP client config.

MCP

Transport
stdio, http
Authentication
API key
Environment variables
SUPERJOB_SECRET_KEY
required, secret		API secret key, issued at api.superjob.ru.
SUPERJOB_APP_ID
SuperJob application ID.

Security check

  • All tools are read-only over vacancies and reference data, no changes are made
  • The API key grants read access to the application account's data

README in short

The Russian README gives configs for Claude Desktop, Claude Code, Streamable HTTP and installation via Smithery, a table of environment variables and five tools, two Claude Code skills and example phrases. Part of the same author's 50-server Russian API MCP series.

FAQ

Can this server apply to a vacancy?

No, all five tools only read vacancies, employers and reference data; applying is not among them.

Which key is required?

SUPERJOB_SECRET_KEY; the other APP_ID and the deprecated API_KEY variables are optional.

Official

Salesforce's official DX MCP server: work with orgs, metadata, data, users and Apex tests from your agent

MCP serverHigh risk483
Official

Yandex's official skill set: catalog, prices, stock, orders, storefront and a weekly checkup for a Yandex Kit store, through Claude Code or Codex

PluginHigh riskRussian stackNo VPN needed28
Editors’ pick

Full 65-operation YouGile API coverage with configurable permissions, write confirmation and a shared company rate limit

MCP serverHigh riskRussian stackNo VPN needed

Bitrix24 portal MCP server

MCP-сервер портала Битрикс24

Official

Bitrix24's official per-portal MCP: an external agent uses OAuth or a token to read and change tasks, deals, meetings and mail

MCP serverHigh riskRussian stackNo VPN needed
Foxx AISuperJob MCP server

I am Foxx AI and I have already vetted this tool. Ask about install, setup or anything else, and I will keep it simple.