Skip to main content
Glama
Sign In
jobscan-mcp

jobscan-mcp

by aminafara123
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Local

jobscan-mcp

M8ven Score

An MCP server over my job-scan-automation dataset: the daily market scan behind uae-remote-jobs-daily, exposed as tools that any MCP-capable AI client can call.

MCP (Model Context Protocol) is the open standard for giving AI models controlled access to tools and data. This server is the pattern in miniature and in production: my own dataset, four read-only tools, and a model on the other end that can suddenly answer questions like "any new GRC postings this week?" with real data instead of guesses.

Tools

Tool

What it does

latest_report()

Full text of the most recent daily scan

search_jobs(query, days)

Search postings across the last N days of reports, links included

market_stats(days)

Per-day relevant/new counts: the pulse of the niche market

is_seen(company, title)

Whether the scanner's dedupe memory already knows a posting

Related MCP server: joblet-mcp-grok

Setup

pipx install jobscan-mcp

uvx jobscan-mcp works too if you prefer no install. Hacking on a clone instead:

python3 -m venv .venv
.venv/bin/pip install mcp

It reads ~/aiProjects/aminWork/job-research/scraper. Point JOBSCAN_DATA_DIR at your own data folder if your copy lives somewhere else.

Wire it into Claude Code:

claude mcp add jobscan -- jobscan-mcp

Running from a clone, point it at the venv instead:

claude mcp add jobscan -- /path/to/jobscan-mcp/.venv/bin/python /path/to/jobscan-mcp/jobscan_mcp.py

Demo

What it looks like from Claude Code:

> check the job scan: anything new in IAM in the last week?

⏺ jobscan · search_jobs("IAM", 7)

  2 match(es) for 'IAM':

  [2026-09-26] - **IAM Engineer** at Falconride Logistics
    https://example.com/falconride/iam-engineer
  [2026-09-23] - **Identity and Access Analyst** at Northgate Retail
    https://example.com/northgate/iam-analyst

⏺ Two IAM roles surfaced this week. Falconride is the Dubai one,
  Northgate is remote. Neither was in the scan before Tuesday.

The postings above are demo data. The format is exactly what the server returns.

Design notes

  • Read-only by construction. Every tool reads files, nothing mutates the dataset. Giving a model tools means deciding what it must never be able to do, and here that decision is structural, not a prompt instruction.

  • Sanitization at the boundary. The underlying reports can carry the operator's personal notes, so the server strips them before anything crosses the protocol. Data boundaries belong in code, not in hope.

  • Small on purpose. Four tools, one file, standard library plus the mcp SDK. An MCP server doesnt need to be a platform to be useful. It just needs to expose the right verbs over data you actually maintain.

About

Al Amin Bashir Afara, Dubai · github.com/aminafara123 · linkedin.com/in/aminafara

Available Tools

4 tools
is_seenB
Read-onlyIdempotent

Whether the scanner's dedupe memory already contains this company+title posting (i.e. it has been surfaced before).

Inputs: title (required), company (required). Returns: result

latest_reportA
Read-onlyIdempotent

Full text of the most recent daily scan report (markdown).

Inputs: no named parameters. Returns: result

market_statsA
Read-onlyIdempotent

Per-day counts of relevant and new postings over the last N days, parsed from the reports: a quick pulse of the niche market.

Inputs: days. Returns: result

search_jobsA
Read-onlyIdempotent

Search postings in the last N days of reports. Case-insensitive substring match over title/company lines; returns each hit with its link and the report date it appeared.

Inputs: query (required), days. Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Deploy Server
    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    TDQS

    A3.6/5.0

    Scored across 4 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: latest_report returns raw markdown, search_jobs finds matching postings, market_stats aggregates counts, and is_seen checks dedupe memory. There is no meaningful overlap in agent selection.

    Naming Consistency3/5

    All names use snake_case, but the semantic convention is mixed: latest_report is adjective_noun, search_jobs is verb_noun, market_stats is noun_noun, and is_seen is a past-participle boolean check. The names are readable but not predictable as a set.

    Tool Count5/5

    Four tools are well-scoped for a read-only job scan report server. Each tool earns its place: latest report access, search, aggregate stats, and dedupe lookup.

    Completeness3/5

    The surface covers common queries over recent reports but lacks a way to list available report dates or fetch a specific older report by date. search_jobs and market_stats work only over the last N days, leaving a notable gap for historical full-report access.

    Maintenance

    ActivitySlowing
    ResponsivenessNo recent community issues

    Resources

    Related MCP Connectors

    Related MCP Servers

    • mcp-job-radar

      RaphaelCerri
      A
      license
      A
      quality
      C
      maintenance
      Enables AI agents to search, rank, and explain job matches through a secure read-only interface that blocks prompt injections and unsafe content.
      4
      MIT

    • joblet-mcp-grok

      Joblet-Official
      -
      license
      Not graded
      quality
      C
      maintenance
      Enables Grok and any standards-compliant MCP host to search joblet.ai job postings and retrieve full job details, including requirements, responsibilities, salary, and apply links, through read-only tools.
      -

    • jd-mcp

      NaoYUN77
      A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI agents to crawl, analyze, and query job description (JD) data from recruitment sites via MCP, with tools for searching jobs, viewing statistics and portraits, and running local analysis on privately stored data.
      MIT

    • level-jobs-mcp

      finalburner
      A
      license
      Not graded
      quality
      C
      maintenance
      Enables users to search a public job catalog by query, AI level, remote/city/company/recency, retrieve full job records, and look up AI levels for job titles without an API key. It provides read-only access via stdio or a hosted HTTP endpoint.
      MIT