Skip to main content
Glama
aminafara123

jobscan-mcp

by aminafara123

jobscan-mcp

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: mcp-job-radar

Setup

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

Wire it into Claude Code:

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

Then just ask: "check the job scan: anything new in IAM in the last week?" and watch the model call search_jobs("IAM", 7) on its own.

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

Related MCP Connectors

Related MCP Servers

  • A
    license
    A
    quality
    B
    maintenance
    Enables searching over 1 million enriched job listings from 20,000+ companies directly from MCP-compatible AI tools. Provides tools for job search, company profiles, and AI-powered similar job recommendations with real-time data updates.
    4
    53 npm
    2
    MIT
  • 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
  • -
    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.
    -
  • A
    license
    Not graded
    quality
    B
    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