getjobzi-mcp

Analyse live UK market demand for a role over the last N months (default 6): total postings, month-by-month trend, top hiring employers, and top locations. Deterministic — reads GetJobzi's aggregated posting data directly.

{
  "type": "object",
  "properties": {
    "role": {
      "type": "string",
      "description": "Role title to analyse, e.g. 'Data Engineer'"
    },
    "location": {
      "type": "string",
      "description": "Optional UK location filter"
    },
    "months": {
      "type": "integer",
      "description": "Months of history, 1-24, default 6"
    }
  },
  "required": [
    "role"
  ],
  "additionalProperties": false
}

Propose a 90-day job-search strategy for a specific target role, grounded in the candidate's resume: positioning, target segments, outreach approach, application cadence, and what to stop doing.

{
  "type": "object",
  "properties": {
    "resumeText": {
      "type": "string",
      "description": "Plain-text content of the resume/CV"
    },
    "resumeBase64": {
      "type": "string",
      "description": "Base64-encoded PDF content of the resume"
    },
    "targetRole": {
      "type": "string",
      "description": "Target role, e.g. 'Product Manager'"
    },
    "constraints": {
      "type": "string",
      "description": "Optional constraints, e.g. 'must stay in the UK'"
    }
  },
  "required": [
    "targetRole"
  ],
  "additionalProperties": false
}

Generate a tailored, plain-text cover letter for a specific job, grounded in the candidate's resume. Does not invent experience. Provide the resume as plain text or base64 PDF, plus the job title and full job description.

{
  "type": "object",
  "properties": {
    "resumeText": {
      "type": "string",
      "description": "Plain-text content of the resume/CV"
    },
    "resumeBase64": {
      "type": "string",
      "description": "Base64-encoded PDF content of the resume"
    },
    "jobTitle": {
      "type": "string",
      "description": "Job title being applied for"
    },
    "jobDescription": {
      "type": "string",
      "description": "Full job description text"
    },
    "company": {
      "type": "string",
      "description": "Optional company name"
    }
  },
  "required": [
    "jobTitle",
    "jobDescription"
  ],
  "additionalProperties": false
}

Review a resume and produce LinkedIn-optimised copy: a headline (max 220 chars), an About section (max 2600 chars, first-person), 10-15 top skills, and short review notes on what to improve. Grounded in the resume — will not invent experience.

{
  "type": "object",
  "properties": {
    "resumeText": {
      "type": "string",
      "description": "Plain-text content of the resume/CV"
    },
    "resumeBase64": {
      "type": "string",
      "description": "Base64-encoded PDF content of the resume"
    }
  },
  "required": [],
  "additionalProperties": false
}

Analyse a CV/resume and return a 0-100 ATS-readiness score, word and keyword counts, the top extracted keywords, and specific notes on gaps or issues (missing contact details, missing section headers, length problems). Provide the resume as plain text via resumeText, or as a base64-encoded PDF via resumeBase64.

{
  "type": "object",
  "properties": {
    "resumeText": {
      "type": "string",
      "description": "Plain-text content of the resume/CV"
    },
    "resumeBase64": {
      "type": "string",
      "description": "Base64-encoded PDF content of the resume"
    }
  },
  "required": [],
  "additionalProperties": false
}

Analyse the realistic path from a current role to a target role: 4-6 ordered milestones, a realistic estimated timeline, the skills to acquire, and a short narrative covering trade-offs.

{
  "type": "object",
  "properties": {
    "currentRole": {
      "type": "string",
      "description": "The role they're currently in, e.g. 'Software Engineer'"
    },
    "targetRole": {
      "type": "string",
      "description": "The role they want to reach, e.g. 'Engineering Manager'"
    },
    "yearsExperience": {
      "type": "integer",
      "description": "Optional years of experience"
    }
  },
  "required": [
    "currentRole",
    "targetRole"
  ],
  "additionalProperties": false
}

Create a practical, week-by-week job search plan for a target role, including weekly targets, sources and search strategies, and pitfalls to avoid.

{
  "type": "object",
  "properties": {
    "targetRole": {
      "type": "string",
      "description": "Target role, e.g. 'Data Engineer'"
    },
    "location": {
      "type": "string",
      "description": "Optional location, e.g. 'Manchester'"
    },
    "situation": {
      "type": "string",
      "description": "Optional free-text description of the candidate's current situation"
    },
    "timeAvailable": {
      "type": "string",
      "description": "Optional time they can commit, e.g. '10 hours/week'"
    }
  },
  "required": [
    "targetRole"
  ],
  "additionalProperties": false
}

Build a structured development plan to close a set of skill gaps for a target role: what to learn, how to practice, a small deliverable per skill, and a week-by-week schedule. Pair with identify_skill_gaps — feed its missingSkills straight into this.

{
  "type": "object",
  "properties": {
    "skillGaps": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "List of skills to develop, e.g. from identify_skill_gaps"
    },
    "targetRole": {
      "type": "string",
      "description": "Target role the plan is built around"
    },
    "weeks": {
      "type": "integer",
      "description": "Optional plan length in weeks, 2-52, default 12"
    }
  },
  "required": [
    "skillGaps",
    "targetRole"
  ],
  "additionalProperties": false
}

Diagnose why a job search isn't producing interviews, from caller-supplied application/interview counts. Returns interview conversion, likely issues, priority actions, and an optional short narrative (null if generation failed — never fabricated). This is a lightweight, stateless diagnostic — it does not use GetJobzi's account-level job search history and never states or implies a probability of being hired.

{
  "type": "object",
  "properties": {
    "targetRole": {
      "type": "string",
      "description": "Target role, e.g. 'Software Engineer'"
    },
    "applications": {
      "type": "integer",
      "description": "Total applications submitted"
    },
    "interviews": {
      "type": "integer",
      "description": "Total interviews received"
    },
    "months": {
      "type": "integer",
      "description": "Months spent searching"
    },
    "resumeText": {
      "type": "string",
      "description": "Optional plain-text resume for additional context"
    }
  },
  "required": [
    "targetRole",
    "applications",
    "interviews",
    "months"
  ],
  "additionalProperties": false
}

Full details of one job posting by its GetJobzi job id (from search_jobs), including the complete job description text.

{
  "type": "object",
  "properties": {
    "jobId": {
      "type": "integer",
      "description": "Job id from search_jobs results"
    }
  },
  "required": [
    "jobId"
  ],
  "additionalProperties": false
}

Find NHS job postings — NHS trusts are licensed visa sponsors, so most roles at these trusts are eligible for Skilled Worker sponsorship where the salary meets the threshold. Filtered to NHS Jobs postings only. Returns the same shape as search_jobs, with the full job description included.

{
  "type": "object",
  "properties": {
    "keyword": {
      "type": "string",
      "description": "Keyword or job title, e.g. 'Nurse' or 'Radiographer'"
    },
    "location": {
      "type": "string",
      "description": "Optional UK location filter"
    },
    "limit": {
      "type": "integer",
      "description": "Max results 1-20, default 10"
    }
  },
  "required": [
    "keyword"
  ],
  "additionalProperties": false
}

Find live UK job postings that match a candidate's resume. Extracts the top keywords from the resume, searches GetJobzi's aggregated postings, and ranks results by similarity between the resume text and each posting's description.

{
  "type": "object",
  "properties": {
    "resumeText": {
      "type": "string",
      "description": "Plain-text content of the resume/CV"
    },
    "resumeBase64": {
      "type": "string",
      "description": "Base64-encoded PDF content of the resume"
    },
    "location": {
      "type": "string",
      "description": "Optional UK location filter, e.g. 'London' or 'M1'"
    },
    "limit": {
      "type": "integer",
      "description": "Max results 1-20, default 10"
    }
  },
  "required": [],
  "additionalProperties": false
}

GetJobzi's UK salary benchmark: median advertised salary on each major UK job board, from GetJobzi's internal salary index. Answers questions like 'which job board has the best paid jobs' or 'is this advertised salary competitive'. Figures are advertised (not negotiated) salaries in GBP.

{
  "type": "object",
  "properties": {},
  "required": [],
  "additionalProperties": false
}

Identify skills a candidate is missing for a target role. If a job description is supplied, uses that; otherwise aggregates GetJobzi's live postings for the target role as the market signal. Returns present skills, missing skills (ordered by market frequency), how many postings were analysed, and notes.

{
  "type": "object",
  "properties": {
    "resumeText": {
      "type": "string",
      "description": "Plain-text content of the resume/CV"
    },
    "resumeBase64": {
      "type": "string",
      "description": "Base64-encoded PDF content of the resume"
    },
    "targetRole": {
      "type": "string",
      "description": "Target role, e.g. 'Product Manager'"
    },
    "jobDescription": {
      "type": "string",
      "description": "Optional specific job description to scope the analysis"
    }
  },
  "required": [
    "targetRole"
  ],
  "additionalProperties": false
}

Compare a resume against a specific job description. Returns a 0.0-1.0 keyword-coverage score, matched keywords, missing keywords (ordered by frequency in the job description), and short notes. Deterministic — no LLM involved, will not invent gaps.

{
  "type": "object",
  "properties": {
    "resumeText": {
      "type": "string",
      "description": "Plain-text content of the resume/CV"
    },
    "resumeBase64": {
      "type": "string",
      "description": "Base64-encoded PDF content of the resume"
    },
    "jobDescription": {
      "type": "string",
      "description": "Full job description text to compare against"
    }
  },
  "required": [
    "jobDescription"
  ],
  "additionalProperties": false
}

Generate a personalised job hunting action plan for a job seeker targeting a specific role. Takes only the caller's own inputs (target role, resume, situation, goals).

{
  "type": "object",
  "properties": {
    "targetRole": {
      "type": "string",
      "description": "The role the plan should be built around, e.g. 'Senior Data Analyst'"
    },
    "resumeText": {
      "type": "string",
      "description": "Plain-text resume content"
    },
    "resumeBase64": {
      "type": "string",
      "description": "Base64-encoded PDF resume"
    },
    "situation": {
      "type": "string",
      "description": "Free-text description of the current situation"
    },
    "goals": {
      "type": "string",
      "description": "Free-text description of what they're trying to achieve"
    }
  },
  "required": [
    "targetRole"
  ],
  "additionalProperties": false
}

Search live UK job postings aggregated by GetJobzi from major UK job boards (Indeed, Reed, CV-Library, TotalJobs, LinkedIn, Adzuna, NHS Jobs and others). Returns matching active jobs with title, company, location, advertised salary, source board and posting date.

{
  "type": "object",
  "properties": {
    "keyword": {
      "type": "string",
      "description": "Keyword or job title, e.g. 'Java Developer' or 'Nurse'"
    },
    "location": {
      "type": "string",
      "description": "Optional UK location filter, e.g. 'London' or 'M1'"
    },
    "limit": {
      "type": "integer",
      "description": "Max results 1-20, default 10"
    }
  },
  "required": [
    "keyword"
  ],
  "additionalProperties": false
}

Score the health of a job search across three factors — application volume, interview conversion, and interview-to-offer conversion — and give a short written diagnosis. Takes the caller's own counts; will not invent numbers.

{
  "type": "object",
  "properties": {
    "targetRole": {
      "type": "string",
      "description": "Target role, e.g. 'Software Engineer'"
    },
    "applications": {
      "type": "integer",
      "description": "Total applications submitted"
    },
    "interviews": {
      "type": "integer",
      "description": "Total interviews received"
    },
    "offers": {
      "type": "integer",
      "description": "Total offers received"
    },
    "months": {
      "type": "integer",
      "description": "Months spent searching"
    }
  },
  "required": [
    "targetRole",
    "applications",
    "interviews",
    "offers",
    "months"
  ],
  "additionalProperties": false
}