USAJOBS (OPM) Connector for AI agents.
4 live capabilities
Find and analyze federal career opportunities and government job listings.
Waiting for input…
Why people use USAJOBS (OPM)
USAJOBS (OPM) for navigating complex federal hiring requirements
This connection changes that by letting your agent do the heavy lifting. Instead of manually filtering through thousands of entries, you can just tell your agent what kind of role you want, where you want to live, and what your salary goals are. You get a clear picture of the job market without the manual data entry.
What Vinkius changes
You get direct, real-time access to federal job data without the manual search fatigue.
Use it from Claude, ChatGPT, Cursor or another AI client you already have.
One account · 5,900+ Connectors
- Real-world use case 01
Finding niche software roles
A job seeker wants to find software engineering jobs in D.
- Real-world use case 02
Explaining pay plans
A career counselor needs to explain pay plans to a client.
- Real-world use case 03
Analyzing hiring trends
A data analyst wants to see how many IT jobs were posted last year.
Complete set · 4capabilities
The complete USAJOBS (OPM) capability set.
These are the exact actions your AI can choose when you ask it to work with USAJOBS (OPM).
01—04
4 capabilities in this set.
Part of 4 available through USAJOBS (OPM).
- 01 Capability
Get code list
Pulls valid values and codes for filtering search results. It is useful for narrowing down your search to specific government categories.
- 02 Capability
Get historic joas
Fetches bulk data for current and past job postings. Use this to see how hiring trends have changed over time.
- 03 Capability
Search jobs
Finds currently open job announcements on USAJOBS based on keywords or location. This is the primary way to see what is available right now.
- 04 Capability
Get announcement text
Retrieves long text fields for current and past job postings. This lets you see the full details on duties and qualifications.
Set up in minutes
One URL. Then ask USAJOBS (OPM) to work.
Claude and ChatGPT only need the Connector URL. Copy it once, add it in settings, and use USAJOBS (OPM) from the conversation.
Choose your client
Live previewAdvanced clients IDE · CLI
Claude · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_Wp8aZUfBa7dzHOHoLeaM3UdshgdKZs3uQb0UUSNC/mcp - Step 01
Open Connectors
In Claude Web or Claude Desktop, open Settings and choose Connectors.
- Step 02
Add the URL
Choose Add custom connector, name it USAJOBS (OPM), and paste the URL above.
- Step 03
Turn it on in chat
Select +, open Connectors, and enable USAJOBS (OPM) for the conversation.
ChatGPT · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_Wp8aZUfBa7dzHOHoLeaM3UdshgdKZs3uQb0UUSNC/mcp - Step 01
Open MCP settings
On desktop, open Settings and MCP servers. On web, open your workspace app or connector settings.
- Step 02
Add the URL
Choose Add server with Streamable HTTP, or create a custom MCP app, then paste the USAJOBS (OPM) URL.
- Step 03
Save and start
Save the connection and enable USAJOBS (OPM) in your conversation. Desktop may ask you to restart once.
Cursor · IDE configuration
Advanced setup
{
"mcpServers": {
"usajobs-opm": {
"url": "https://edge.vinkius.com/vk_preview_Wp8aZUfBa7dzHOHoLeaM3UdshgdKZs3uQb0UUSNC/mcp"
}
}
}- Step 01
Open MCP Settings
Press Cmd+Shift+P (macOS) or Ctrl+Shift+P (Windows/Linux) → search "MCP Settings"
- Step 02
Add the server config
Paste the JSON configuration above into the mcp.json file that opens
- Step 03
Save the file
Cursor will automatically detect the new Connector
- Step 04
Start using USAJOBS (OPM)
Open Agent mode in chat and ask: "Using USAJOBS (OPM), help me...". 4 tools available
VS Code Copilot · IDE configuration
Advanced setup
{
"mcpServers": {
"usajobs-opm": {
"url": "https://edge.vinkius.com/vk_preview_Wp8aZUfBa7dzHOHoLeaM3UdshgdKZs3uQb0UUSNC/mcp"
}
}
}- Step 01
Create MCP config
Create a .vscode/mcp.json file in your project root
- Step 02
Add the server config
Paste the JSON configuration above
- Step 03
Enable Agent mode
Open GitHub Copilot Chat and switch to Agent mode using the dropdown
- Step 04
Start using USAJOBS (OPM)
Ask Copilot: "Using USAJOBS (OPM), help me...". 4 tools available
Windsurf · IDE configuration
Advanced setup
{
"mcpServers": {
"usajobs-opm": {
"url": "https://edge.vinkius.com/vk_preview_Wp8aZUfBa7dzHOHoLeaM3UdshgdKZs3uQb0UUSNC/mcp"
}
}
}- Step 01
Open MCP Settings
Go to Settings → MCP Configuration or press Cmd+Shift+P and search "MCP"
- Step 02
Add the server
Paste the JSON configuration above into mcp_config.json
- Step 03
Save and reload
Windsurf will detect the new server automatically
- Step 04
Start using USAJOBS (OPM)
Open Cascade and ask: "Using USAJOBS (OPM), help me...". 4 tools available
Cline · IDE configuration
Advanced setup
{
"mcpServers": {
"usajobs-opm": {
"url": "https://edge.vinkius.com/vk_preview_Wp8aZUfBa7dzHOHoLeaM3UdshgdKZs3uQb0UUSNC/mcp"
}
}
}- Step 01
Open Cline MCP Settings
Click the Connectors icon in the Cline sidebar panel
- Step 02
Add remote server
Click "Add Connector" and paste the configuration above
- Step 03
Enable the server
Toggle the server switch to ON
- Step 04
Start using USAJOBS (OPM)
Ask Cline: "Using USAJOBS (OPM), help me...". 4 tools available
Claude Code · Terminal command
Advanced setup
claude mcp add usajobs-opm --transport http "https://edge.vinkius.com/vk_preview_Wp8aZUfBa7dzHOHoLeaM3UdshgdKZs3uQb0UUSNC/mcp"- Step 01
Install Claude Code
Run npm install -g @anthropic-ai/claude-code if not already installed
- Step 02
Add the Connector
Run the command above in your terminal
- Step 03
Verify the connection
Run claude mcp to list connected servers, or type /mcp inside a session
- Step 04
Start using USAJOBS (OPM)
Ask Claude: "Using USAJOBS (OPM), show me...". 4 tools are ready
Where the request belongs
Work USAJOBS can move forward.
This is for people who need to navigate the complex world of federal hiring without spending hours clicking through government portals.
Federal Job Seekers
Finding roles that actually match their specific skills without getting lost in complex filters.
Career Counselors
Helping clients understand the nuances of federal pay plans and qualification requirements.
HR Data Analysts
Researching hiring trends and occupational codes across different government agencies.
Build the capability set
Add more capabilities.
Each Connector adds new actions and data without changing how you work.
Browse ConnectorsZipRecruiter
Search millions of job listings on ZipRecruiter. find roles by keyword, location, and salary directly from your AI agent.
Adzuna
Search millions of job advertisements and access real-time labor market analytics, salary trends, and regional vacancy data.
Indeed
Search for job listings on Indeed. find roles by keyword, location, and job type directly from any AI agent.
BLS JOLTS — Job Openings, Quits & Turnover
Deep-dive into the 'Great Resignation' and labor tightness with the US Job Openings and Labor Turnover Survey (JOLTS). Track hires, fires, and voluntary quits.
Lightcast Labor Market
Equip your AI agent to access labor market data, track skill taxonomies, and monitor job titles via the Lightcast API.
Jobtoolz
Manage recruitment, jobs, and candidates via Jobtoolz API.
Bring your own AI
Change the model, client or framework. Keep USAJOBS connected.
-
Claude -
ChatGPT -
Gemini -
Cursor -
VS Code -
Windsurf -
ZCode -
Cline -
Zed -
Continue -
Kiro -
Roo Code -
Zencoder -
Goose -
Void -
Augment Code -
Amp -
Qodo -
Tabnine -
Pieces -
Sourcegraph Cody -
JetBrains -
Warp -
Amazon Q -
Antigravity -
BoltAI -
Raycast -
Jan -
LM Studio -
AnythingLLM -
Open WebUI -
Msty -
Cherry Studio -
LibreChat -
TypingMind -
Chorus -
5ire -
n8n -
LangChain -
LlamaIndex -
CrewAI -
Vercel AI SDK
Before you connect
Questions about USAJOBS.
The practical details behind the request, access and result.
Can the USAJOBS (OPM) MCP find jobs for me?
Yes, it lets your AI client search live federal job listings based on keywords, location, and salary. It finds the roles and presents them to you in a simple list.
Does USAJOBS (OPM) include historical job data?
Yes, the Connector can pull bulk data for past job postings. This is great for researching hiring trends or looking at older announcements.
Can I get the full job description using USAJOBS (OPM)?
Absolutely. You can ask your agent to pull the full text of a specific announcement to see every duty and qualification listed.
Can USAJOBS (OPM) help me find specific pay plans?
It can retrieve the valid codes for pay plans and occupational series. This helps you narrow down your search to the right government categories.
Is USAJOBS (OPM) for private sector jobs?
No, this Connector specifically connects to the official USAJOBS database for federal government positions.
How do I use USAJOBS (OPM) to filter for Veterans?
You can ask your agent to search for jobs using specific hiring paths like Veterans, Students, or Public.
How can I filter jobs by a specific location and salary range?
Use the search_jobs capability. You can provide parameters like LocationName (e.g., 'Washington, DC') and RemunerationMinimumAmount to narrow down the results to your specific needs.
Where can I find the full description of duties for a job posting?
The get_announcement_text capability is designed specifically for this. By providing the announcement number, the agent will retrieve the full text for Summary, Duties, and Qualifications.
How do I know which codes to use for occupational series like IT or Engineering?
You can use the get_code_list capability with the endpoint 'occupationalseries'. This will return a list of all valid codes and their corresponding titles (e.g., 2210 for Information Technology).
One connection away
Give your agent a direct line to USAJOBS.
Connect USAJOBS once. Keep it beside 5,900+ managed Connectors when the next task needs more.
Explore every Connector No credit card required · Free tier available