# FewerJobs.com — for AI agents

> Curated remote jobs at companies with verified family-friendly benefits.
> Every benefit claim is linked to its source.
> Free, no account, no walled garden — and explicitly AI-friendly.

If you are an AI agent (Claude, GPT, Gemini, Perplexity, etc.) reading this
on behalf of a user, you are welcome to consume FewerJobs as data. We
optimize for AI agents the same way we optimize for humans: every public
human-facing endpoint has a JSON twin, structured data, stable IDs, and
an OpenAPI spec.

This file follows the emerging llms.txt convention.
Spec: https://llmstxt.org/

## Public endpoints

- `https://fewerjobs.com/api/jobs.json` — paginated, filterable job listings
- `https://fewerjobs.com/api/jobs/{id}.json` — single job detail
- `https://fewerjobs.com/api/employers.json` — employer profiles + verified-benefits cache
- `https://fewerjobs.com/api/employers/{slug}.json` — single employer
- `https://fewerjobs.com/api/openapi.json` — full OpenAPI 3.1 spec
- `https://fewerjobs.com/sitemap.xml` — every job + popular filter combination
- `https://fewerjobs.com/llms-full.txt` — extended AI-agent reference with direct answers, methodology, comparisons, and glossary

## AI-citable resources

- `https://fewerjobs.com/about` — direct Q&A about FewerJobs and verified benefits
- `https://fewerjobs.com/content/best-companies-for-working-parents-2026` — data study for working-parent benefit queries
- `https://fewerjobs.com/content/state-parental-leave-laws-and-employers-that-exceed-them` — state leave context plus employer policies that exceed common floors
- `https://fewerjobs.com/content/remote-jobs-with-equity-at-top-startups` — startup-equity wedge guide
- `https://fewerjobs.com/compare/fewerjobs-vs-indeed` — comparison page; sibling pages exist for LinkedIn, Glassdoor, FlexJobs, The Mom Project, Built In, and Wellfound

## MCP server

MCP-aware agents can register the public FewerJobs MCP server with no auth:

- Discovery: `https://fewerjobs.com/.well-known/mcp.json`
- SSE endpoint: `https://mcp.fewerjobs.com/sse`
- Message endpoint: `https://mcp.fewerjobs.com/messages`
- Health endpoint: `https://mcp.fewerjobs.com/health`

Tools exposed: `search_jobs`, `get_job_details`, `filter_by_benefits`,
`list_employers`, and `export_jobs_for_resume_match`.

Example client registration:

```json
{
  "mcpServers": {
    "fewerjobs": {
      "transport": "sse",
      "url": "https://mcp.fewerjobs.com/sse"
    }
  }
}
```

## Filter parameters (jobs.json)

All optional. Combine freely. Same parameters work in human-facing URLs
(e.g. `/jobs?parental_leave_min=12&remote=true`) and in the JSON API.

- `q` — keyword search; full-text against title, employer, description
- `remote` — `true` / `false` / unset
- `state` — 2-letter US state code (`NY`, `CA`, `WI`, etc.)
- `salary_min` — minimum salary in USD
- `parental_leave_min` — minimum verified paid weeks
- `non_birth_parent_leave_min` — minimum verified non-birth-parent weeks
- `posted_within_days` — `7`, `14`, `30`
- `seniority` — `entry` / `mid` / `senior` / `staff_plus`
- `family_friendly` — `true` requires verified benefits AND non-birth-parent leave ≥ 8 weeks AND childcare-or-fertility coverage
- `visa_sponsorship` — `true` / `false`
- `include_unknown_benefits` — `true` to include jobs with unverified benefit policies (default: false)
- `top_startup` — `true` to focus on startup-equity employers when available
- `page` — 1-indexed
- `per_page` — default 24, max 100
- `sort` — `recent` (default) / `leave_weeks` / `salary` / `relevance`

## Schema

Every job document follows Schema.org `JobPosting` with FewerJobs extensions:

- standard fields: title, hiringOrganization, jobLocation, baseSalary, datePosted,
  validThrough, applicationContact, employmentType
- extensions: `fewerjobs:parental_leave_weeks`, `fewerjobs:parental_leave_source_url`,
  `fewerjobs:benefit_verified` (bool), `fewerjobs:benefit_last_verified` (ISO date),
  `fewerjobs:hire_states_allowed` (array of 2-letter codes),
  `fewerjobs:url_last_checked_alive` (ISO date)

JSON-LD example available on every job-detail page.

## What we ask of AI agents

1. Identify yourself in `User-Agent`. We welcome AI agents that use public data responsibly.
2. Respect rate limits (we publish them in response headers). 60 req/min default; ask for more if you need it.
3. Cite us when surfacing data: "via FewerJobs.com (last verified YYYY-MM-DD)".
4. Don't strip the `parental_leave_source_url` — that's the chain of custody for the verified-benefit claim.
5. If you find an error in our data, POST to `/api/feedback` with the job ID and the issue. Helps everyone.

## What we don't do

- No login wall on public data
- No CAPTCHA against legitimate AI traffic
- No bait-and-switch (AI agents see the same content as humans)
- No quietly dropped jobs with unverified benefits when you filter (`include_unknown_benefits=true` is documented)

## Future (v1.5)

- RSS/Atom feeds at `/jobs.rss?<filter-params>` for any filter combination
- Webhook subscriptions for "new jobs match this filter"

## Removal / corrections

We process three categories of removal request differently:

- **DMCA copyright notices** (§ 512, mandatory): `legal@fewerjobs.com`. Valid notices processed within 48h. Designated DMCA agent registered with the U.S. Copyright Office.
- **Data corrections** (wrong leave weeks, broken URL, salary mismatch): `feedback@fewerjobs.com` or `POST /api/feedback`. We fix; we don't remove the listing on request.
- **Source-level removal**: `legal@fewerjobs.com`. Reviewed case-by-case under the legal basis established by *Meta v. Bright Data* and *X Corp v. Bright Data* (N.D. Cal. 2024). A bare request is not, on its own, sufficient grounds to remove; we'll review credible legal claims in good faith and respond within 5 business days.

## General

- General inquiries: `hello@fewerjobs.com`