MCP Server

Job Spotter

io.github.GoodTurnStudio/jobspotter
Business & Operations Search & Research Public & reachable MCP 2026-07-28

What this MCP does

Searches current US and UK job listings by role, location, remote status, and related filters, and retrieves details for individual results.

apply_kit
Everything needed to apply for a job
Everything needed to apply for a job. For "help me apply for this", "write my cover letter", "what should I say in my application?". Gives what the job asks for, the lines in the CV that prove each skill, what is missing, keywords to use if true, a cover letter outline and common application questions with how to answer them, so a tailored letter and answers can be written. Job Spotter never applies or sends anything. Nothing sent is stored.
Read only Open world Idempotent
Input schema
{'type': 'object', 'required': [], 'properties': {'cv': {'type': 'string', 'description': 'The CV as plain text. Optional if titles and skills are given.'}, 'id': {'type': 'string', 'description': 'A job id from a search result, copied exactly. Or give job_text.'}, 'skills': {'type': 'string', 'description': 'Skills, comma separated.'}, 'titles': {'type': 'string', 'description': 'Current and past job titles, comma separated.'}, 'schools': {'type': 'string', 'description': 'Universities or schools, comma separated.'}, 'job_text': {'type': 'string', 'description': 'The job advert as plain text, when there is no id.'}, 'location': {'type': 'string', 'description': 'Where the person lives or wants to work.'}, 'education': {'type': 'string', 'description': 'Highest qualification, for example "BSc Economics".'}, 'employers': {'type': 'string', 'description': 'Current and past employers, comma separated.'}, 'years_experience': {'type': 'number', 'description': 'Years of work experience.'}}, 'additionalProperties': False}
check_job_link
Check a job link someone pastes
Check a job link someone pastes. For "is this job real?", "what does this one pay?" with a link. Reads the advert from the employer's job board (Greenhouse, Lever, SmartRecruiters, Ashby and most career pages) and gives the title, company, place, pay, when it was posted, whether it looks like a live, open job, visa sponsorship and a short summary. LinkedIn, Indeed and Glassdoor pages can't be read; the advert text can be pasted into the CV match instead.
Read only Open world Idempotent
Input schema
{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'description': 'The full link to the job advert.'}}, 'additionalProperties': False}
check_salary
What a job pays in a place
What a job pays in a place. For "what does a nurse earn in Birmingham", "average salary for a data analyst in Austin", "is £35k good for a junior developer in London". Gives the typical yearly range (middle half of current adverts), the middle figure and the average advertised, from current job adverts. Advertised pay, not offers.
Read only Open world Idempotent
Input schema
{'type': 'object', 'required': ['what'], 'properties': {'what': {'type': 'string', 'description': 'Job title or field, for example "nurse" or "software engineer".'}, 'where': {'type': 'string', 'description': 'A city, region, postcode or country, for example Birmingham, Austin, TX or remote.'}, 'country': {'type': 'string', 'description': 'US or UK when the place exists in both, or a country by name.'}}, 'additionalProperties': False}
check_visa_sponsor
Is this UK employer a licensed visa sponsor?
Is this UK employer a licensed visa sponsor? For "does Deliveroo sponsor visas?", "can this company sponsor a Skilled Worker visa?". Looks the employer up in the UK Home Office register of licensed sponsors (workers), with its town and the visa routes it is licensed for, and the register date. A licence means the employer can sponsor; each job still has to qualify. Company names on the register are legal names, so try the legal name if the brand name is not found. For US jobs, the visa_sponsorship field on search results comes from the advert. Register data contains public sector information licensed under the Open Government Licence v3.0.
Read only Open world Idempotent
Input schema
{'type': 'object', 'required': ['company'], 'properties': {'company': {'type': 'string', 'description': 'The employer, for example "Tesco" or its legal name "Tesco Stores Limited".'}}, 'additionalProperties': False}
company_lookup
Facts about an employer and its hiring
Facts about an employer and its hiring. For "tell me about Monzo as an employer", "is Tesco hiring?", "how big is this company?". Gives what the company does, when it was founded, staff numbers, headquarters and website (from Wikidata), UK company records when available (Companies House, Open Government Licence), how many jobs it has open now with examples, and ready searches for people there. Staff reviews are not included. For US employers it adds what they offered on US work visa filings.
Read only Open world Idempotent
Input schema
{'type': 'object', 'required': ['name'], 'properties': {'name': {'type': 'string', 'description': 'The company name, for example "Monzo" or "Tesco".'}, 'where': {'type': 'string', 'description': 'Optional place to narrow its open jobs, for example London.'}}, 'additionalProperties': False}
compare_jobs
Compare jobs side by side
Compare jobs side by side. For "compare the first three", "which of these pays best?". Takes two to five ids from search results and gives each job's pay (and yearly equivalent), work type, job type, how new it is, direct employer or agency, visa sponsorship and ghost-job check, plus which is best on pay, newest and remote.
Read only Open world Idempotent
Input schema
{'type': 'object', 'required': ['ids'], 'properties': {'ids': {'type': 'string', 'description': 'Two to five job ids from search results, comma separated, copied exactly.'}}, 'additionalProperties': False}
connection_score
How relevant a connection is to your goal
How relevant a connection is to your goal. For "should I connect with this person?", "is she worth messaging?". Scores how relevant a connection is to the user's goal, out of 100, from two profiles the user provides (it rates the fit with the goal, not the person), the same way every time: works where they want to work, recruiter or likely hiring manager for the goal, same school, same past employer, shared skills, nearby, more senior. Gives the reasons, a short verdict and an outline for a short note. Profiles can be pasted text (for example from LinkedIn's Save to PDF). Nothing sent is stored.
Read only Open world Idempotent
Input schema
{'type': 'object', 'required': ['me', 'them'], 'properties': {'me': {'type': 'object', 'properties': {'text': {'type': 'string', 'maxLength': 20000}, 'title': {'type': 'string', 'maxLength': 120}, 'skills': {'type': 'string', 'maxLength': 1000}, 'company': {'type': 'string', 'maxLength': 80}, 'schools': {'type': 'string', 'maxLength': 300}, 'location': {'type': 'string', 'maxLength': 60}, 'employers': {'type': 'string', 'maxLength': 300}}, 'description': 'A profile: text, and or fields title, company, past_companies, schools, location, skills.'}, 'goal': {'type': 'string', 'description': 'What the person is aiming for, for example "data analyst at Monzo".'}, 'them': {'type': 'object', 'properties': {'text': {'type': 'string', 'maxLength': 20000}, 'title': {'type': 'string', 'maxLength': 120}, 'skills': {'type': 'string', 'maxLength': 1000}, 'company': {'type': 'string', 'maxLength': 80}, 'schools': {'type': 'string', 'maxLength': 300}, 'location': {'type': 'string', 'maxLength': 60}, 'employers': {'type': 'string', 'maxLength': 300}}, 'description': 'A profile: text, and or fields title, company, past_companies, schools, location, skills.'}}, 'additionalProperties': False}
cover_letter
Draft a cover letter and application answers
Draft a cover letter and application answers. For "write my cover letter for this job" or "help me answer these application questions". Builds a first draft only from the person's own CV lines and the advert: the strongest matching achievements, the skills the job asks for in the CV's own words, an honest gap line, and draft answers to the form's questions. Anything only the person can know is left as a [bracketed] prompt. Job Spotter never applies or sends anything, and nothing sent is stored.
Read only Open world Idempotent
Input schema
{'type': 'object', 'required': [], 'properties': {'cv': {'type': 'string', 'description': 'The CV as plain text. Optional if titles and skills are given.'}, 'id': {'type': 'string', 'description': 'A job id from a search result, copied exactly. Or give job_text.'}, 'skills': {'type': 'string', 'description': 'Skills, comma separated.'}, 'titles': {'type': 'string', 'description': 'Current and past job titles, comma separated.'}, 'company': {'type': 'string', 'description': "The employer's name, when the advert is pasted as job_text."}, 'schools': {'type': 'string', 'description': 'Universities or schools, comma separated.'}, 'job_text': {'type': 'string', 'description': 'The job advert as plain text, when there is no id.'}, 'location': {'type': 'string', 'description': 'Where the person lives or wants to work.'}, 'education': {'type': 'string', 'description': 'Highest qualification, for example "BSc Economics".'}, 'employers': {'type': 'string', 'description': 'Current and past employers, comma separated.'}, 'questions': {'type': 'string', 'description': 'Application form questions to draft answers for, one per line. Common questions are used if left out.'}, 'your_name': {'type': 'string', 'description': "The person's name, to sign the letter."}, 'why_company': {'type': 'string', 'description': 'One specific reason they want this employer, in their words. Left as a gap to fill in if not given.'}, 'availability': {'type': 'string', 'description': 'When they could start, for example "I can start in May".'}, 'years_experience': {'type': 'number', 'description': 'Years of work experience.'}}, 'additionalProperties': False}
employer_reply_rate
How often an employer replies to applications
How often an employer replies to applications. For "do they actually reply?". From Job Spotter users who track their applications: the share of applications that got any answer (interview, offer or rejection) within the time tracked, and the usual wait. Shown only from 5 tracked applications, so nobody can be singled out.
Read only Open world Idempotent
Input schema
{'type': 'object', 'required': ['company'], 'properties': {'company': {'type': 'string', 'description': 'The employer, for example "Monzo".'}}, 'additionalProperties': False}
fair_hiring_check
Check an employer against the fair hiring badge
Check an employer against the fair hiring badge. For "is this employer fair to applicants?". Four checks from what the employer does: shows pay in its adverts on Job Spotter, replies to tracked applications, hires through scored consent-first introductions, and (UK employers with 250 or more staff) reports its gender pay gap on time. Each check comes with its figures; the badge is earned when every check with data passes and at least two have data. Includes a badge image link.
Read only Open world Idempotent
Input schema
{'type': 'object', 'required': ['company'], 'properties': {'company': {'type': 'string', 'description': 'The employer, for example "Greggs".'}}, 'additionalProperties': False}
find_people
People worth contacting at a company
People worth contacting at a company. For "who should I contact at Monzo about data jobs?", "find the hiring manager". Gives the people who posted the company's hiring ads publicly (they asked applicants to get in touch) and ready LinkedIn and Google searches that open the person's own connections there, its recruiters, likely hiring managers for the role, people in the role (for a referral) and alumni of a school. Nothing is read from LinkedIn and nothing is gathered about anyone.
Read only Open world Idempotent
Input schema
{'type': 'object', 'required': ['company'], 'properties': {'role': {'type': 'string', 'description': 'The role, for example "data analyst".'}, 'where': {'type': 'string', 'description': 'The city, for example London.'}, 'school': {'type': 'string', 'description': 'A university or school to look for alumni from.'}, 'company': {'type': 'string', 'description': 'The company, for example "Monzo".'}}, 'additionalProperties': False}
get_job
Details for one job from a search result
Details for one job from a search result. For when the user asks about one of the results, for example "tell me more about the second one" or "what's the apply link for the Uber job?". Takes the id from a search_jobs result exactly as given; ids carry what is needed, so they keep working later. NHS Jobs and Teaching Vacancies results include the closing date.
Read only Open world Idempotent
Input schema
{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': 'The id from a search_jobs result, copied exactly, for example muse-22049500, remotive-2091141 or nhsjobs-C9413-26-0725. Some ids are longer, with a ~ and a code after it.'}}, 'additionalProperties': False}
hiring_posts
Posts from people saying they're hiring
Posts from people saying they're hiring. For "who's posting that they're hiring React developers?", "any startups hiring remote designers?". Public posts from people saying they're hiring, from Hacker News (the monthly Who is hiring? thread), Mastodon and Bluesky, newest first, each with a link to the post. The person posting is often the hiring manager. Also gives a ready search link for X.
Read only Open world Idempotent
Input schema
{'type': 'object', 'required': [], 'properties': {'what': {'type': 'string', 'description': 'Job title or field, for example "nurse" or "software engineer".'}, 'limit': {'type': 'integer', 'maximum': 20, 'minimum': 1, 'description': 'How many posts, 1 to 20. Default 10.'}, 'where': {'type': 'string', 'description': 'A city, region, postcode or country, for example Birmingham, Austin, TX or remote.'}}, 'additionalProperties': False}
interview_practice
Practise an interview, one question at a time
Practise an interview, one question at a time. For "practise an interview with me" or "how was that answer?". Send the role to get the first question; send the question and the person's answer to get a score out of 10 with what went well, one thing to fix and the next question. Scored by fixed rules, the same for everyone: structure (situation, task, action, result), what the person did themselves, a concrete result, length and the question's own words. It scores the answer, never the person, and nothing is stored.
Read only Open world Idempotent
Input schema
{'type': 'object', 'required': [], 'properties': {'n': {'type': 'integer', 'maximum': 6, 'minimum': 0, 'description': 'Which practice question to ask, from 0. The reply gives next_n.'}, 'role': {'type': 'string', 'description': 'The job being interviewed for, for example "staff nurse".'}, 'answer': {'type': 'string', 'description': "The person's answer, as they would say it. Leave out to get the next question."}, 'question': {'type': 'string', 'description': 'The question that was answered, copied from the last reply. Leave out to get a question.'}}, 'additionalProperties': False}
interview_prep
Interview questions and practice
Interview questions and practice. For "help me prepare for my interview", "what will they ask a staff nurse?", "do a mock interview". Gives likely role questions, questions drawn from the advert, behavioural questions, good questions to ask them, tips for one-way video and AI interviews, and an order for a practice interview with timings. Takes a job id from a search, or the role and company.
Read only Open world Idempotent
Input schema
{'type': 'object', 'required': [], 'properties': {'id': {'type': 'string', 'description': 'A job id from a search result, copied exactly. Optional if what is given.'}, 'what': {'type': 'string', 'description': 'The role, for example "staff nurse" or "data analyst".'}, 'company': {'type': 'string', 'description': 'The company, for example "NHS" or "Monzo".'}}, 'additionalProperties': False}
job_demand
What job seekers are searching for, by role and place
What job seekers are searching for, by role and place. For "how many people are looking for care jobs in Leeds?" or "what are people searching for in Bristol?". Anonymous weekly counts of searches on Job Spotter by role words and place over the last 8 weeks, with the listings people found per search. Leave out what to get the most searched roles in a place (with a rising or falling trend), or where to get the places a role is searched most. For a role, it also gives the easiest places to find openings: where each search finds the most listings. A group is shown only when it holds 10 or more searches.
Read only Open world Idempotent
Input schema
{'type': 'object', 'required': [], 'properties': {'what': {'type': 'string', 'description': 'The role, for example "care assistant".'}, 'where': {'type': 'string', 'description': 'A town or city, or "remote".'}, 'country': {'enum': ['US', 'UK'], 'type': 'string', 'description': 'US or UK.'}}, 'additionalProperties': False}
jobs_for_me
The best current jobs for a CV
The best current jobs for a CV. For "find jobs that fit my CV", "what jobs should I apply for?". Searches current jobs for the person's target roles (or past titles) and place, and ranks them by match score, with matched and missing skills for each. Nothing sent is stored. The score is a fixed formula, not an AI judgement; the person decides what to apply for.
Read only Open world Idempotent
Input schema
{'type': 'object', 'required': [], 'properties': {'cv': {'type': 'string', 'description': 'The CV as plain text. Optional if titles and skills are given.'}, 'limit': {'type': 'integer', 'maximum': 10, 'minimum': 1, 'description': 'How many jobs, 1 to 10.'}, 'where': {'type': 'string', 'description': 'Where to look, for example London or remote.'}, 'skills': {'type': 'string', 'description': 'Skills, comma separated.'}, 'titles': {'type': 'string', 'description': 'Current and past job titles, comma separated.'}, 'schools': {'type': 'string', 'description': 'Universities or schools, comma separated.'}, 'location': {'type': 'string', 'description': 'Where the person lives or wants to work.'}, 'education': {'type': 'string', 'description': 'Highest qualification, for example "BSc Economics".'}, 'employers': {'type': 'string', 'description': 'Current and past employers, comma separated.'}, 'target_roles': {'type': 'string', 'description': "Roles to look for, comma separated. Defaults to the CV's titles."}, 'years_experience': {'type': 'number', 'description': 'Years of work experience.'}}, 'additionalProperties': False}
join_matching
Keep a job seeker's profile for introductions or offers (needs their email...
Keep a job seeker's profile for introductions or offers (needs their email confirmation). Nothing is kept until the link is pressed. Candidates never pay.
Open world
Input schema
{'type': 'object', 'required': ['email'], 'properties': {'cv': {'type': 'string', 'description': 'CV text.'}, 'name': {'type': 'string', 'description': 'Their name (shown to an employer only after they say yes).'}, 'email': {'type': 'string', 'description': "The person's email address; a confirmation link goes there."}, 'intros': {'type': 'boolean', 'description': 'Employers may ask for introductions.'}, 'offers': {'type': 'boolean', 'description': 'Quiet alerts about the right offer.'}, 'shifts': {'type': 'boolean', 'description': 'Shift alerts nearby.'}, 'skills': {'type': 'string', 'description': 'Skills, comma separated.'}, 'titles': {'type': 'string', 'description': 'Job titles they have had.'}, 'location': {'type': 'string', 'description': 'Where they want to work.'}, 'target_roles': {'type': 'string', 'description': 'Jobs they want next.'}, 'years_experience': {'type': 'number'}}, 'additionalProperties': False}
match_cv
How well a CV matches a job
How well a CV matches a job. For "how well do I match this job?", "should I apply?", "what's missing from my CV for this?". Scores a CV or profile against a job from a search (or pasted advert) out of 100, the same way every time: skills 45, role 20, experience 15, education 10, place 10. Gives matched and missing skills, strengths, gaps and keywords to add if true. Nothing sent is stored. The score is a fixed formula, not an AI judgement; the person decides what to apply for.
Read only Open world Idempotent
Input schema
{'type': 'object', 'required': [], 'properties': {'cv': {'type': 'string', 'description': 'The CV as plain text. Optional if titles and skills are given.'}, 'id': {'type': 'string', 'description': 'A job id from a search result, copied exactly. Or give job_text.'}, 'skills': {'type': 'string', 'description': 'Skills, comma separated.'}, 'titles': {'type': 'string', 'description': 'Current and past job titles, comma separated.'}, 'schools': {'type': 'string', 'description': 'Universities or schools, comma separated.'}, 'job_text': {'type': 'string', 'description': 'The job advert as plain text, when there is no id.'}, 'location': {'type': 'string', 'description': 'Where the person lives or wants to work.'}, 'education': {'type': 'string', 'description': 'Highest qualification, for example "BSc Economics".'}, 'employers': {'type': 'string', 'description': 'Current and past employers, comma separated.'}, 'years_experience': {'type': 'number', 'description': 'Years of work experience.'}}, 'additionalProperties': False}
networking_plan
Who to reach out to, from a CV
Who to reach out to, from a CV. For "who should I network with?", "how do I get a job as a data scientist without applying cold?". From a CV or a few details and the role wanted, gives the kinds of people worth contacting in order (hiring managers at the employers hiring most for the role, recruiters who place it, alumni, former colleagues, people who made the same move, community organisers), with ready searches, the employers hiring most now and named people from public posts. Nothing sent is stored.
Read only Open world Idempotent
Input schema
{'type': 'object', 'required': ['goal_role'], 'properties': {'cv': {'type': 'string', 'description': 'The CV as plain text. Optional if titles and skills are given.'}, 'where': {'type': 'string', 'description': 'Where, for example London.'}, 'school': {'type': 'string', 'description': 'A university or school, for alumni.'}, 'skills': {'type': 'string', 'description': 'Skills, comma separated.'}, 'titles': {'type': 'string', 'description': 'Current and past job titles, comma separated.'}, 'schools': {'type': 'string', 'description': 'Universities or schools, comma separated.'}, 'location': {'type': 'string', 'description': 'Where the person lives or wants to work.'}, 'education': {'type': 'string', 'description': 'Highest qualification, for example "BSc Economics".'}, 'employers': {'type': 'string', 'description': 'Current and past employers, comma separated.'}, 'goal_role': {'type': 'string', 'description': 'The job the person is aiming for, for example "data scientist".'}, 'years_experience': {'type': 'number', 'description': 'Years of work experience.'}}, 'additionalProperties': False}
post_job
Post a job or shift free (needs the employer's email confirmation)
Post a job or shift free (needs the employer's email confirmation). For small employers: posts a job or a single shift free. It goes live after the employer presses a link emailed to their work address (personal addresses get a quick check first), shows in Job Spotter's search, on its own page that Google for Jobs can list, and in alerts. Jobs close after 30 days, shifts when they end.
Open world
Input schema
{'type': 'object', 'required': ['email', 'title', 'company', 'description'], 'properties': {'kind': {'type': 'string', 'description': 'Kind: job (default) or shift.'}, 'type': {'type': 'string', 'description': 'Type: full_time, part_time, contract, temporary, internship or per_diem.'}, 'email': {'type': 'string', 'description': "The employer's work email; a confirmation link goes there."}, 'title': {'type': 'string', 'description': 'Job title.'}, 'pay_hi': {'type': 'number'}, 'pay_lo': {'type': 'number'}, 'remote': {'type': 'boolean'}, 'company': {'type': 'string', 'description': 'Company.'}, 'pay_cur': {'type': 'string', 'description': 'GBP, USD, EUR or CAD.'}, 'pay_per': {'type': 'string', 'description': 'Pay per: year, hour, day or month.'}, 'location': {'type': 'string', 'description': 'Where.'}, 'apply_url': {'type': 'string', 'description': 'Apply link.'}, 'shift_end': {'type': 'string', 'description': 'Shift end, ISO date and time.'}, 'apply_email': {'type': 'string', 'description': 'Or an email to apply to.'}, 'description': {'type': 'string', 'description': 'The advert text.'}, 'shift_start': {'type': 'string', 'description': 'Shift start, ISO date and time.'}, 'referral_bonus': {'type': 'string', 'description': 'Referral bonus offered, if any.'}, 'visa_sponsorship': {'type': 'boolean'}}, 'additionalProperties': False}
referral_note
A ready note asking someone for a referral
A ready note asking someone for a referral. For "write to Amy at Monzo asking for a referral". Gives a LinkedIn connection note under 300 characters and a longer email version that asks for a referral or a short chat, built from how they know each other and why the job fits. Nothing is sent or stored.
Read only Open world Idempotent
Input schema
{'type': 'object', 'required': ['job_title', 'company'], 'properties': {'ask': {'type': 'string', 'description': 'Ask: referral (default) or chat.'}, 'company': {'type': 'string', 'description': 'The company.'}, 'why_fit': {'type': 'string', 'description': 'One line on why the job fits.'}, 'job_link': {'type': 'string', 'description': 'Link to the job.'}, 'job_title': {'type': 'string', 'description': 'The job.'}, 'your_name': {'type': 'string', 'description': 'The sender.'}, 'their_name': {'type': 'string', 'description': 'The person being asked.'}, 'how_you_know': {'type': 'string', 'description': 'For example "We worked together at Sunrise".'}}, 'additionalProperties': False}
search_jobs
Search current job listings
Search current job listings. For requests like "find remote Python jobs", "marketing jobs in New York", "junior data analyst jobs posted this week", "senior software engineer jobs in London", "nurse jobs in Manchester". Job words go in what and the place in where. Everyday phrasing in what also works: level words (junior, senior), "remote", "in <city>" and "this week" are picked out. The say line credits listings from Remotive, Himalayas, Jobicy and Remote OK to their source.
Read only Open world Idempotent
Input schema
{'type': 'object', 'required': [], 'properties': {'page': {'type': 'integer', 'maximum': 20, 'minimum': 1, 'description': 'Which page of results, 1 to 20. Default 1. Use 2 for "show me more".'}, 'sort': {'enum': ['relevance', 'date', 'pay'], 'type': 'string', 'description': 'Sort: relevance (default), date (newest first) or pay (highest first).'}, 'what': {'type': 'string', 'description': 'Job title, skill or field, for example "python developer" or "marketing". Required unless where is given.'}, 'level': {'enum': ['entry', 'mid', 'senior'], 'type': 'string', 'description': 'Level: entry (junior, graduate, intern), mid or senior. With entry, jobs asking for more than 2 years of experience are left out and the answer adds apprenticeship and graduate routes.'}, 'limit': {'type': 'integer', 'maximum': 10, 'minimum': 1, 'description': 'How many results, 1 to 10. Default 10.'}, 'shift': {'enum': ['day', 'evening', 'night', 'weekend', 'flexible'], 'type': 'string', 'description': 'Shift: day, evening, night, weekend or flexible.'}, 'where': {'type': 'string', 'description': 'A city (New York, Austin, TX, London, Birmingham, UK), a US state (Texas), a UK county or region (Kent, Yorkshire), a UK postcode, a city or country abroad (Bangalore, Dublin, Dubai, Sydney, India), a country (USA, UK, Germany), "remote", or remote in a country ("remote US").'}, 'company': {'type': 'string', 'description': 'Only jobs at this company, for example "Tesco".'}, 'country': {'enum': ['US', 'UK'], 'type': 'string', 'description': "US or UK, when the place exists in both (Birmingham, Manchester, Cambridge) and the user's country is known. Optional."}, 'exclude': {'type': 'string', 'description': 'Words the advert must not contain, comma separated, for example "sales, commission".'}, 'include': {'type': 'string', 'description': 'Words the advert must contain, comma separated, for example "python, aws".'}, 'benefits': {'type': 'string', 'description': 'Benefits the advert must mention, comma separated, for example "pension, private healthcare".'}, 'employer': {'enum': ['direct', 'agency'], 'type': 'string', 'description': 'Employer: direct for jobs posted by the employer itself, or agency for recruitment agencies.'}, 'job_type': {'enum': ['full time', 'part time', 'contract', 'temporary', 'internship'], 'type': 'string', 'description': 'Job type: full time, part time, contract, temporary or internship.'}, 'education': {'enum': ['degree', 'no degree'], 'type': 'string', 'description': "Education: degree for jobs asking for a degree, or no degree for jobs that don't."}, 'work_type': {'enum': ['remote', 'hybrid', 'on-site'], 'type': 'string', 'description': 'Work type: remote, hybrid or on-site.'}, 'salary_max': {'type': 'string', 'description': 'Highest yearly pay, in the local currency.'}, 'salary_min': {'type': 'string', 'description': 'Lowest yearly pay, in the local currency, for example 40000 or 40k. Jobs that list no pay are left out when set.'}, 'radius_miles': {'type': 'integer', 'maximum': 100, 'minimum': 1, 'description': 'How far from the place, in miles, 1 to 100 (boards that support distance).'}, 'visa_sponsorship': {'enum': ['yes'], 'type': 'string', 'description': 'Set to yes for jobs whose advert says visa sponsorship is offered.'}, 'posted_within_days': {'type': 'integer', 'maximum': 90, 'minimum': 1, 'description': 'Only jobs posted in the last N days, 1 to 90. Default 30. 7 means this week.'}}, 'additionalProperties': False}
similar_jobs
Jobs like one from a search result
Jobs like one from a search result. For "show me more like the second one" or "anything similar to that Tesco job?". Takes the id from a search result exactly as given. Returns jobs with a similar title in the same place, without the job itself.
Read only Open world Idempotent
Input schema
{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': 'The id from a search result, copied exactly.'}, 'limit': {'type': 'integer', 'maximum': 10, 'minimum': 1, 'description': 'How many results, 1 to 10. Default 10.'}}, 'additionalProperties': False}
us_visa_salaries
What a US employer offered on work visa filings
What a US employer offered on work visa filings. For "what does Google pay software engineers?" or "how much does Infosys pay on H-1B?". Wages US employers offered on certified H-1B, H-1B1 and E-3 labour condition applications (US Department of Labor disclosure data): the number of filings, the median and typical range, and the most common job titles with their median offered wage. Offered wages on filings, a guide to pay at that employer; contact people named in the filings are left out.
Read only Open world Idempotent
Input schema
{'type': 'object', 'required': ['company'], 'properties': {'title': {'type': 'string', 'description': 'A job title to pick out, for example "software engineer".'}, 'company': {'type': 'string', 'description': 'The employer, for example "Google" or "Amazon.com Services".'}}, 'additionalProperties': False}
whats_hiring
What's hiring most in a place
What's hiring most in a place. For "who's hiring in Leeds?", "what jobs are in demand in Austin?", "which companies are hiring nurses in Manchester?". Gives the roles advertised most and the employers with the most open jobs.
Read only Open world Idempotent
Input schema
{'type': 'object', 'required': ['where'], 'properties': {'what': {'type': 'string', 'description': 'Optional field to narrow it, for example "nurse" or "engineering".'}, 'where': {'type': 'string', 'description': 'A city, region, postcode or country, for example Birmingham, Austin, TX or remote.'}, 'country': {'type': 'string', 'description': 'US or UK when the place exists in both, or a country by name.'}}, 'additionalProperties': False}
write_job_advert
Write a job advert and check the pay
Write a job advert and check the pay. For employers: "help me write an advert for a care assistant", "is £12 an hour enough?". Builds a clear advert from the title, duties, must-haves and pay, flags what puts applicants off (missing pay, too many must-haves, slang like "rockstar", age-coded or gendered wording, "native speaker") and compares the pay with current adverts for the role and place. Nothing is posted or stored; posting is free at jobspotter.pages.dev/employers.
Read only Open world Idempotent
Input schema
{'type': 'object', 'required': ['title'], 'properties': {'must': {'type': 'string', 'description': 'Must-haves, comma separated.'}, 'nice': {'type': 'string', 'description': 'Nice to have, comma separated.'}, 'type': {'type': 'string', 'description': 'Type: full_time, part_time, contract, temporary, internship or per_diem.'}, 'about': {'type': 'string', 'description': 'A line or two about the company.'}, 'apply': {'type': 'string', 'description': 'How to apply.'}, 'title': {'type': 'string', 'description': 'Job title.'}, 'duties': {'type': 'string', 'description': 'What the person will do, one per line or comma separated.'}, 'pay_hi': {'type': 'number', 'description': 'Pay to.'}, 'pay_lo': {'type': 'number', 'description': 'Pay from.'}, 'remote': {'type': 'boolean', 'description': 'Remote job.'}, 'company': {'type': 'string', 'description': 'Company name.'}, 'pay_cur': {'type': 'string', 'description': 'GBP, USD, EUR or CAD.'}, 'pay_per': {'type': 'string', 'description': 'Pay per: year, hour, day or month.'}, 'benefits': {'type': 'string', 'description': 'Benefits, comma separated.'}, 'location': {'type': 'string', 'description': 'Where the job is.'}}, 'additionalProperties': False}
Added
us_visa_salaries
Oct. 5, 2026, 2:42 a.m.
Added
interview_practice
Oct. 5, 2026, 2:42 a.m.
Added
cover_letter
Oct. 5, 2026, 2:42 a.m.
Added
fair_hiring_check
Oct. 5, 2026, 2:42 a.m.
Added
job_demand
Oct. 5, 2026, 2:42 a.m.
Added
post_job
Oct. 5, 2026, 2:42 a.m.
Added
join_matching
Oct. 5, 2026, 2:42 a.m.
Changed
company_lookup
Oct. 5, 2026, 2:42 a.m.
Changed
search_jobs
Oct. 5, 2026, 2:42 a.m.
Added
referral_note
Oct. 3, 2026, 2:49 a.m.
Added
write_job_advert
Oct. 3, 2026, 2:49 a.m.
Added
employer_reply_rate
Oct. 3, 2026, 2:49 a.m.
Added
check_visa_sponsor
Oct. 3, 2026, 2:49 a.m.
Added
networking_plan
Oct. 3, 2026, 2:49 a.m.
Added
connection_score
Oct. 3, 2026, 2:49 a.m.
Added
apply_kit
Oct. 3, 2026, 2:49 a.m.
Added
jobs_for_me
Oct. 3, 2026, 2:49 a.m.
Added
match_cv
Oct. 3, 2026, 2:49 a.m.
Added
find_people
Oct. 3, 2026, 2:49 a.m.
Added
interview_prep
Oct. 3, 2026, 2:49 a.m.
Added
check_job_link
Oct. 3, 2026, 2:49 a.m.
Added
compare_jobs
Oct. 3, 2026, 2:49 a.m.
Added
company_lookup
Oct. 3, 2026, 2:49 a.m.
Added
hiring_posts
Oct. 3, 2026, 2:49 a.m.
Added
whats_hiring
Oct. 3, 2026, 2:49 a.m.
Added
similar_jobs
Oct. 3, 2026, 2:49 a.m.
Added
check_salary
Oct. 3, 2026, 2:49 a.m.
Changed
search_jobs
Oct. 3, 2026, 2:49 a.m.
Changed
get_job
Oct. 1, 2026, 2:40 a.m.
Changed
search_jobs
Oct. 1, 2026, 2:40 a.m.