I
io.github.skivuha/federal-compass-mcp
AI compass from private sector to federal career — USAJobs search, salary, KSA
ActiveNot tested
28DNo CVEsactive
Quick Install
{
"mcpServers": {
"io-github-skivuha-federal-compass-mcp": {
"command": "<see-readme>",
"args": []
}
}
}No install config available. Check the server's README for setup instructions.
Are you the author?
Add this badge to your README to show your security score and help users find safe servers.
Embed in your READMEAbout badges →
[](https://mcppedia.org/s/io-github-skivuha-federal-compass-mcp)
Should you use this server?
AI compass from private sector to federal career — USAJobs search, salary, KSA
✓
Is it safe?
No package registry to scan.
No authentication — any process on your machine can connect.
License not specified.
✓
Is it maintained?
Last commit 1 days ago.
i
Will it work with my client?
Transport: stdio. Works with Claude Desktop, Cursor, Claude Code, and most MCP clients.
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 matte
Test This Server
No automated test available for this server. Check the GitHub README for setup instructions.
Help improve this page
This server is missing a description. Tools and install config are also missing.If you've used it, help the community.
Add informationScore Breakdown
Security
3/30No known vulnerabilities.
○
Known CVEs — No package registry to scan
○
Tool safety — No tools to analyze
○
Tool poisoning — No tools to analyze
○
Injection vectors — No tools to analyze
✓
Tool stability — Tool definitions stable
○
Dependency health — No package to analyze
✗
License — No license specified
○
Authentication — No authentication required
○
Repository — active repo
CVEs checked daily via OSV.dev. Score algorithm is open source.
Reviews
Have you used this server?
Share your experience — it helps other developers decide.
How easy was setup?Did it work reliably?How was the documentation?
Sign in to write a review.
Frequently Asked Questions
- Is io.github.skivuha/federal-compass-mcp safe to use?
- io.github.skivuha/federal-compass-mcp has no known CVEs as of the latest MCPpedia security scan. It does not require authentication, so any local process can connect — keep this in mind in shared environments.
- How do I install io.github.skivuha/federal-compass-mcp?
- io.github.skivuha/federal-compass-mcp can be installed by cloning its GitHub repository and following the setup instructions in the README.
- What AI clients work with io.github.skivuha/federal-compass-mcp?
- io.github.skivuha/federal-compass-mcp is compatible with Claude Desktop, Cursor, Claude Code, and most MCP clients that support stdio transport. It uses stdio transport.
- Is io.github.skivuha/federal-compass-mcp actively maintained?
- io.github.skivuha/federal-compass-mcp is actively maintained — last commit was 1 day ago.
Similar servers
View all →
Memory MCP Server
OfficialNo CVEs98A
Persistent memory using a knowledge graph
5 toolsstdio84.0k81.6k/wk2d ago
Context Mode
No CVEs95A
Privacy-first. MCP is the protocol for tool access. We're the virtualization layer for context.
6 toolsremote7.4k10.0k/wk2d ago
I
Idea Reality MCP Server
No CVEs95A
Pre-build reality check. Scans GitHub, HN, npm, PyPI, Product Hunt — returns 0-100 signal.
1 toolsremote60643.6k/wk3d ago
H
Hash-verified file editing MCP server with token efficiency hook. 11 tools for AI coding agents.
No CVEs95A
Hash-verified file editing MCP server with token efficiency hook. 11 tools for AI coding agents.
5 toolsremote405698.1k/wk1d ago
MCP Security Weekly
Get CVE alerts and security updates for io.github.skivuha/federal-compass-mcp and similar servers.
Discussion
Start a conversation
Ask a question, share a tip, or report an issue.
Has anyone used this with Cursor?How do you handle auth?Any alternatives?
Sign in to join the discussion.