Federal Compass Mcp
by skivuhacommunityv0.1.6
12
Connects Claude or another MCP client to the USAJobs API so users can search federal jobs, inspect postings, and get plain-English explanations of federal career concepts. It also compares job postings, checks CVs against roles, and saves a CV locally for reuse.
From the registry: AI compass from private sector to federal career — USAJobs search, salary, KSA
Install & configure
Prerequisites
- requiredInstall Node.js v20+Node.js version 20 or higher is required to run the MCP server via npx.
- requiredGet a USAJobs API keyRegister for a free USAJobs API key and verify your email to receive the API token.https://developer.usajobs.gov/apirequest/index
Install in your client
Paste into the AI you're chatting with — it will figure out the rest
Please install the `federal-compass-mcp` MCP server into my current AI client (that's you).
Required prerequisites (do these first if not already done):
- **Install Node.js v20+** — Node.js version 20 or higher is required to run the MCP server via npx.
- **Get a USAJobs API key** — Register for a free USAJobs API key and verify your email to receive the API token. (https://developer.usajobs.gov/apirequest/index)
Canonical MCP server config (stdio transport):
- command: `npx`
- args: ["-y","federal-compass-mcp@latest"]
- required environment variables:
- `USAJOBS_API_KEY`: USAJobs API token used to access the official USAJobs API. (example: `<your-usajobs-api-key>`)
- `USAJOBS_EMAIL`: Email address associated with your USAJobs API registration. (example: `<your-email@example.com>`)
Note: The README indicates the same stdio configuration works across MCP clients; only the client-specific config file path differs. The server stores CV and cached data locally under ~/.federal-compass/.
Add this MCP server to my current client's config in the correct format for you. If you need secrets or credentials I haven't provided, ASK me — do not invent values or leave raw placeholders. After adding it, tell me how to verify the server is connected.Note: The README indicates the same stdio configuration works across MCP clients; only the client-specific config file path differs. The server stores CV and cached data locally under ~/.federal-compass/.
Tools (10)
search_jobs
Search federal job openings with optional filters such as keyword, location, salary, grade, agency, and remote.
get_job_details
Get full details for a specific federal job posting.
compare_jobs
Compare 2-5 job postings side by side.
save_cv
Save a CV locally for automatic use in analysis.
get_cv
Read the saved CV.
explain_federal_concept
Explain federal concepts such as GS grades, clearances, hiring paths, and pay plans.
calculate_salary
Calculate GS salary with locality pay for a grade, step, and location.
find_matching_jobs
Find jobs matching a CV by extracting skills and searching USAJobs.
check_qualification
Compare a CV against a specific job posting to assess qualification.
extract_ksa
Extract KSA requirements from a job posting and optionally match them against a CV.
Environment variables
USAJOBS_API_KEYrequiredUSAJobs API token used to access federal job data.USAJOBS_EMAILrequiredEmail address required by the USAJobs API client configuration.Prerequisites
- • Node.js v20+
Packages
federal-compass-mcp
npmv0.1.6transport: stdio
Details
- Language
- TypeScript
- License
- MIT
- Released
- Apr 15, 2026
- Last commit
- Apr 22, 2026
- Registry name
- io.github.skivuha/federal-compass-mcp