io.github.mohammad-abbasi-sh/iskur-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@io.github.mohammad-abbasi-sh/iskur-mcp find waiter jobs in Istanbul posted in the last week"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
iskur-mcp 🇹🇷
mcp-name: io.github.mohammad-abbasi-sh/iskur-mcp
Unofficial read-only MCP server for İŞKUR (iskur.gov.tr) — Türkiye İş Kurumu, the Turkish Employment Agency. Search the public open-job listings from the esube portal (keyword, city, date range, work type, education, pagination), get one job's detail (description, required skills, occupation, experience, education), list the 81 provinces, and read İŞKUR's official announcements.
Built by Mohammad Abbasi as part of the "Turkey MCP factory" (Sepehr-style pipeline). Not affiliated with İŞKUR or Türkiye İş Kurumu.
Note: employer names are hidden behind login on the site and are never returned; the detail page carries no deadline or city — those come from the search results. The search is a WebForms postback and is slow (~40s), so prefer page 1 and narrow filters.
For AI agents
Add to your MCP client config (stdio):
{
"mcpServers": {
"iskur": {
"command": "uvx",
"args": ["iskur-mcp==0.1.0"]
}
}
}Or run locally: python -m iskur_mcp.server (needs mcp<2, curl-cffi).
Related MCP server: Bossjob Scout MCP
Tools
Tool | Description |
| Search open job listings — |
| Jobs posted in the last 24 hours, optionally in one |
| Detail of one listing — |
| The 81 provinces — code + name (e.g. "34" İstanbul, "6" Ankara) |
| İŞKUR's official announcements (duyurular); |
| Check whether İŞKUR's job portal is reachable (ok / blocked / error) |
Example output (iskur_search_jobs / "garson", İstanbul, 2026-11-13):
{"keyword": "garson", "city": "İstanbul", "page": 1, "page_count": 5,
"total": 63,
"jobs": [{"job_no": "00009899349", "title": "Servis Elemanı (Garson)",
"sector": "Özel", "period": "Daimi", "work_type": "Tam Zamanlı",
"open_positions": 1,
"location": {"city": "İSTANBUL", "district": "SARIYER"},
"deadline": "30.11.2026", "days_left": "17 Gün Kaldı",
"url": "https://esube.iskur.gov.tr/Istihdam/AcikIsIlanDetay.aspx?uiID=00009899349&isyeriTuru=%C3%96zel"}]}How it works
Job search lives on esube.iskur.gov.tr (/Istihdam/AcikIsIlanAra.aspx, classic ASP.NET WebForms): GET the form for session cookies + the __VIEWSTATE family, then POST with __EVENTTARGET=ctl04$ctlAcikIsPageCommand$CommandItem_Search. Results render in the grid table ctl04_ctlGridAcikIslerListeDetail, 15 rows per page; each row has a PopupJobDetails('<jobno>','Özel','0') title link, spans for sector / period / work type, Label9 (open positions), ctlCalismaYeriDL ("İl Geneli Başvuru (Çalışma Yeri: İSTANBUL / SARIYER)"), ctlSonBasvuruTarihi (deadline) and ctlSonBasvuruDL ("17 Gün Kaldı"); "Toplam Kayıt: 63" is the total and the pager jumps via txtCurrentPage + btnChangeCurrentPage. Job detail is a plain GET (AcikIsIlanDetay.aspx?uiID=...&isyeriTuru=Özel, ~2s, no cookies): ctlGenelSartlar (description), ctlGenelSartlar2 (skills), ctlMeslekLabel (occupation) + experience spans, ctlOgrenimAsgari / ctlOgrenimAzami (education). Announcements are a plain GET of www.iskur.gov.tr/duyurular/ (<li class="clearfix"> with a <div class="date"> and a /duyurular/... link). Transport uses Chrome TLS impersonation (curl-cffi, chrome120 with rotation); the search postback gets a 180s timeout and one retry with a fresh session; requests are spaced ~0.8s apart; everything is read-only.
Install
uvx iskur-mcp==0.1.0 # run directly (needs uv)
# or
pip install iskur-mcp==0.1.0
iskur-mcp # starts the MCP server on stdioTests
python -m venv .venv && .venv/bin/pip install -e .
.venv/bin/python -m unittest discover -s tests -vOffline tests run on recorded fixtures (real pages fetched 2026-11-13); live tests hit esube.iskur.gov.tr and www.iskur.gov.tr (the search postback is slow, ~40s per call — live tests take ~3 minutes). Tests green at build time (see repo for counts) plus an MCP stdio smoke test.
Roadmap
Occupation (meslek) autocomplete search (the form's
ctlMeslekfield)Kamu (public-sector) listings via the sector radio
TYP / İŞKUR Gençlik programme listings (IstIupArama / TypArama)
License
MIT — see LICENSE.
Built by Mohammad Abbasi — Almanibama · mabbasi.ir
Available Tools
6 toolsiskur_get_jobA
Detail of one İŞKUR job listing.
job_no: the listing number from a search result (e.g. "00009899349"). Returns description, required skills, occupation, experience (years/months), min/max education, and the detail URL. The detail page carries no deadline or city — those come from iskur_search_jobs — and no employer name (login-gated on the site).
Inputs: job_no (required). Returns: result
iskur_healthA
Check whether İŞKUR's job portal is reachable right now.
Returns status ok (HTTP 200), blocked (HTTP 403/429 — bot wall or rate limit) or error, plus the HTTP status and the probed URL. One polite request; it does not run a search.
Inputs: no named parameters. Returns: result
iskur_latest_jobsA
Jobs posted on İŞKUR in the last 24 hours.
city: province name (e.g. "İstanbul") or code (e.g. "34") — empty means all provinces. limit: 1..15 jobs returned. Each job: job_no, title, sector, period, work_type, open_positions, location {scope, city, district}, deadline, days_left, url.
Inputs: city, limit. Returns: result
iskur_list_announcementsA
İŞKUR's official announcements (duyurular).
limit: 1..10 announcements returned (the site lists ~10 per page). Each announcement: date, title, url.
Inputs: limit. Returns: result
iskur_list_citiesA
The 81 Turkish provinces İŞKUR searches by — code + name.
Use the code (e.g. "34" for İstanbul) or the name in iskur_search_jobs / iskur_latest_jobs. Parsed live from the search form; falls back to the built-in list if the form cannot be read.
Inputs: no named parameters. Returns: result
iskur_search_jobsA
Search İŞKUR's open job listings.
keyword: Turkish job/occupation text (e.g. "garson", "aşçı") — empty means all jobs. city: province name (e.g. "İstanbul", "Ankara") or code (e.g. "34") — empty means all provinces. date_range: "all" (default), "last_24h", "last_week", "last_15d". work_type: "all" (default), "full" (Tam Zamanlı), "part" (Kısmi Zamanlı). education: "any" (default), "illiterate", "literate", "primary", "middle", "high", "associate", "bachelor", "master", "phd". page: results page (15 jobs per page; total and page_count are returned). limit: 1..15 jobs returned. Each job: job_no, title, sector, period, work_type, open_positions, location {scope, city, district}, deadline (dd.mm.yyyy), days_left, url. The search postback is slow (~40s); prefer page 1 and narrow filters.
Inputs: city, page, limit, keyword, +3 more. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 6 tools
Most tools are clearly separable: get_job (detail by job_no), list_cities (reference data), list_announcements, and health each have a distinct role. The one real overlap is iskur_latest_jobs versus iskur_search_jobs, since latest_jobs is effectively a pre-baked 'last 24h' search; the descriptions hint at this but do not explicitly tell the agent which to prefer. An agent could still pick correctly in most cases, but the boundary is soft.
All six tools share the iskur_ prefix and snake_case, which makes the set easy to scan. Most follow verb_noun (get_job, list_cities, list_announcements, search_jobs), but iskur_latest_jobs uses an adjective+noun form and iskur_health is a bare noun, so the pattern is not perfectly uniform.
Six tools is well-scoped for a single-source job board wrapper: search, latest, detail, reference list, announcements, and reachability check. Each tool earns its place and nothing feels like padding or a missing sibling.
The core lifecycle is covered: discover jobs (search/latest), paginate, drill into detail, resolve city codes, read announcements, and self-diagnose connectivity. Gaps are minor and partly imposed by the site (no employer name, no detail-page deadline), though the set offers no way to enumerate sectors, work types, or education levels as data the way it does cities.
Maintenance
Related MCP Connectors
Search MCP servers, agent skills and AI tools by task. Read-only, no API key.
Read-only MCP server for public WeJob jobs, formations, and companies.
Public MCP server for discovering open jobs. Search, filter, and get application links.
Search MCP servers, MCP clients and AI agents, and retrieve listing details. Free, read-only access.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceEnables any MCP host to search topstartups.io job postings by keyword, location, remote preference, and date, and to fetch individual job details through read-only tools.MIT
- AlicenseNot gradedqualityCmaintenanceEnables MCP hosts and agents to search public job listings and retrieve job details via standardized search_jobs and get_job tools, supporting keyword, location, remote, date, and limit filters. It is read-only and rate-limited, returning normalized results with apply and source URLs.MIT
- AlicenseAqualityBmaintenanceEnables searching and retrieving Singapore job postings from MyCareersFuture, including job details, skills suggestions, and filter metadata through read-only MCP tools.7552 npmApache 2.0
- AlicenseNot gradedqualityBmaintenanceEnables read-only, keyless access to hosted job search through nine MCP tools for browsing postings, matching candidates, retrieving job details and discussion threads, resolving locations, listing companies, getting stats, and performing deep-research search/fetch.313 npmMIT