# İŞKUR Jobs

> İŞKUR Jobs is an open-source MCP server for hiring and recruiting. Search Turkish İŞKUR public job listings, details, provinces and announcements. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Repository:** https://github.com/mohammad-abbasi-sh/iskur-mcp
- **MCP Registry name:** io.github.mohammad-abbasi-sh/iskur-mcp
- **Categories:** [hiring and recruiting](https://ai-powered.com/categories/hiring-and-recruiting)
- **Listing updated:** 2026-11-18

## About

This unofficial server reads the public open-job listings on the Turkish Employment Agency portal. Search accepts a keyword, a city name or code, a date range, full or part-time, an education level and a page number, with 15 results per page and a total and page count returned. A shortcut lists jobs posted in the last 24 hours, and a detail lookup returns the description, required skills, occupation, experience and minimum and maximum education.

It can also list the 81 provinces with their codes and read the agency's official announcements. The README notes two limits: employer names are hidden behind login and never returned, and the search is a slow WebForms postback of around 40 seconds, so narrow filters and page one are recommended.

It is read-only, sends requests about 0.8 seconds apart using Chrome TLS impersonation, runs with `uvx iskur-mcp`, and is MIT licensed. It is not affiliated with İŞKUR. Planned additions include occupation autocomplete and public-sector listings.

## Features

- **Job search filters:** Filter by keyword, city, date range, work type and education.
- **Latest jobs:** Lists listings posted in the last 24 hours.
- **Job detail:** Returns description, skills, occupation and experience.
- **Province list:** Provides the 81 provinces with codes.
- **Official announcements:** Reads the agency's duyurular.
- **Paged results:** Returns totals and page counts, 15 per page.

## Good for

- Find part-time jobs in a Turkish city
- Check new listings from the last day
- Read the requirements for a specific posting
- Compare education requirements across listings

## Install

### Claude Code (Terminal)

```sh
claude mcp add iskur-mcp -- uvx iskur-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "iskur-mcp": {
      "command": "uvx",
      "args": [
        "iskur-mcp"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "iskur-mcp": {
      "command": "uvx",
      "args": [
        "iskur-mcp"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "iskur-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "iskur-mcp"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "iskur-mcp": {
      "command": "uvx",
      "args": [
        "iskur-mcp"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "iskur-mcp": {
      "command": "uvx",
      "args": [
        "iskur-mcp"
      ]
    }
  }
}
```

## Tools

- `iskur_search_jobs`: Searches open job listings with filters.
- `iskur_latest_jobs`: Jobs posted in the last 24 hours.
- `iskur_get_job`: Detail of one listing.
- `iskur_list_cities`: Lists the 81 provinces.
- `iskur_list_announcements`: Reads official announcements.
- `iskur_health`: Checks that the portal is reachable.

## FAQ

### Are employer names shown?

No. They are hidden behind login on the site and never returned.

### Why is search slow?

The portal's search is a WebForms postback that takes about 40 seconds; narrow filters help.

### Can it apply for jobs?

No. It is read-only.

### How many provinces can I filter by?

All 81, by name or code.

### Is İŞKUR Jobs free?

Yes. İŞKUR Jobs is open source, so you can use and self-host it for free.

### How do I add İŞKUR Jobs to Claude Code?

Run this command in your terminal: claude mcp add iskur-mcp -- uvx iskur-mcp

### What are the best alternatives to İŞKUR Jobs?

The closest alternatives to İŞKUR Jobs are Reactive Resume, Joboracle, Gupy Jobs Scraper (Apify) - Brazil jobs with descriptions, OnlineJobs.ph Scraper (Apify) - Philippine remote and VA jobs with wages and Workday Jobs Scraper & API - All Companies, Last 24 Hours.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Reactive Resume](https://ai-powered.com/mcp/reactive-resume): Reactive Resume is an open-source MCP server for hiring and recruiting.
- [Joboracle](https://ai-powered.com/mcp/joboracle): Joboracle is a freemium MCP server for hiring and recruiting.
- [Gupy Jobs Scraper (Apify) - Brazil jobs with descriptions](https://ai-powered.com/mcp/gupy-jobs-scraper-apify-brazil-jobs-with-descriptions): Gupy Jobs Scraper (Apify) - Brazil jobs with descriptions is a freemium MCP server for web search and scraping.
- [OnlineJobs.ph Scraper (Apify) - Philippine remote and VA jobs with wages](https://ai-powered.com/mcp/onlinejobs-ph-scraper-apify-philippine-remote-and-va-jobs-wi): OnlineJobs.ph Scraper (Apify) - Philippine remote and VA jobs with wages is a paid MCP server for web search and scraping.
- [Workday Jobs Scraper & API - All Companies, Last 24 Hours](https://ai-powered.com/mcp/workday-jobs-scraper-and-api-all-companies-last-24-hours): Workday Jobs Scraper & API - All Companies, Last 24 Hours is a freemium MCP server for web search and scraping.
- [Lever Jobs Scraper & API - Salary, Remote, Last 24 Hours](https://ai-powered.com/mcp/lever-jobs-scraper-and-api-salary-remote-last-24-hours): Lever Jobs Scraper & API - Salary, Remote, Last 24 Hours is a paid MCP server for web search and scraping.
- [Workable Jobs Scraper & API - All Companies, Remote, 24 Hours](https://ai-powered.com/mcp/workable-jobs-scraper-and-api-all-companies-remote-24-hours): Workable Jobs Scraper & API - All Companies, Remote, 24 Hours is a freemium MCP server for web search and scraping.
- [Y Combinator Jobs Scraper & API - Work at a Startup, YC Jobs](https://ai-powered.com/mcp/y-combinator-jobs-scraper-and-api-work-at-a-startup-yc-jobs): Y Combinator Jobs Scraper & API - Work at a Startup, YC Jobs is a freemium MCP server for web search and scraping.

---
Source: https://ai-powered.com/mcp/iskur-jobs
