How to Use the USAJOBS (OPM) MCP in Cline

Q: Can I get filtering codes using USAJOBS (OPM) and Cline?

Yes. The getcodelist tool fetches valid values for search filters. You can embed this call into your script to dynamically build the necessary parameters for other functions.

Q: What if I need bulk data from USAJOBS (OPM) using Cline?

Use gethistoricjoas. Since you're in a coding environment, you can write a robust loop that handles the continuation tokens and processes all the historical job announcements reliably.

Q: Does USAJOBS (OPM) support location filtering in Cline?

Totally. searchjobs supports detailed location filters right from the command line, letting you build scripts that only check jobs within a specific geographical area.

Execute USAJOBS (OPM) research tasks end-to-end inside Cline.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect USAJOBS (OPM) MCP to Cline

Create your Vinkius account to connect USAJOBS (OPM) to Cline and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup USAJOBS (OPM) with Cline

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Run complex job searches in the terminal

You tell Cline to search for jobs, and it uses `search_jobs` to get active listings. You can pass filters like keywords or categories directly into your script. The output is structured code you can immediately write to a file, test, and commit.

Batch process historic job data

Need to analyze thousands of old postings? Run `get_historic_joas`. Cline handles the pagination using continuation tokens so your script doesn't choke on massive datasets. The result is clean, usable JSON that you can pipe directly into a database write command.

Extract deep job requirements text

When `get_announcement_text` pulls data for a specific JOA, Cline grabs the full long text field. You don't have to open a browser; you get the raw content in your shell script. This means you can run automated parsing scripts on job requirements that are otherwise buried in HTML.

Setup guide

Set up USAJOBS (OPM) MCP in Cline

Prerequisites

VS Code with Cline extension installed
Active Vinkius subscription with a valid endpoint token

1

Open Cline MCP settings

Click the Cline icon in the VS Code sidebar to open the Cline panel. Then click the MCP Servers icon (server stack) at the top-right corner of the panel.
2

Add a remote server

Click "Remote Servers" at the top, then click "Add Remote MCP". In the Name field, type usajobs-opm-mcp. In the URL field, paste your Vinkius endpoint: https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp. Get your token from cloud.vinkius.com.
3

Enable the server

After saving, the server appears in the Cline MCP panel. Toggle the switch to enable it. The status indicator turns green when the connection is live.
4

Start using tools

Return to the Cline chat and ask: "Check my latest USAJOBS (OPM) refund status." Cline will discover the available tools and request your approval before invoking each one — giving you full control over every action.

Cline MCP Settings

{
  "mcpServers": {
    "usajobs-opm-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

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.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect USAJOBS (OPM) now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about USAJOBS (OPM) MCP in Cline

Just invoke the tool call directly in your terminal session. You write a script that calls `search_jobs` and then pipes the resulting data into another utility, like a file writer.

Yes. The `get_code_list` tool fetches valid values for search filters. You can embed this call into your script to dynamically build the necessary parameters for other functions.

Use `get_historic_joas`. Since you're in a coding environment, you can write a robust loop that handles the continuation tokens and processes all the historical job announcements reliably.

Totally. `search_jobs` supports detailed location filters right from the command line, letting you build scripts that only check jobs within a specific geographical area.

This server handles job announcement text and historical job posting metadata. The primary data types are long text fields, structured codes, and location strings for searching.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript