# jobs.now MCP server

MCP server for [jobs.now](https://www.jobs.now) — a hidden job market board featuring H1B PERM sponsorship roles from major US companies (jobs not typically posted on LinkedIn/Indeed).

## Tools

| Tool | Description |
|---|---|
| `jobs_now_search` | Search jobs by keyword, category, location, salary, remote, date |
| `jobs_now_get_job` | Fetch full job details + description by job ID/slug |
| `jobs_now_browse_category` | Browse jobs in a specific category |
| `jobs_now_list_companies` | List companies with active job postings |
| `jobs_now_get_company` | Get company details + all their current openings |

## Categories

`software-engineering`, `data-science`, `engineering`, `finance`, `accounting`, `it-sys-admin`, `product-project-management`, `design`, `strategy-consulting`, `marketing`, `biotech`, `other`, `sales`, `law`, `medicine`, `general-management`, `teaching`, `manufacturing`

## Setup

```bash
npm install
npm run build
```

## Usage

### stdio (Claude Desktop)

```json
{
  "mcpServers": {
    "jobs-now": {
      "command": "node",
      "args": ["/path/to/jobs-now-mcp-server/dist/index.js"]
    }
  }
}
```

### HTTP

```bash
TRANSPORT=http PORT=3000 node dist/index.js
```

## Example Queries

- "Search for remote software engineering jobs paying over $150k"
- "Show me all Data Science jobs"
- "List companies hiring in finance"
- "Get job details for job ID 495367555-sr-software-engineer-ref-6070"
- "What jobs does Meta Platforms have open?"

## Known Issues

- `location` field is sometimes empty — the site uses inconsistent span structure across listings, so the location parser misses some cards
- `apply_url` is jobs.now's application-log form, not the employer's ATS — actual application instructions (email, employer site, mail) are in the job description
- `jobs_now_get_job` requires the full URL slug (e.g. `490433823-software-engineer-agentic-ai-ref-9902208`); bare numeric IDs return 404
- Duplicate listings exist on the site (same role/REF posted under multiple job IDs at different times); deduplication is ID-based only

## Notes

- No API key required — scrapes public job board
- jobs.now specializes in H1B PERM roles: exclusive hidden market jobs
- Follow application instructions precisely (companies must follow strict PERM process)