Connect
ChatGPT
- Search for WhatJobs in ChatGPT's apps and connect it.
- Ask for jobs naturally, or start a message with
@WhatJobs.
Claude (web, desktop and mobile)
- Open Settings → Connectors and choose Add custom connector.
- Name it WhatJobs and enter
https://mcp.whatjobs.com/mcp. - The first time Claude uses a WhatJobs tool, it asks your permission; you can allow it once or always.
Claude Code
claude mcp add --transport http whatjobs https://mcp.whatjobs.com/mcp
Other MCP clients
Add a remote MCP server with the endpoint URL and the Streamable HTTP transport. The configuration format depends on the client; a typical entry looks like this:
{
"mcpServers": {
"whatjobs": {
"url": "https://mcp.whatjobs.com/mcp"
}
}
}
Authentication and transport
| Authentication | None. No account, API key, OAuth or headers. |
|---|---|
| Access | Read-only. Every tool is annotated readOnlyHint: true, destructiveHint: false. Nothing is ever applied for, posted or changed. |
| Transport | Streamable HTTP, stateless: each request stands alone. |
| Protocol versions | 2026-07-28, 2025-11-25, 2025-06-18, 2025-03-26 |
| Results | Text for the model plus structuredContent; an MCP Apps view (ui://whatjobs/view.html) renders them as job cards and charts in hosts that support it. |
Tool reference
7 tools. Inputs are generated from the server's live tool definitions. The assistant fills them in from what the person asks.
Search WhatJobs for public job listings using separate structured search fields.
| Input | Type | Notes |
|---|---|---|
keyword required | string | the job role, job function, skill, or industry only. |
location required | string | the city, region, country, or remote preference only. |
market optional | string | optional. The country market for the search. If omitted it is inferred from location (e.g. "Johannesburg, South Africa" -> za). Supported values: see Countries. |
chunk_number optional | integer, default 1 | the result batch number. Use 1 for the first search and increment when the user asks to see more. |
Example: “Find nurse jobs in London on WhatJobs”
Show what a job pays, from the salaries in current WhatJobs listings: typical range, median, lowest and highest, plus a few listings with salaries.
| Input | Type | Notes |
|---|---|---|
keyword required | string | the job role only (e.g. "nurse", "software engineer"). |
location optional | string | the place to search (city, region or country), not the user's own location unless they ask for jobs near them. May be empty for the whole country. |
market optional | string | optional country code; if empty it is inferred from location. Supported values: see Countries. |
Example: “How much does a data analyst earn in Berlin?”
Compare what a job pays across places, or what different jobs pay in one place, from the salaries in current WhatJobs listings: the typical range and median for each, side by side.
| Input | Type | Notes |
|---|---|---|
keywords required | list of strings | one or more job roles only (e.g. ["nurse"], or ["accountant", "bookkeeper"]). |
locations required | list of strings | one or more places to compare (city, region or country), not the user's own location unless they ask about jobs near them. |
market optional | string | optional. Leave empty to let each location use its own country (so "Paris" and "Berlin" compare France and Germany). Supported values: see Countries. |
Example: “Compare nurse salaries in London, Manchester and Leeds”
List the companies posting the most jobs for a role and place right now on WhatJobs, with their job counts and example listings.
| Input | Type | Notes |
|---|---|---|
keyword required | string | the job role only. |
location required | string | the place to search (city, region or country), not the user's own location unless they ask for jobs near them. |
market optional | string | optional country code; if empty it is inferred from location. Supported values: see Countries. |
Example: “Who is hiring software engineers in Toronto?”
Compare how many jobs are live on WhatJobs right now across places and/or roles.
| Input | Type | Notes |
|---|---|---|
keywords required | list of strings | one or more job roles (may be [""] to count all jobs). |
locations required | list of strings | one or more places to search, not the user's own location unless they ask about jobs near them. Up to 6 keyword x location combinations are compared. |
market optional | string | optional. Leave empty to let each location use its own country (so "Paris" and "Berlin" compare France and Germany). |
Example: “Are there more developer jobs in Paris or Berlin?”
Show only recently posted WhatJobs listings for a role and place, newest first.
| Input | Type | Notes |
|---|---|---|
keyword required | string | the job role only. |
location required | string | the place to search (city, region or country), not the user's own location unless they ask for jobs near them. |
posted_within_days optional | integer, default 7 | 1 for today/yesterday, 7 for this week (default), up to 30. |
market optional | string | optional country code; if empty it is inferred from location. Supported values: see Countries. |
Example: “Show electrician jobs posted this week in Manchester”
Find WhatJobs listings that fit a person's background: searches up to 4 target job titles at once and ranks the jobs by how well the title matches and how many of their skills each listing mentions.
| Input | Type | Notes |
|---|---|---|
job_titles required | list of strings | 1-4 job titles that fit the person (you choose them from what they shared). |
location required | string | where they want to work (the place to search). |
skills optional | list of strings | up to 10 key skills or tools (e.g. "Python", "SQL", "forklift licence"). |
market optional | string | optional country code; if empty it is inferred from location. Supported values: see Countries. |
Example: “I'm a data analyst with SQL and Power BI. Which jobs in London fit me?”
Results and links
- Job results include the title, company, place, salary when the listing shows one, when it was posted, part of the description, and a link to the job on WhatJobs.
- Salary figures come from current listings that show a salary, in each country's own currency, for the pay period most listings use. Amounts are never converted between currencies.
- Links carry WhatJobs' publisher ID and
utm_sourcenaming the assistant (for examplechatgptorclaude), so WhatJobs can attribute the visit. - If the job data can't be loaded, tools still answer with a link to the same search on WhatJobs instead of failing.
Countries
United Kingdom, United States, Canada, Germany, India, Pakistan, Brazil, Spain, United Arab Emirates, Mexico, Argentina, South Africa, Austria, Australia, Belgium, Bahrain, Chile, Colombia, Costa Rica, Switzerland, Dominican Republic, Algeria, Nigeria, Netherlands and France. The country is inferred from the place searched, or can be passed as a market code.
Discovery metadata
| URL | What it is |
|---|---|
/mcp/server-card | MCP Server Card (application/mcp-server-card+json): name, version, endpoint and protocol versions, readable before connecting. An experimental MCP extension (SEP-2127), so not every client reads it yet. |
/.well-known/ai-catalog.json | AI Catalog (draft specification) pointing to the server card. |
/llms.txt | A plain-text summary for AI crawlers. |
/robots.txt, /sitemap.xml | Crawler permissions and the list of public pages. |
com.whatjobs.mcp/job-search | The server's entry in the official MCP Registry. |
Your data
- What we receive. Only the search details the assistant sends: the role, place and country, and for profile matches up to four job titles and ten skills. Each field is cut to 100 characters, so there's no room for a conversation or a CV's text. We never ask for your name or contact details.
- What we keep. A log of each request (the search details, which assistant sent it and what the app showed) to run and improve the service. Logs are deleted after 6 months.
- On your device. The results view remembers which jobs you have opened, to mark them "Viewed". That list stays in your browser for up to 90 days and is never sent to us.
- Deleting your data. Disconnect WhatJobs in your assistant's settings at any time. To have your logs deleted sooner, or to get a copy, contact us with roughly what you searched and when.
Full details: WhatJobs privacy policy · Terms
Support
Questions or problems: contact WhatJobs.