Skip to main content
Glama
sepehr071
by sepehr071

jobvision-mcp: Jobvision (جاب‌ویژن) Iran jobs MCP server for AI agents

jobvision-mcp is an unofficial, read-only MCP server that gives AI agents the job ads of Jobvision (jobvision.ir), the largest Iranian job portal. Its 14 tools search job ads with real filters, read a full ad, find similar ads, find companies by name and read their profile, rating and interview reports, estimate pay from advertised salaries and from Jobvision's career-guide salary survey, count open ads per category or province, and list public-sector hiring news. No API key or Jobvision account is needed. It works in Claude, Cursor, Copilot and any other MCP client.

PyPI Python License: MIT

For AI agents · Quick start · Tools · FAQ · فارسی


For AI agents

  • What: unofficial MCP server (model context protocol) for jobvision.ir: job search with filters (city, category, work type, seniority, experience, remote, internship, military service, posted within, minimum advertised pay), full job ads, similar ads, company profiles with open ads, advertised-pay statistics and lookup lists.

  • Install: uvx jobvision-mcp or claude mcp add jobvision -- uvx jobvision-mcp. Transport: stdio. Needs uv (Python 3.10+).

  • Auth: none, no API key or account. Optional JOBVISION_MCP_PROXY (HTTP proxy URL, or a comma-separated list); system proxy settings are ignored.

  • Access: read-only. It cannot log in, apply, save jobs or post ads, so no confirmation is needed before calling any tool.

  • Tools: 14, all prefixed jv_. Typical sequences: jv_search -> jv_job -> jv_company; jv_companies -> jv_interviews; jv_careers -> jv_career for salary levels; jv_pay_stats for "how much does X earn"; jv_locations / jv_options when a city, category or industry needs a slug or id.

  • Use when: the user wants jobs in Iran (استخدام), wants to compare employers or cities, or wants to know what a role pays in ads.

  • Do not use when: the user needs Jobvision's salary calculator or employee company reviews (account only; interview reports are covered), or jobs outside Iran.

  • Output: compact JSON. Pay is the advertised monthly range in million Toman (most ads hide it). Dates are ISO UTC. Texts are Persian or English as employers wrote them.

  • Machine-readable: server.json.

Related MCP server: zar-jobs-ai-connector

Quick start

claude mcp add jobvision -- uvx jobvision-mcp

Any MCP client: command uvx, args ["jobvision-mcp"]. Behind a proxy set JOBVISION_MCP_PROXY=http://host:port.

Tools

Tool

Use it to

jv_search

Search ads by keyword with filters; sort by newest, relevance or advertised pay; paged

jv_job

Read one ad: description, required software, conditions, benefits, pay, location, dates, employer

jv_similar_jobs

Ads Jobvision considers similar to one ad

jv_company

Employer profile (size, industries, founded, website, benefits) and its open ads

jv_pay_stats

Median, quartiles and extremes of the pay that matching ads advertise (samples up to 300 ads)

jv_suggest

Job-title autocomplete with how often titles occur

jv_locations

Province, city and Tehran-area names with the slugs the city filter takes

jv_options

Categories, industries, benefits, salary ranges and other filter lists

jv_companies

Company directory: search by name, filter by province, industry, size, rating band, hiring; ranked by Jobvision score

jv_interviews

A company's interview reports: score, difficulty, typical duration, common steps, individual reports or questions asked

jv_careers

~100 career-guide job titles ranked by satisfaction, median salary or open ads

jv_career

One job title: salary distribution (by city group), ad growth, duties, skills, how to enter, related careers

jv_market

Open-ad counts split by category, province, work type, seniority, experience, pay band or age

jv_government_news

Recruitment announcements for banks, ministries, oil and gas and other public sectors; read one in full

Example: "python jobs in Isfahan that pay at least 40 million" -> jv_search(keyword="python", city="اصفهان", salary_min=40, sort="salary").

FAQ

Is this official? No. It reads the public JSON that jobvision.ir's own website uses. Requests are cached briefly and spaced out.

Does it show salaries? Only what ads advertise (about one in five ads shows a range). jv_pay_stats says how many ads it based its numbers on.

Where do real salaries come from? jv_career and jv_careers use Jobvision's own career-guide survey (median pay per job title, optionally per city group), which covers jobs whose ads hide pay.

Can it apply to jobs? No, it is read-only.

فارسی

jobvision-mcp یک سرور MCP غیررسمی و فقط‌خواندنی برای جاب‌ویژن (jobvision.ir) است: جستجوی آگهی‌های استخدام با فیلتر (شهر، گروه شغلی، نوع همکاری، سطح ارشدیت، سابقه، دورکاری، کارآموزی، امریه، حداقل حقوق)، متن کامل آگهی، آگهی‌های مشابه، پروفایل شرکت و آگهی‌های باز آن و آمار حقوق اعلام‌شده در آگهی‌ها. به کلید API یا حساب کاربری نیاز ندارد.

نصب: uvx jobvision-mcp


Unofficial project, not affiliated with Jobvision. MIT license. Author: Sepehr Radmard (سپهر رادمرد), github.com/sepehr071.

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    A
    maintenance
    MCP server for job search and application tracking, enabling AI agents to search jobs, get details, manage applications, and find contacts across 128K+ jobs and 1,900+ companies.
    847 npm
    3
    MIT
  • A
    license
    Not graded
    quality
    A
    maintenance
    MCP server that enables AI assistants to search and normalize job offers from portals like InfoJobs, while keeping the user in control of decisions. It provides read-only tools and respects official APIs and credentials.
    MIT
  • A
    license
    A
    quality
    C
    maintenance
    An unofficial MCP server that lets AI assistants search Profesia.sk job offers, read full listings, bulk-collect results, and gather application links, emails and selection-process details so a tailored CV, cover letter or application email can be drafted. It is read-only, never submits applications or handles credentials, and enforces robots.txt, rate limits and caching.
    7
    MIT
  • A
    license
    A
    quality
    A
    maintenance
    An unofficial, read-only MCP server that lets AI agents pull current Persian-language headlines and article text from six outlets — Mehr, Khabaronline, Hamshahri, Tabnak, Zoomit and Digiato. It exposes latest items per source and category, a time-merged overview, cross-source keyword search, and full story bodies.
    6
    221 PyPI
    MIT