@pipeworx/usajobs

Connect: https://gateway.pipeworx.io/usajobs/mcp · Install: one-click buttons

Tools: 5

USAJOBS.gov MCP — US federal civilian job postings. ~10k active openings any given day.

Tools

• search(keyword?, location?, position_title?, organization?, pay_grade_low?, pay_grade_high?, remote?, results_per_page?, page?) — primary search
• get_job(announcement_number) — full announcement record by number
• list_agencies() — federal agency reference
• list_pay_grades() — GS/SES grade reference
• list_occupational_series() — occupational series codes

Auth

USAJOBS requires a User-Agent (email) and an Authorization-Key header. Both come from a free registration at https://developer.usajobs.gov/.

• Platform key: gateway env PLATFORM_USAJOBS_KEY (the auth key) — the User-Agent email is hard-coded to the operator’s contact email at the pack level. Set PLATFORM_USAJOBS_USER_AGENT separately if you want to override.
• BYO: ?_apiKey=<auth_key>:<email> (colon-joined).

Data source

https://data.usajobs.gov/api/ — Host: data.usajobs.gov is automatic via fetch.

Tools

• search — Search USAJOBS announcements. Returns title, agency, location, salary band, posting/closing dates.
• get_job — Fetch a single announcement by USAJOBS announcement number.
• list_agencies — Return the USAJOBS reference list of all federal agency sub-element codes and names; useful for resolving agency codes returned by the search tool.
• list_pay_grades — Return the USAJOBS reference list of pay plan codes (GS, FW, ES, etc.) and their descriptions; use pay plan codes with the pay_grade_low/pay_grade_high search filters.
• list_occupational_series — Occupational series codes (e.g. 2210 Information Technology).