For AI agents

• What: unofficial MCP server (model context protocol) for irantalent.com, jobinja.ir and jobvision.ir, merged: job search, companies, top employers, market counts and pay from all three, plus each site's own tools.
• Install: uvx iran-jobs-mcp or claude mcp add iran-jobs -- uvx iran-jobs-mcp. Transport: stdio. Needs uv (Python 3.10+).
• Auth: none. Optional IRAN_JOBS_MCP_PROXY (HTTP proxy URL, or a comma-separated list) applies to all three sites; system proxy settings are ignored.
• Access: read-only. It cannot log in, apply, post, save jobs or write reviews.
• Tools: 37, all prefixed job_. Five merged tools take site (all default, irantalent, jobinja, jobvision) and answer with one block per site; if one site fails its block holds an error and the others still answer. The other 32 are one site's own tools (job_irantalent_*, job_jobinja_*, job_jobvision_*).
• Use when: the user looks for jobs in Iran, asks what a company is like to work for, which employers are best rated, which fields hire most, or what a role pays.
• Output: compact JSON. Pay is Toman per month on IranTalent and Jobinja, million Toman per month on Jobvision. Text is mostly Persian.

Quick start

You need uv. No API key or account.

Claude Code:

claude mcp add iran-jobs -- uvx iran-jobs-mcp

Claude Desktop, Cursor, VS Code and other clients:

{
  "mcpServers": {
    "iran-jobs": { "command": "uvx", "args": ["iran-jobs-mcp"] }
  }
}

Example prompts:

• "Find remote Python jobs in Iran on all job sites."
• "Is Digikala a good employer? Show reviews and interview reports."
• "How much does a senior Java developer earn in Iran?"
• آگهی‌های استخدام برنامه‌نویس پایتون در اصفهان را پیدا کن.
• حقوق حسابدار در تهران چقدر است؟

Tools

Merged (all three sites, site argument):

IranTalent:

Jobinja:

Jobvision:

Limits

• Ids belong to one site: pass an id only to the tool of the site it came from.
• Most ads hide pay. Jobinja and Jobvision pay figures are what ads state, not what people earn; IranTalent's are its salary survey.
• job_salary makes about 25 requests and job_market about 80 (Jobvision counts each category separately); both are cached for two minutes.
• Jobinja answers only Iranian networks. From abroad set IRAN_JOBS_MCP_PROXY to a proxy that works, or run from Iran. The server ignores system proxy variables on purpose.
• Applying, saved jobs, the salary calculator and other account features are not covered.

فارسی

claude mcp add iran-jobs -- uvx iran-jobs-mcp

Development

uv sync
uv run ruff check . && uv run ruff format --check .
uv run pytest -q          # offline tests on recorded fixtures
uv run pytest -m live -q  # live calls to the three sites

Releases: bump the version in pyproject.toml and server.json, run uv lock, then push a v* tag; GitHub Actions publishes to PyPI.

Disclaimer

Unofficial and not affiliated with or endorsed by IranTalent, Jobinja or Jobvision. It is read-only and uses the public API and pages of those sites, which can change without notice.

Author

Built and maintained by Sepehr Radmard (سپهر رادمرد). LinkedIn · GitHub · more servers in iran-mcp.

License

MIT