4dayweek.io Jobs MCP server
Commit Sep 18, 2026Search live job listings and employer profiles for roles with reduced working hours like 4-day weeks and 9-day fortnights.
Also known as 4dayweek/mcp, mcp
- Stars
- 0
- Tools
- 6
- Downloads, 30 days
- —
- Latest version
- 1.4.0
- Last commit
- Sep 18, 2026
- License
- MIT
What is 4dayweek.io Jobs MCP?
4dayweek.io Jobs searches live job listings and employer profiles for roles with reduced working hours like 4-day weeks and 9-day fortnights. It exposes 6 tools, such as search_jobs, get_job, search_companies.
Summary generated from the project's README
About 4dayweek.io Jobs MCP server
Finding employment with reduced working hours like 4-day weeks or 9-day fortnights is possible through this MCP server. It provides direct access to live job listings and employer profiles from 4dayweek.io, allowing AI assistants to search for specific roles without manual web scraping. The server is hosted remotely and uses streamable HTTP, meaning there is nothing for you to install or host locally.
Users can connect this to clients such as Claude, ChatGPT, Cursor, Codex, or VS Code. It requires no API keys, no sign-ups, and no accounts because it is an anonymous, read-only service. The server includes six specialized tools, including search_jobs for filtering by category or seniority and get_company to view detailed employer benefits and work-life scores. It also features explain_schedule_type to help distinguish between compressed work weeks and genuine reductions in weekly hours.
What you can do with it
- 1Search for specific flexible rolesFind remote engineering positions in the UK that offer a 4-day work week.
- 2Verify working hour definitionsAsk the assistant to clarify the difference between a 9-day fortnight and a compressed week.
- 3Research employer policiesGet a full profile of a company to see their specific schedule policy and vacation benefits.
- 4Analyze job market trendsRequest aggregate data regarding working hour trends across tracked employers.
Written from the project's README. Every use case is checked against a quote from it.
How to install 4dayweek.io Jobs MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall 4dayweek.io Jobs MCP in Claude Code
$ claude mcp add --transport http mcp https://4dayweek.io/api/mcpInstall 4dayweek.io Jobs MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"mcp": {
"url": "https://4dayweek.io/api/mcp"
}
}
}Install 4dayweek.io Jobs MCP in VS Code
.vscode/mcp.json
{
"servers": {
"mcp": {
"type": "http",
"url": "https://4dayweek.io/api/mcp"
}
}
}Install 4dayweek.io Jobs MCP in VS Code CLI
$ code --add-mcp '{"name":"mcp","type":"http","url":"https://4dayweek.io/api/mcp"}'Install 4dayweek.io Jobs MCP in Codex
$ codex mcp add mcp --url https://4dayweek.io/api/mcpInstall 4dayweek.io Jobs MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.mcp] url = "https://4dayweek.io/api/mcp"
Install 4dayweek.io Jobs MCP in Gemini CLI
$ gemini mcp add -s user --transport http mcp https://4dayweek.io/api/mcpInstall 4dayweek.io Jobs MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"mcp": {
"url": "https://4dayweek.io/api/mcp",
"type": "http"
}
}
}4dayweek.io Jobs MCP tools 6
Detected from the READMEsearch_jobsget_jobsearch_companiesget_companyget_market_statsexplain_schedule_type
Automated checks
Ran Nov 15, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachable4dayweek/mcp is public and reachablegithub.com/4dayweek/mcp ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-10-13github.com/4dayweek/mcp ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model6 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNo tool named like delete, drop or execPass
- Remote endpoint answers the MCP handshakeinitialize answered with protocol 2025-06-18 in 109 msPass
README
View on GitHub4dayweek.io MCP server
A free, read-only Model Context Protocol server over 4dayweek.io, a job board for roles with genuinely reduced working hours: 4-day weeks, 9-day fortnights, half-day Fridays and more.
Connect it to Claude, ChatGPT, Cursor, Codex or any other MCP client and your assistant can search live listings and employers directly, instead of scraping the site. There is no API key and no sign-up.
| Endpoint | https://4dayweek.io/api/mcp |
| Transport | Streamable HTTP (stateless) |
| Authentication | None — anonymous, read-only |
| Server name | io.4dayweek/jobs |
| Version | 1.3.0 |
| Documentation | https://4dayweek.io/mcp |
This repository holds the manifest and the documentation. The server itself runs on 4dayweek.io; there is nothing to install or host.
Add it to your assistant
Claude Code
claude mcp add --transport http 4dayweek https://4dayweek.io/api/mcp
Claude (web and desktop) — Settings → Connectors → Add custom connector, then paste
https://4dayweek.io/api/mcp. No authentication needed.
ChatGPT — Settings → Connectors → Advanced → Developer mode, then add a connector pointing at
https://4dayweek.io/api/mcp.
Codex
codex mcp add 4dayweek --url https://4dayweek.io/api/mcp
or in ~/.codex/config.toml:
[mcp_servers.4dayweek]
url = "https://4dayweek.io/api/mcp"
Cursor — .cursor/mcp.json in your project, or ~/.cursor/mcp.json globally:
{
"mcpServers": {
"4dayweek": {
"url": "https://4dayweek.io/api/mcp"
}
}
}
VS Code — .vscode/mcp.json:
{
"servers": {
"4dayweek": {
"type": "http",
"url": "https://4dayweek.io/api/mcp"
}
}
}
Anything else — the transport is streamable HTTP, so any MCP client can reach it directly:
curl -X POST https://4dayweek.io/api/mcp \
-H 'Content-Type: application/json' \
-H 'Accept: application/json, text/event-stream' \
-d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{
"protocolVersion":"2025-06-18","capabilities":{},
"clientInfo":{"name":"curl","version":"1.0"}}}'
As a Claude Code plugin
This repository doubles as a Claude Code plugin marketplace, so the connector can be installed by name and listed alongside your other plugins:
/plugin marketplace add 4dayweek/mcp
/plugin install 4dayweek@4dayweek-io
The claude mcp add line above does the same job in one command; the plugin route just keeps it in
your plugin list and updates with this repository.
Tools
Six tools. Every one is read-only and says so in the protocol, so a cautious client can call them freely.
| Tool | What it returns |
|---|---|
search_jobs |
Live listings, filtered by schedule type, category, country, work arrangement, seniority, skills, work-life score or posting date. |
get_job |
One listing in full by slug, including hours, locations and a published salary. |
search_companies |
Employers by working-hours policy, country, office-presence policy and whether they hire worldwide. |
get_company |
One employer's full profile: schedule policy, weekly hours, office policy, benefits and work-life score — plus day off, vacation and awards where the employer has published them. |
get_market_stats |
Aggregate market data across tracked employers, carrying an as-of date and its own caveats. |
explain_schedule_type |
Precise definitions: whether a schedule genuinely reduces weekly hours, and whether that is at full pay. |
Try it
Find me remote 4-day-week engineering jobs open to applicants in the UK.
What is a 9-day fortnight, and is it the same as a compressed week?
Which employers run a genuine 4-day week at full pay, and how many are there?
Tell me about AWIN's 4-day week, and how it was verified.
Show me senior product roles at 32 hours a week, posted in the last fortnight.
A compressed 4x10 is not a 4-day week
This is the distinction the tool descriptions exist to carry. A compressed week packs the same 40
hours into four days; a 4-day week is 36 hours or fewer with no cut in pay. Every listing carries an
explicit schedule type, and explain_schedule_type states, for any schedule, whether it genuinely
reduces weekly hours and whether that reduction is at full pay — so an assistant reading these tools
gets it right without being prompted.
Limits and behaviour
- Rate limit: 300 requests per minute sustained, bursting to 60.
X-RateLimit-Limitreports the burst ceiling. - Paging: 10 results per page by default, 25 maximum, up to page 200. Responses carry
has_moreandnext_page, and say so when the page ceiling is reached. - Read-only by construction: the server can only reach read methods — a tool that writes would not compile. Nothing you send is stored as user data, and there is no account to create.
- Applications happen on the site.
get_jobreturns the job's page on 4dayweek.io and whether the employer takes applications on-site or elsewhere; it never returns the employer's raw application URL.
Privacy
The endpoint is anonymous. Each call is logged with the requesting IP, user agent, path, timestamp and the name of the tool called, for abuse prevention and to see which tools are used — at most 14 days, in practice about two. No account, no cookies, no personal data. Full policy: https://4dayweek.io/privacy
Licence
The contents of this repository — the manifest, this documentation and the configuration snippets — are MIT licensed (see LICENSE and NOTICE).
That is not a licence to the data. Results returned by the API and the MCP endpoint are covered by section 10 of our Terms: a limited, revocable licence to use and display them in your own product, conditioned on crediting 4dayweek.io and linking back, staying within the rate limits, not misstating an employer's working-hours policy, and not using them to build a competing job board. Our aggregate market statistics are separately published under CC BY 4.0 on our data page.
Support
- Documentation: https://4dayweek.io/mcp
- Contact: https://4dayweek.io/contact
4dayweek.io Jobs MCP questions
How do I add 4dayweek.io Jobs MCP to Claude Code?
Run claude mcp add --transport http mcp https://4dayweek.io/api/mcp in your terminal. Add --scope user to make it available in every project.
How do I add 4dayweek.io Jobs MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools does 4dayweek.io Jobs MCP provide?
It exposes 6 tools, including search_jobs, get_job, search_companies, get_company, get_market_stats.
Do I need an API key to use this server?
No, the server is anonymous and requires no sign-up or authentication.
Can I apply for jobs directly through the MCP server?
No, the server is read-only. Applications must be completed on the 4dayweek.io website.
What is the difference between a compressed week and a 4-day week?
A compressed week packs 40 hours into four days, whereas a 4-day week is 36 hours or fewer with no cut in pay.
Is there a rate limit for requests?
Yes, the server allows 300 requests per minute sustained, with a burst limit of 60.