io.4dayweek/jobs
Official4dayweek.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 |
|
Transport | Streamable HTTP (stateless) |
Authentication | None — anonymous, read-only |
Server name |
|
Version | 1.3.0 |
Documentation |
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/mcpClaude (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/mcpor 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"}}}'Related MCP server: ActiveVacancies MCP Server
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-ioThe 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 |
| Live listings, filtered by schedule type, category, country, work arrangement, seniority, skills, work-life score or posting date. |
| One listing in full by slug, including hours, locations and a published salary. |
| Employers by working-hours policy, country, office-presence policy and whether they hire worldwide. |
| 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. |
| Aggregate market data across tracked employers, carrying an as-of date and its own caveats. |
| 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
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
JobsPipe — data pipeline of every job posting on the web. Search live, normalized job postings from 30+ ATS feeds and job boards for AI agents via MCP.
A jobs data API and MCP server. Every listing comes from the employer's own career site, an ATS feed or a government employment service, never resold from another board. Each row names its source and when we last confirmed the vacancy existed, and a role that disappears keeps a closure date and a reason. Six tools: search_jobs, get_job, company_hiring, market_signals, coverage, changes_since.
Public MCP server for discovering open jobs. Search, filter, and get application links.
Search Thousands of jobs, Thousands of companies. MCP for Claude, ChatGPT, Codex and Cursor.
Related MCP Servers
- AlicenseAqualityCmaintenanceEnables searching over 1 million enriched job listings from 20,000+ companies directly from MCP-compatible AI tools. Provides tools for job search, company profiles, and AI-powered similar job recommendations with real-time data updates.4102 npm2MIT
- AlicenseAqualityCmaintenanceEnables AI assistants to search real-time verified tech job listings, retrieve job details and salary percentiles, match candidate resumes to vacancies, and explore hiring companies through MCP.6MIT
- AlicenseNot gradedqualityCmaintenanceEnables any MCP host to search job listings and retrieve individual job details from a public job board's API/RSS through standardized tools. It provides read-only search and detail lookup with polite rate limiting and remote/location filtering.MIT
- AlicenseNot gradedqualityCmaintenanceEnables users to search job postings with keyword, location, remote-only, date, and limit filters, and retrieve individual job details via MCP tools.MIT