Vinkius
USAJOBS (OPM)

USAJOBS (OPM) MCP for AI. Find or analyze any federal job listing.

Claude Claude
ChatGPT ChatGPT
Cursor Cursor
Gemini Gemini
Windsurf Windsurf
VS Code VS Code
JetBrains JetBrains
Vercel Vercel
See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

USAJOBS (OPM) MCP on Cursor AI Code EditorUSAJOBS (OPM) MCP on Claude Desktop AppUSAJOBS (OPM) MCP on OpenAI Agents SDKUSAJOBS (OPM) MCP on Visual Studio CodeUSAJOBS (OPM) MCP on GitHub Copilot AI AgentUSAJOBS (OPM) MCP on Google Gemini AIUSAJOBS (OPM) MCP on Lovable AI DevelopmentUSAJOBS (OPM) MCP on Mistral AI AgentsUSAJOBS (OPM) MCP on Amazon AWS Bedrock

Connect to your AI in seconds.

USAJOBS (OPM) MCP Server lets your AI agent access and analyze federal job postings directly from USAJOBS. Use `search_jobs` to find currently open roles by keyword, location, or category.

Pull historical data with `get_historic_joas` for trend analysis, or use `get_code_list` to validate occupational series codes before running a search.

What your AI can do

Get announcement text

Retrieves the full, long-form text details for any current or past job posting (JOA).

Get code list

Returns a list of valid values and codes needed to correctly filter search results.

Get historic joas

Pulls bulk data of past job announcements, supporting pagination via continuation tokens for large datasets.

+ 1 more capabilities included
Search Active Job Listings

Find currently open federal roles by filtering criteria like keywords, location, or job category using search_jobs.

Retrieve Full Posting Text

Fetch the detailed text for a specific job announcement, including full summaries and qualification requirements, with get_announcement_text.

Analyze Historical Job Trends

Pull bulk data of past and present JOAs using get_historic_joas, allowing for trend analysis across time periods.

Validate Federal Codes

Get a list of valid codes—like occupational series or pay plan IDs—needed to refine search filters precisely with get_code_list.

Included with Plan

Waiting for input…

AI Agent

USAJOBS (OPM) MCP Server: 4 Tools for Job Data Retrieval

These four tools let your agent search live jobs, pull historical records, get detailed text, and validate federal codes from the USAJOBS database.

Make your AI actually useful.

Add this MCP to Claude, Cursor, or Windsurf and your AI stops guessing. It gets real tools to look things up, take action, and handle the stuff you keep doing by hand.

Start using USAJOBS (OPM) on Vinkius

Get Announcement Text

Retrieves the full, long-form text details for any current or past job posting (JOA).

Get Code List

Returns a list of valid values and codes needed to correctly filter search results.

Get Historic Joas

Pulls bulk data of past job announcements, supporting pagination via continuation...

Search Jobs

Searches for currently open federal jobs on USAJOBS using filters like keyword...

Security and governance baked right in.

Pick your AI client below to get set up. Just create a Vinkius account, subscribe, and you're instantly up and running. We handle the entire backend infrastructure, delivering out-of-the-box support for HTTPS Streamable, SSE, and OAuth2—zero messy routing required.

Claude AI

Claude AI

1

Open Claude Settings

Go to claude.ai, click your profile icon, then navigate to Customize → Connectors.

2

Add Custom Connector

Click the "+" button and select Add custom connector. Paste your Vinkius endpoint URL:

https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. For OAuth-protected servers, expand Advanced settings to add credentials.

3

Start a conversation

Open a new chat. The USAJOBS (OPM) integration is available immediately — no restart needed.

Choose How to Get Started

Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.

Build Your Own

Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.

  • Import from OpenAPI, Swagger, or YAML specs
  • Create Agent Skills with progressive disclosure
  • Deploy to edge with MCPFusion framework
  • Built in DLP, auth, and compliance on every call
  • Real time usage dashboard and cost metering
  • Publish to catalog or keep private
Start building

Make Your AI Do More

Start with USAJOBS (OPM), then connect any of our 5,100+ other servers whenever your AI needs more. One click, no limits.

  • Use this MCP plus 5,100+ others, all in one place
  • Add new capabilities to your AI anytime you want
  • Every connection is secured and compliant automatically
  • Track usage and costs across all your servers
  • Works with Claude, ChatGPT, Cursor, and more
  • New servers added to the catalog every week
USAJOBS (OPM) MCP server cover

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by USAJOBS. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

VINKIUS INFRASTRUCTURE

Cloud Hosted

Managed infra

V8 Isolated

Sandboxed per request

Zero-Trust Proxy

No stored credentials

DLP Enforced

Policy on every call

GDPR Compliant

EU data residency

Token Compression

~60% cost reduction

Your data is protected. See how we built it.

Works with Claude, ChatGPT, Cursor, and more

The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.

This connection provides 4 powerful capabilities that interface natively with Claude, ChatGPT, Cursor, and other compatible AI platforms. No middleware. No custom integration required.

Sifting through federal job boards manually is a nightmare.

Right now, finding specific jobs means bouncing between the main search page and dozens of filter menus. You're copying keywords into one box, selecting codes from another dropdown, then clicking submit, only to find out you need a different code for that salary band. It’s tedious, time-consuming, and error-prone.

With this MCP server, your agent handles the whole process in natural chat. You tell it: 'Find me mid-level IT jobs near DC with a minimum pay grade of GS-12.' It runs `get_code_list` internally to validate parameters, executes `search_jobs`, and gives you the results—no manual clicking required.

Using USAJOBS (OPM) MCP Server: Get Data You Need.

Today, if you want to know how many jobs were posted last quarter for a certain category, you have to manually bookmark and visit archive pages, scraping data piece by piece. It's impossible to build a reliable trend report that way.

Now, simply ask your agent to run `get_historic_joas`. The server pulls the raw bulk records—the full dataset—and dumps it directly into your workflow. You get the data you need without touching an archive page.

What your AI can actually do with this

Your AI client connects straight to the official USAJOBS database, giving your agent direct access to federal job postings and personnel data. You don't gotta leave your chat window to dig into the federal hiring ecosystem.

When you’re ready to work, you first need to nail down your search parameters. Before running a main query, run get_code_list to pull a list of valid codes for occupational series, agency subelements, and pay plans. This step ensures your filters are precise; you won't waste time searching with bad data.

Once you have those codes validated, you can use search_jobs. This tool lets you find currently open roles by filtering multiple criteria: keywords, specific geographic locations, job categories, or defined hiring paths like Veterans and students. It pulls live announcements for federal jobs on USAJOBS.

To truly understand what a role entails, you need the full text. Use get_announcement_text to fetch the detailed, long-form text for any specific Job Announcement (JOA), whether it's current or historical. This gives you the complete picture—the summary, every required qualification, and the specific duties of the job.

When you need big-picture data, look at trends over time. You can pull bulk records using get_historic_joas. This tool provides access to a massive dataset of past JOAs, making it perfect for deep trend analysis across different periods. Because this volume of data is huge, the tool supports pagination through continuation tokens, letting you grab entire datasets without running into limits.

So, you use get_code_list first to validate your search codes; then you fire up search_jobs to find current openings. If you nail down a specific posting from those results, you run get_announcement_text to read the fine print. And if you're doing research on federal hiring patterns, get_historic_joas pulls all the necessary bulk data.

Built · Hosted · Managed by Vinkius USAJOBS MCP Server - Federal Job Data Analysis
Server ID 019e3904-1a5e-71eb-b7bc-79960239422b
Vinkius Inspector
Compliance Grade A+
Score 100/100
Vinkius Inspector Badge — Score 100/100

Questions you might have

How do I search for jobs using the USAJOBS (OPM) MCP Server? +

Run search_jobs. This tool lets your agent filter live job announcements by keywords, location, and category. It's the main entry point for finding active roles.

What is the difference between `get_announcement_text` and `search_jobs`? +

search_jobs gives you a list of titles and brief summaries from currently open jobs. You must use get_announcement_text to get the full, detailed text for any specific job ID.

Can I analyze old federal hiring data with USAJOBS (OPM) MCP Server? +

Yes. Use get_historic_joas. This tool retrieves bulk records of past Job Announcements, allowing you to study trends over time.

Do I need to use `get_code_list` before running a search? +

It's best practice. Running get_code_list first validates the specific codes (like pay plans) you plan to use, ensuring your search criteria are accurate and current.

How do I use `get_code_list` to refine my search criteria? +

You run get_code_list first, which retrieves valid codes and values for filtering results. This gives you the specific occupational series or pay plan IDs needed to make your search_jobs query highly targeted.

What is the difference between using `get_historic_joas` and `get_announcement_text`? +

get_historic_joas pulls bulk data for many past job announcements, supporting pagination via a continuation token. You use get_announcement_text when you need the full text of one specific JOA ID.

Does this server handle rate limits or throttling during large data retrievals? +

The connection handles standard API rate limiting, but for bulk historical analysis using get_historic_joas, you should implement backoff logic. The tool documentation provides specific guidelines on managing call frequency.

What information does the USAJOBS (OPM) MCP Server require to connect and authenticate? +

You must provide a valid USAJOBS API Key and your User Agent, which is typically an email address. These credentials authorize access to the live federal hiring database.

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).

Built & Managed by Vinkius 30s setup 4 tools

We've already built the connector for USAJOBS (OPM). Just plug in your AI agents and start using Vinkius.

No hosting. No infrastructure. No complex setup.
All 4 tools are live and waiting. You're up and running in seconds.

Vinkius runs on Claude Claude
Vinkius runs on ChatGPT ChatGPT
Vinkius runs on Cursor Cursor
Vinkius runs on Gemini Gemini
Vinkius runs on Windsurf Windsurf
Vinkius runs on VS Code VS Code
Vinkius runs on JetBrains JetBrains
Vinkius runs on Vercel Vercel
+ other MCP clients

Vinkius gives your AI agents access to the full catalog of app connectors, all fully managed, secure, and enterprise-ready. One subscription, every tool you need.

Zero hosting required Full MCP catalog included Enterprise-grade security Auto-updated by Vinkius

Built, hosted, and secured by Vinkius. You just connect and go.