# PerDiemList for AI agents

> How an AI assistant or agent can search PerDiemList's jobs, read one job, and cite it, with or without the connector.

## When to use PerDiemList

Use it when someone is looking for blue-collar or skilled-trades work in the United States: construction, industrial, maintenance, shutdown and travel jobs, including questions about per diem, housing, pay or required certifications. It does not list office, software or healthcare jobs, or jobs outside the US.

## With the connector (MCP)

PerDiemList runs a public, read-only Model Context Protocol server over Streamable HTTP. It needs no account, key or sign-in.

- Claude, Claude Code and other MCP clients: `https://api.perdiemlist.com/mcp`
- ChatGPT and Codex: `https://api.perdiemlist.com/mcp/openai`

| Tool | Use it to | Main inputs |
| --- | --- | --- |
| `search_jobs` | Find jobs | `query`, `trade`, `area` (city and state, ZIP or state), `radius_miles`, `per_diem`, `min_hourly_pay`, `housing_provided`, `travel`, `certifications`, `start`, `posted_within_days`, `sort`, `page`, `language` |
| `get_job` | Read one job in full | `job_id` from a search result, `language` |
| `get_job_counts` | See which trades and states have open jobs | `trade`, `state`, `language` |

In Claude: Customize › Connectors › Add custom connector, then enter the address above and choose no sign-in. In Claude Code: `claude mcp add --transport http perdiemlist https://api.perdiemlist.com/mcp`. In Codex: `codex mcp add perdiemlist --url https://api.perdiemlist.com/mcp/openai`.

## Without the connector (plain markdown)

Every public page has a markdown version. Add `.md` to its address, or send `Accept: text/markdown`.

| Address | Returns |
| --- | --- |
| `https://perdiemlist.com/jobs.md` | Newest open jobs, with filters (below) |
| `https://perdiemlist.com/en/trades/welder.md` | Open jobs in one trade (use the trade's slug) |
| `https://perdiemlist.com/en/trades/welder/tx.md` | One trade in one state |
| `https://perdiemlist.com/en/locations/tx.md` | All open jobs in one state |
| `https://perdiemlist.com/en/per-diem-jobs.md` | Jobs that offer per diem |
| `https://perdiemlist.com/en/travel-jobs.md` | Travel jobs |
| `https://perdiemlist.com/en/trades.md` | Open job counts by trade and by state |
| `https://perdiemlist.com/en/jobs/{job}.md` | One job in full: the job page's address plus `.md` |

Filters for any job list, as query parameters:

- `q`: free text, such as `pipe welder`
- `trade`: a trade ID from `/en/trades.md`, such as `welder` or `electrician`
- `state`: a two-letter state code, such as `TX`
- `location` and `radius`: a city and state or ZIP code, and miles around it (25, 50, 100 or 200)
- `per_diem=true`: only jobs that offer per diem
- `housing=true`: only jobs that provide housing
- `travel=true`: only travel jobs
- `min_pay`: minimum base pay in dollars per hour
- `certs`: comma-separated credentials. Any of: osha_10, osha_30, osha, twic, nccer, nccco, cwi, journeyman_license, trade_license, drivers_license, cdl, msha, safeland, h2s, nfpa_70e, lift_equipment, first_aid_cpr
- `sort`: `relevance`, `newest` or `pay`
- `page`: 1 and up

Example: `https://perdiemlist.com/jobs.md?trade=pipefitter&state=LA&per_diem=true`. Use `/es/` in place of `/en/` for Spanish.

## How to report what you find

- Report base pay and per diem separately, exactly as listed. "Not listed" means the employer did not say; it is not zero.
- A daily per diem does not mean seven paid days a week unless the job says so.
- Link each job to its page on perdiemlist.com. That is where people apply; applying is free for workers.
- Jobs close. Check the job's page or `get_job` before telling someone a job is open.
- Answer in the person's language. Job lists and job pages are available in English and Spanish.

## About the source

PerDiemList is a job board and community for blue-collar and skilled-trades workers in the United States, where every job shows base pay, per diem, housing, schedule and required certifications up front. [About](https://perdiemlist.com/about.md) · [Comparison with Indeed, Google Jobs, Facebook groups and company sites](https://perdiemlist.com/compare.md) · [For employers](https://perdiemlist.com/employers.md)

## Access and limits

Public pages and their markdown versions may be read by AI crawlers and assistants; see robots.txt. Account, employer and admin pages are private. The connector is rate limited per caller; a refused call says to retry in a minute. Questions: support@perdiemlist.com.

---

PerDiemList for AI agents: https://perdiemlist.com/llms.txt (index) · https://perdiemlist.com/agents.md (how to search and cite)
