MCP Job Toolkit
An MCP (Model Context Protocol) server that searches for jobs across Australian job platforms from inside Claude or any MCP-compatible client.
Platforms
| Platform | Notes |
|---|---|
| Seek | Parses Apollo SSR cache from au.seek.com |
| Guest jobs API, includes applicant count where available |
Installation
Prerequisites: Node.js 18+
git clone https://github.com/afrozk/mcp-job-toolkit.git
cd mcp-job-toolkit
npm install
npm run build
Claude Desktop Setup
Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):
{
"mcpServers": {
"mcp-job-toolkit": {
"command": "node",
"args": ["/absolute/path/to/mcp-job-toolkit/dist/index.js"]
}
}
}
Restart Claude Desktop. The search_jobs tool will appear automatically.
Usage
Once connected, ask Claude naturally:
"Find contract backend engineer roles in Melbourne posted in the last 7 days" "Search for full-time data analyst jobs in Sydney with salary above $100k/year on Seek" "Show me software engineer roles in Brisbane with fewer than 20 applicants"
Tool: search_jobs
Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
keyword | string | required | Job title, role, or skill (e.g. "software engineer") |
location | string | required | Australian city or suburb (e.g. "Melbourne VIC", "Sydney") |
radius | number | 50 | Search radius in km |
employment_type | array | all | "fulltime", "parttime", "contract", "casual" |
salary_type | string | — | "hourly", "monthly", "yearly" |
salary_min | number | — | Minimum salary in the unit matching salary_type |
salary_max | number | — | Maximum salary |
date_posted | string | — | "24h", "2d", "3d", "7d", "30d" |
max_applications | number | — | Exclude jobs with more applicants than this (where exposed) |
platforms | array | all | "seek", "linkedin" |
page | number | 1 | Page number |
per_page | number | 10 | Results per page per platform (max 25) |
Example tool call
{
"keyword": "senior backend engineer",
"location": "Melbourne VIC",
"radius": 30,
"employment_type": ["contract", "fulltime"],
"salary_type": "yearly",
"salary_min": 120000,
"date_posted": "7d",
"max_applications": 25,
"platforms": ["seek", "linkedin"],
"per_page": 10
}
Response shape
{
"results": [
{
"platform": "seek",
"jobs": [
{
"id": "seek-91878509",
"title": "Senior Backend Engineer",
"company": "Acme Corp",
"location": "Melbourne VIC",
"salary": "$140,000 – $160,000 per year",
"description": "We are looking for...",
"url": "https://au.seek.com/job/91878509",
"posted_at": "2026-05-04T01:54:46.000Z",
"applications_count": null,
"platform": "seek"
}
],
"total": 41,
"page": 1
},
{
"platform": "linkedin",
"jobs": [],
"page": 1
}
],
"summary": [
{ "platform": "seek", "count": 10, "total": 41 },
{ "platform": "linkedin", "count": 8 }
],
"fetched_at": "2026-05-05T00:00:00.000Z"
}
Development
# Run without building (uses tsx)
npm run dev
# Rebuild after changes
npm run build
# Run built server
npm start
License
MIT