# USAJOBS (OPM) MCP for AI Agents AI Agent Connect > USAJOBS (OPM) connects your AI agent to the official federal hiring database. It allows you to search live job listings, pull historical data for research, and extract full job descriptions including duties and qualifications. ## Overview - **Category:** industry-titans - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_Wp8aZUfBa7dzHOHoLeaM3UdshgdKZs3uQb0UUSNC/ai-agent-connect - **Tags:** federal-jobs, career-search, public-sector, hiring-data, job-listings, government-employment ## Description The USAJOBS (OPM) MCP connects your AI agent directly to the official federal hiring database. Finding a federal job usually involves a headache of navigating outdated portals, manually copying text into notes, and trying to decipher government-speak like occupational series or hiring paths. You end up with dozens of tabs open, trying to figure out if a role actually fits your experience. 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. It pulls the data directly from the source, so you get accurate, live results every time. If you're looking for a specific niche, like software engineering in a specific agency, the agent can grab the full text of the announcement to help you see exactly what the daily tasks look like. It even handles the boring stuff, like pulling valid codes for different pay plans or agency subelements to make your search much more precise. You'll find this is a game changer when you're trying to map out a career path in the public sector. It's one of the many high-quality connectors available in the Vinkius catalog that turns a massive, intimidating database into a searchable, conversational experience. No more jumping between tabs or getting lost in government jargon; you just get the answers you need to land that federal role. Whether you are a job seeker trying to find your first government position or a data analyst looking for hiring trends, this tool puts the data in your hands. ## Tools ### get_code_list Pulls valid values and codes for filtering search results. It is useful for narrowing down your search to specific government categories. ### get_historic_joas Fetches bulk data for current and past job postings. Use this to see how hiring trends have changed over time. ### 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. ### get_announcement_text Retrieves long text fields for current and past job postings. This lets you see the full details on duties and qualifications. ## Prompt Examples **Prompt:** ``` Find software engineering jobs in Washington DC with a salary over 100k. ``` **Response:** ``` I found 12 active Software Engineer positions in Washington, DC meeting your criteria. Notable listings include a Lead Developer role at the Department of State and a Senior Engineer position at NASA. Would you like the details for any of these? ``` **Prompt:** ``` What are the specific duties for announcement 784521900? ``` **Response:** ``` Retrieving announcement text... For JOA 784521900, the primary duties involve managing cloud infrastructure and ensuring cybersecurity compliance. Qualifications require at least one year of specialized experience at the GS-12 level. Shall I summarize the full text for you? ``` **Prompt:** ``` What are the codes for IT jobs? ``` **Response:** ``` I've fetched the code list. For Information Technology, the primary series is 2210. Other related codes include 1550 (Computer Science) and 0854 (Computer Engineering). ``` ## Capabilities ### Search live federal jobs Find active government roles using keywords, locations, and salary ranges. ### Extract full job details Get the complete text of announcements, including duties and qualifications. ### Pull historical hiring data Retrieve bulk data for past job postings to analyze hiring trends. ### Get reference codes Retrieve valid codes for pay plans, agency subelements, and occupational series. ### Filter by hiring paths Query specific categories like Veterans, Students, or Public roles. ### Summarize job requirements Get a clear breakdown of what is required for a specific federal position. ## Use Cases ### Finding niche software roles A job seeker wants to find software engineering jobs in D.C. with a $100k salary. The agent finds the best matches based on those filters. ### Explaining pay plans A career counselor needs to explain pay plans to a client. The agent pulls the correct codes for their industry. ### Analyzing hiring trends A data analyst wants to see how many IT jobs were posted last year. The agent pulls that data for a trend report. ### Verifying qualifications A candidate wants to know the specific GS-level requirements for a role. The agent grabs the full text to show the fine print. ## Benefits - Stop manual searching. Find specific federal roles instantly based on your location and salary needs. - Get the fine print. See every duty and qualification required for a specific role without clicking through multiple pages. - Analyze hiring trends. Pull bulk data on past job postings for research or career planning. - Refine your search results. Pull valid occupational series and pay plan codes to get much more accurate listings. - Save time on research. Your agent can summarize complex federal requirements into a simple list of what you actually need to do. ## How It Works The bottom line is you get direct, real-time access to federal job data without the manual search fatigue. 1. Subscribe to the USAJOBS (OPM) MCP and provide your API key and user agent. 2. Ask your AI client to find specific roles or pull data from the federal database. 3. Receive a list of results or a full text summary of a specific job announcement. ## Frequently Asked Questions **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` tool. 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` tool 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` tool with the endpoint 'occupationalseries'. This will return a list of all valid codes and their corresponding titles (e.g., 2210 for Information Technology).