Federal Compass MCP

AI compass from private sector to federal career — USAJobs search, salary, KSA

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

Not yet automatically verified

We haven't yet run this listing's install command through our automated sandbox check. This isn't a red flag — we're steadily working through the catalog.

Manual Client & Custom JSON ConfigExpand JSON ▾

Client Config & Setup

Choose your client or environment

Target File:~/Library/Application Support/Claude/claude_desktop_config.json

claude_desktop_config.json

{
  "mcpServers": {
    "federal-compass-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "federal-compass-mcp@latest"
      ]
    }
  }
}

💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.

Documentation Overview

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

2. Add to your MCP client

Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):

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

Code

Find me senior software developer jobs in Raleigh, NC

Code

What is a GS-13 and how much does it pay?

Code

Save my CV [attach file]

Code

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:

Code

~/.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 v22+
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.

Read the full README →View source on GitHub →

Related MCP Servers

View all in Developer Tools View all alternatives

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about Federal Compass MCP

Add the following block to your claude_desktop_config.json under mcpServers: "mcpServers": { "federal-compass-mcp": { "command": "npx", "args": ["-y", "Federal Compass MCP"] } }

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Federal Compass MCP AllMCPs Directory Badge

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/federal-compass-mcp?style=directory)](https://allmcps.com/mcp/federal-compass-mcp)

HTML Embed

<a href="https://allmcps.com/mcp/federal-compass-mcp"><img src="https://allmcps.com/api/badge/federal-compass-mcp?style=directory" alt="Federal Compass MCP on AllMCPs" /></a>

Technical Specs & Signals

CategoryDeveloper Tools

37Quality signal: Fair · 37/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership10/20

Documentation & tools15/30

Adoption & activity3/15

Community engagement0/10

A guidance signal from public completeness & health data — not a user rating. New listings start lower and rise as they add docs, get verified, and grow adoption. Signals we can't observe for a listing are skipped, not counted against it.

★ Spotlight Slot

Feature Your MCP Server

Get maximum visibility for your server across our directory, search results, and detail pages.

Spotlight Your Server

Own this project?

This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to unlock edit access and the Official badge — proof is checked automatically, then reviewed by our team.

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 💻 Developer Tools →Best MCP servers for Developers →Alternatives to Federal Compass MCP →Install in Claude Desktop Install in Cursor Install in VS Code

Federal Compass MCP

AI compass from private sector to federal career — USAJobs search, salary, KSA

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

Not yet automatically verified

We haven't yet run this listing's install command through our automated sandbox check. This isn't a red flag — we're steadily working through the catalog.

Manual Client & Custom JSON ConfigExpand JSON ▾

Client Config & Setup

Choose your client or environment

Target File:~/Library/Application Support/Claude/claude_desktop_config.json

claude_desktop_config.json

{
  "mcpServers": {
    "federal-compass-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "federal-compass-mcp@latest"
      ]
    }
  }
}

💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.

Documentation Overview

federal-compass-mcp

Your AI compass from private sector to federal career

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

2. Add to your MCP client

Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):

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

Code

Find me senior software developer jobs in Raleigh, NC

Code

What is a GS-13 and how much does it pay?

Code

Save my CV [attach file]

Code

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:

Code

~/.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 v22+
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.

Read the full README →View source on GitHub →

Related MCP Servers

View all in Developer Tools View all alternatives

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about Federal Compass MCP

Add the following block to your claude_desktop_config.json under mcpServers: "mcpServers": { "federal-compass-mcp": { "command": "npx", "args": ["-y", "Federal Compass MCP"] } }

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/federal-compass-mcp?style=directory)](https://allmcps.com/mcp/federal-compass-mcp)

HTML Embed

<a href="https://allmcps.com/mcp/federal-compass-mcp"><img src="https://allmcps.com/api/badge/federal-compass-mcp?style=directory" alt="Federal Compass MCP on AllMCPs" /></a>

Technical Specs & Signals

CategoryDeveloper Tools

37Quality signal: Fair · 37/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership10/20

Documentation & tools15/30

Adoption & activity3/15

Community engagement0/10

★ Spotlight Slot

Feature Your MCP Server

Get maximum visibility for your server across our directory, search results, and detail pages.

Spotlight Your Server

Own this project?

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 💻 Developer Tools →Best MCP servers for Developers →Alternatives to Federal Compass MCP →Install in Claude Desktop Install in Cursor Install in VS Code