AI compass from private sector to federal career — USAJobs search, salary, KSA
The io.github.skivuha/federal-compass-mcp server is an MCP-compatible Node.js/TypeScript service described as an “AI compass from private sector to federal career.” It focuses on USAJobs-related searches and includes access to salary and KSA information.
🛠️ Key Features
MCP-compatible (Model Context Protocol)
USAJobs search
Salary information
KSA (knowledge, skills, and abilities)
🚀 Use Cases
Finding federal career opportunities via USAJobs
Comparing or retrieving salary details
Reviewing KSA-related content for federal roles
⚡ Developer Benefits
Integrates with MCP tooling
Built for Node.js and TypeScript environments
Topics align with career and federal-jobs workflows (career, federal-jobs, government, usajobs)
⚠️ Limitations
Provided source data does not specify additional tools beyond USAJobs search, salary, and KSA.
Federal job descriptions are 5 pages of legal language. GS grades, clearance levels, hiring paths — none of this is explained anywhere. federal-compass-mcp connects Claude to the official USAJobs API and turns it into an AI advisor that speaks plain English.
Built for tech professionals transitioning from private sector to federal/government careers.
What it does
Searches federal job openings with optional filters — keyword, location, salary, clearance level
Translates federal job descriptions into plain language — what they actually want, without the jargon
Supports CV analysis by providing your CV and job requirements to your AI assistant for comparison
Calculate GS salary with locality pay for any grade, step, and location
find_matching_jobs
Find jobs matching your CV — extracts skills and searches USAJobs
check_qualification
Compare your CV against a specific job posting
extract_ksa
Extract KSA requirements from a job posting, optionally match against your CV
CV storage and privacy
Your saved CV is stored locally on your machine:
code
~/.federal-compass/
cv.json
codelists/ <- cached USAJobs reference data
The get_cv and check_qualification tools return your CV text to your MCP client. Depending on your client and its configuration, that text may be sent to an AI provider for processing. Review your client's and provider's privacy settings before sharing personal information.
The find_matching_jobs tool sends keywords extracted from your CV to USAJOBS to search for relevant vacancies.
Data source and independent analysis
Federal job announcements and API reference data come from USAJOBS. Use of the API is subject to the USAJOBS API Terms of Service. Each user should register for and use their own API credentials.
This is an independent project. It is not operated, sponsored, approved, or endorsed by the U.S. Office of Personnel Management (OPM) or USAJOBS.
AI explanations, CV comparisons, and extracted requirement matches are unofficial analysis, not an agency determination of eligibility. Verify requirements, deadlines, and application instructions against the current official announcement on USAJOBS before applying.
Why federal jobs are confusing (and how this helps)
Coming from private sector, federal job postings feel like a different language:
GS-13 Step 1-10 — what grade am I? what does step mean?
TS/SCI with polygraph — do I need this? how long does it take?
Competitive vs Excepted Service — which one can I apply to?
HiringPath: fed-transition — what is this and why does it matter?
federal-compass-mcp answers all of these through natural conversation with Claude.