Back to Browse
Free
Server data from the Official MCP Registry
AI compass from private sector to federal career — USAJobs search, salary, KSA
About
AI compass from private sector to federal career — USAJobs search, salary, KSA
Security Report
0.0
Use Caution0.0Critical RiskValid MCP server (1 strong, 0 medium validity signals). 11 known CVEs in dependencies (2 critical, 8 high severity) Package registry verified. Imported from the Official MCP Registry.
7 files analyzed · 12 issues found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
Permissions Required
This plugin requests these system permissions. Most are normal for its category.
Unverified package source
We couldn't verify that the installable package matches the reviewed source code. Proceed with caution.
What You'll Need
Set these up before or after installing:
API key from developer.usajobs.gov
Environment variable: USAJOBS_API_KEY
Email used when requesting the API key
Environment variable: USAJOBS_EMAIL
How to Install
Add this to your MCP configuration file:
{
"mcpServers": {
"io-github-skivuha-federal-compass-mcp": {
"env": {
"USAJOBS_EMAIL": "your-usajobs-email-here",
"USAJOBS_API_KEY": "your-usajobs-api-key-here"
},
"args": [
"-y",
"federal-compass-mcp"
],
"command": "npx"
}
}
}Documentation
View on GitHubFrom the project's GitHub README.
federal-compass-mcp
Your AI compass from private sector to federal career
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
- Analyzes your CV against specific job postings and tells you if you qualify
- Explains federal concepts — GS grades, pay plans, security clearances, hiring paths
- Saves your CV locally so Claude can reference it automatically
Getting started
1. Get your free USAJobs API key
Register at developer.usajobs.gov — takes about 3 minutes. Verify your email and you'll receive an API token.
2. Add to your MCP client
Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):
{
"mcpServers": {
"federal-compass": {
"command": "npx",
"args": ["-y", "federal-compass-mcp@latest"],
"env": {
"USAJOBS_API_KEY": "your_api_key",
"USAJOBS_EMAIL": "your@email.com"
}
}
}
}
VS Code / Cursor / Windsurf — same config, different config file path. See your client's MCP documentation.
3. Try it
Find me senior software developer jobs in Raleigh, NC
What is a GS-13 and how much does it pay?
Save my CV [attach file]
Look at this job posting — am I qualified?
Tools
| Tool | Description |
|---|---|
search_jobs | Search federal job openings. All filters optional — keyword, location, salary, grade, agency, remote |
get_job_details | Get full details for a specific job posting |
compare_jobs | Compare 2-5 job postings side by side |
save_cv | Save your CV locally for automatic use in analysis |
get_cv | Read your saved CV |
explain_federal_concept | Explain GS grades, clearances, hiring paths, pay plans |
calculate_salary | 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
Your CV is stored locally on your machine — never sent to any server:
~/.federal-compass/
cv.json
config.json
codelists/ <- cached USAJobs reference data
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.
Requirements
- Node.js v20+
- Free USAJobs API key
- Any MCP-compatible client (Claude Desktop, VS Code, Cursor, etc.)
Contributing
Issues and PRs welcome. See CONTRIBUTING.md.
License
MIT — see LICENSE
Built by @skivuha — a Senior Frontend Engineer navigating the private-to-federal transition firsthand.
Reviews
No reviews yet
Be the first to review this server!
More Developer Tools MCP Servers
Git
Freeby Modelcontextprotocol · Developer Tools
Read, search, and manipulate Git repositories programmatically
80.0K
Stars
4
Installs
6.5
Security
No ratings yet
Local
Toleno
Freeby Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
114
Stars
409
Installs
8.0
Security
4.8
Local
mcp-creator-python
Freeby mcp-marketplace · Developer Tools
Create, build, and publish Python MCP servers to PyPI — conversationally.
-
Stars
56
Installs
10.0
Security
5.0
Local
MarkItDown
Freeby Microsoft · Content & Media
Convert files (PDF, Word, Excel, images, audio) to Markdown for LLM consumption
116.1K
Stars
15
Installs
6.0
Security
5.0
Local
mcp-creator-typescript
Freeby mcp-marketplace · Developer Tools
Scaffold, build, and publish TypeScript MCP servers to npm — conversationally
-
Stars
14
Installs
10.0
Security
5.0
Local
FinAgent
Freeby mcp-marketplace · Finance
Free stock data and market news for any MCP-compatible AI assistant.
-
Stars
13
Installs
10.0
Security
No ratings yet
Local