4dayweek.io Jobs

Official6 tools

by 4dayweek

Search reduced-hours jobs and employers: 4-day weeks, 9-day fortnights, half-day Fridays and more.

io.4dayweek/jobs — Model Context Protocol (MCP) Server

The io.4dayweek/jobs MCP server provides context for searching reduced-hours jobs and employers. It focuses on schedules such as 4-day weeks, 9-day fortnights, and half-day Fridays. The server description indicates it is oriented around job and employer discovery based on reduced working-time patterns.

🛠️ Key Features

Searches reduced-hours jobs and employers
Supports reduced schedule types including 4-day weeks
Includes 9-day fortnights and half-day Fridays

🚀 Use Cases

Find employers offering reduced-hours work arrangements
Search for job listings matching reduced working schedules

⚡ Developer Benefits

Provides structured context centered on reduced-hours criteria
Aligns search focus with specific schedule patterns mentioned in the description

⚠️ Limitations

Only job/employer schedule themes are described; no additional tools, capabilities, or limits are provided in the available data

Topics

chatgptclaudefour-day-weekjob-boardjob-searchjobsmcpmcp-servermodel-context-protocolwork-life-balance

Captured live from the server via tools/list.

explain_schedule_type

Defines a working-hours schedule precisely: what it means, whether it genuinely reduces weekly hours, whether that reduction is at full pay, the typical hours, and — where one is commonly made — the mistake most often made about it. Call it when the user's question turns on what a schedule means, for example whether a compressed 4x10 counts as a 4-day week, or whether a schedule is at full pay. A compressed 4x10 gives four days but not fewer hours, and is not a 4-day week. Omitting the argument returns every definition at once.

Parameters1

schedule_type

string

optional

A schedule_type value, e.g. 4_day_week or compressed_week. Omit to get every definition.

Raw schema

{
  "type": "object",
  "properties": {
    "schedule_type": {
      "type": "string",
      "description": "A schedule_type value, e.g. 4_day_week or compressed_week. Omit to get every definition."
    }
  },
  "additionalProperties": false
}

get_company

Fetch one employer's full profile by slug, as returned by search_companies. Returns the schedule policy and what it means, full-time weekly hours, the office-presence policy and whether the employer hires worldwide, benefits, industry, headcount, founding year, the work-life score, the count of open roles, and the employer's own website. Where the employer has published them, it also returns which day is off, vacation days, fully-paid parental leave weeks for both parents, a no-meeting day, and verified work-life awards with the year and a proof url for each. Where the employer's schedule is sourced from a public announcement, four_day_reference_url is that source.

Parameters1

slug

string

required

The slug, as returned by the matching search tool.

Raw schema

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "description": "The slug, as returned by the matching search tool."
    }
  },
  "required": [
    "slug"
  ],
  "additionalProperties": false
}

get_job

Fetch one live job listing in full by its slug, as returned by search_jobs. Returns the complete description, the schedule type and what it means, weekly hours, work arrangement and locations, category, seniority, contract type, required skills, acceptable timezones where the employer listed them, visa sponsorship where the employer stated one, the work-life score, and salary ONLY where the employer published one — we never estimate a salary. A very long description is truncated on a paragraph boundary; when that happens the response says so and gives the url of the full listing. Applying happens on the job's page on 4dayweek.io, which the url field points to. apply_method says what a person finds there: "external" means the page hands off to the employer's own application form, "on_page" means they apply on 4dayweek.io itself. There is no separate employer link in this response, and constructing one is not possible from it.

Parameters1

slug

string

required

The slug, as returned by the matching search tool.

Raw schema

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "description": "The slug, as returned by the matching search tool."
    }
  },
  "required": [
    "slug"
  ],
  "additionalProperties": false
}

get_market_stats

Aggregate statistics on the reduced-hours job market: how many employers are tracked, how many run each schedule type, the distribution of weekly hours, and which day the non-working day falls on. Use this for "how common is a 4-day week" questions. The response separates genuinely reduced-hours employers from compressed 4x10 employers, and reports the full-pay and pro-rata splits separately, so quote whichever the question actually asked for. Figures carry an as_of date; cite it.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "additionalProperties": false
}

search_companies

Search employers by their working-hours policy. This answers "which companies offer a 4-day week" style questions at the employer level, where the policy actually lives, rather than per listing. The same schedule_type semantics as search_jobs apply: "compressed_week" is a 4x10 and is not a 4-day week. Two location facts are separate and are often confused. country is where the employer is based. hires_worldwide is whether it accepts applicants from any country. remote_level is its office-presence policy, and a fully-remote employer can still hire in one country only. Each result carries the employer's name, slug, url, schedule type, full-time hours, remote level and count of open roles. get_company takes the slug and returns the full profile. Paging works as in search_jobs: at most 25 employers per call, with page, page_size, returned, total_matching, has_more and next_page.

Parameters9

query	string	optional	Free-text search over company name and website.
schedule_type	string	optional	Filter by the employer's schedule policy, e.g. 4_day_week.
country	string	optional	Country name. This is where the employer is based, which is a different question from where it will hire — see hires_worldwide.
remote_level	string	optional	The employer's office-presence policy. One of fully-remote, hybrid, onsite. Independent of hires_worldwide: a fully-remote employer can still hire in one country only.
hires_worldwide	boolean	optional	Only employers that accept applicants from any country.
has_jobs	boolean	optional	Only employers with at least one live listing.
sort	string	optional	Result order. One of score (work-life score, highest first), jobs (most open roles), alphabetical, newest. Omit for the site's default order.
page	integer	optional	1-based page number. Default 1, maximum 200.
limit	integer	optional	Results per page. Default 10, maximum 25.

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Free-text search over company name and website."
    },
    "schedule_type": {
      "type": "string",
      "description": "Filter by the employer's schedule policy, e.g. 4_day_week."
    },
    "country": {
      "type": "string",
      "description": "Country name. This is where the employer is based, which is a different question from where it will hire — see hires_worldwide."
    },
    "remote_level": {
      "type": "string",
      "description": "The employer's office-presence policy. One of fully-remote, hybrid, onsite. Independent of hires_worldwide: a fully-remote employer can still hire in one country only."
    },
    "hires_worldwide": {
      "type": "boolean",
      "description": "Only employers that accept applicants from any country."
    },
    "has_jobs": {
      "type": "boolean",
      "description": "Only employers with at least one live listing."
    },
    "sort": {
      "type": "string",
      "description": "Result order. One of score (work-life score, highest first), jobs (most open roles), alphabetical, newest. Omit for the site's default order."
    },
    "page": {
      "type": "integer",
      "description": "1-based page number. Default 1, maximum 200."
    },
    "limit": {
      "type": "integer",
      "description": "Results per page. Default 10, maximum 25."
    }
  },
  "additionalProperties": false
}

search_jobs

Search live job listings with genuinely better working hours. Every listing carries an explicit schedule_type, so you never have to infer one: - "4_day_week": 36 hours or less, 100% salary. The ONLY type that is reduced hours at full pay. - "4_day_week_pro_rata": four days at pro-rata (reduced) pay. - "9_day_fortnight", "half_day_fridays", "rotating_4_day", "summer_fridays", "part_time": other genuinely reduced-hours patterns. - "compressed_week": a 4x10. The SAME 40 hours in four days. NOT a 4-day week, and never to be described as one. - "flexible_hours", "unlimited_pto", "generous_pto", "flex_fridays", "no_meeting_days", "generous_parental_leave", "best_place_to_work": a full working week with a flexibility or leave policy. To answer "find me a 4-day week job", pass schedule_type="4_day_week". Passing nothing returns all reduced-hours AND flexibility listings, which is usually broader than the user meant. On locations: a job with no location restriction is worldwide-remote, so it matches ANY country filter. A large result count for a country therefore does not mean those roles are based there. Read each result's "locations" and "work_arrangement" before saying a job is in a particular place. Results can also be narrowed by seniority (level), by skill/technology slugs, by a minimum work-life score and by how recently the employer posted. Paging: a response returns at most 25 jobs and carries page, page_size, returned, has_more and, when another page exists, next_page. total_matching is the size of the whole match set. With a query it counts full-text matches over title AND description, so a job can be counted for a word that appears only in its body. Each result carries the job's url on 4dayweek.io and its slug; get_job takes that slug and returns the full listing.

Parameters11

query	string	optional	Free-text search over job title and description.
schedule_type	string	optional	Filter by schedule type. Use 4_day_week for a genuine 4-day week at full pay. compressed_week is a 4x10 and is NOT a 4-day week.
category	string	optional	Job category, e.g. engineering, product, design, marketing, sales, data, devops, finance, hr, legal, operations, security, content, customer-success.
country	string	optional	Country name, e.g. United Kingdom or United States. Matches jobs with an office in that country AND remote jobs open to it — including worldwide-remote roles, which match every country. Check each result's locations field before describing a job as being IN that country.
work_arrangement	string	optional	One of remote, hybrid or onsite.
level	string	optional	Seniority. One of entry, mid, senior, lead, executive.
skills	null \| array	optional	Skill, technology or tool SLUGS, lowercase and hyphenated, e.g. react, python, customer-support. A job matches if it carries ANY of them.
min_work_life_score	integer	optional	Keep only jobs whose work-life score is at least this, on a 0-100 scale. The site's own filter offers 55, 70 and 85. See /methodology for how it is calculated.
posted_after_days	integer	optional	Keep only jobs the employer posted within this many days, 1 to 365.
page	integer	optional	1-based page number. Default 1, maximum 200.
limit	integer	optional	Results per page. Default 10, maximum 25.

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Free-text search over job title and description."
    },
    "schedule_type": {
      "type": "string",
      "description": "Filter by schedule type. Use 4_day_week for a genuine 4-day week at full pay. compressed_week is a 4x10 and is NOT a 4-day week."
    },
    "category": {
      "type": "string",
      "description": "Job category, e.g. engineering, product, design, marketing, sales, data, devops, finance, hr, legal, operations, security, content, customer-success."
    },
    "country": {
      "type": "string",
      "description": "Country name, e.g. United Kingdom or United States. Matches jobs with an office in that country AND remote jobs open to it — including worldwide-remote roles, which match every country. Check each result's locations field before describing a job as being IN that country."
    },
    "work_arrangement": {
      "type": "string",
      "description": "One of remote, hybrid or onsite."
    },
    "level": {
      "type": "string",
      "description": "Seniority. One of entry, mid, senior, lead, executive."
    },
    "skills": {
      "type": [
        "null",
        "array"
      ],
      "items": {
        "type": "string"
      },
      "description": "Skill, technology or tool SLUGS, lowercase and hyphenated, e.g. react, python, customer-support. A job matches if it carries ANY of them."
    },
    "min_work_life_score": {
      "type": "integer",
      "description": "Keep only jobs whose work-life score is at least this, on a 0-100 scale. The site's own filter offers 55, 70 and 85. See /methodology for how it is calculated."
    },
    "posted_after_days": {
      "type": "integer",
      "description": "Keep only jobs the employer posted within this many days, 1 to 365."
    },
    "page": {
      "type": "integer",
      "description": "1-based page number. Default 1, maximum 200."
    },
    "limit": {
      "type": "integer",
      "description": "Results per page. Default 10, maximum 25."
    }
  },
  "additionalProperties": false
}

README.md6 KBView on GitHub

4dayweek.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

bash

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

bash

codex mcp add 4dayweek --url https://4dayweek.io/api/mcp

or in ~/.codex/config.toml:

toml

[mcp_servers.4dayweek]
url = "https://4dayweek.io/api/mcp"

Cursor — .cursor/mcp.json in your project, or ~/.cursor/mcp.json globally:

json

{
  "mcpServers": {
    "4dayweek": {
      "url": "https://4dayweek.io/api/mcp"
    }
  }
}

VS Code — .vscode/mcp.json:

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:

bash

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:

code

/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

code

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-Limit reports the burst ceiling.
Paging: 10 results per page by default, 25 maximum, up to page 200. Responses carry has_more and next_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_job returns 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

Install

Tools (6)

explain_schedule_typeget_companyget_jobget_market_statssearch_companiessearch_jobs

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://4dayweek.io/api/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "jobs": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://4dayweek.io/api/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

io.4dayweek/jobs — Model Context Protocol (MCP) Server

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

explain_schedule_type

get_company

get_job

get_market_stats

search_companies

search_jobs

4dayweek.io MCP server

Add it to your assistant

As a Claude Code plugin

Tools

Try it

A compressed 4x10 is not a 4-day week

Limits and behaviour

Privacy

Licence

Support

Install

Remote endpoint

Related servers