Federal Compass MCP

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. Its 10 documented tools cluster into read & search, compare, save, explain. It runs locally over stdio via the published package.

People connecting API integration tools to Claude, Cursor, VS Code, or another MCP client. The project is written in TypeScript.

VERIFIED ACTIVE

LAST COMMIT 2026-08-19 · ★ 12 · #61 OF 250 MAINTAINED API INTEGRATION · VERIFIED 2026-08-25

MIT · TypeScript servers · how we verify → /methodology

01 · Install Federal Compass MCP

before you install - you'll need

Set USAJOBS_API_KEY, USAJOBS_EMAIL before connecting.

Claude Code

claude mcp add skivuha-federal-compass-mcp -- npx -y federal-compass-mcp

Claude Desktop / Cursor / VS Code - add to config

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

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license MIT - declared in the repository

npm package federal-compass-mcp - unscoped; check the name against the project README before installing

registry namespace io.github.skivuha is GitHub-verified and matches the repo owner

03 · What Federal Compass MCP can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

With this server connected, an agent can search federal job openings. All filters optional - keyword, location, salary, grade, agency, remote, get full details for a specific job posting, compare 2-5 job postings side by side, and save your CV locally for automatic use in analysis.

Capability map

Tools grouped from the project's README - what Federal Compass MCP lets an agent do.

read & search

4 tools - e.g. Search federal job openings. All filters optional - keyword, location, salary, grade, agency, remote; Get full details for a specific job posting; Read your saved CV

search_jobs · get_job_details · get_cv · find_matching_jobs

Compare

1 tool - e.g. Compare 2-5 job postings side by side

compare_jobs

Save

1 tool - e.g. Save your CV locally for automatic use in analysis

save_cv

Explain

1 tool - e.g. Explain GS grades, clearances, hiring paths, pay plans

explain_federal_concept

Calculate

1 tool - e.g. Calculate GS salary with locality pay for any grade, step, and location

calculate_salary

Check

1 tool - e.g. Compare your CV against a specific job posting

check_qualification

Extract

1 tool - e.g. Extract KSA requirements from a job posting, optionally match against your CV

extract_ksa

Latest releases

federal-compass-mcp-v0.1.10 · 2026-07-27

0.1.10 (2026-07-27) · report the real package version to MCP clients

federal-compass-mcp-v0.1.9 · 2026-05-24

0.1.9 (2026-05-24) · update hono to 4.12.14 to fix HTML injection vulnerability

federal-compass-mcp-v0.1.8 · 2026-04-17

0.1.8 (2026-04-17) · add CONTRIBUTING.md

04 · Who maintains Federal Compass MCP

Federal Compass MCP is maintained by skivuha. It's the only MCP server we track from this author; the repo dates to Apr 2026.

05 · Facts

repository: github.com/skivuha/federal-compass-mcp
category: API integration - ranked #61 of 250 actively-maintained API integration servers as of 2026-08-25.
release cadence: 1 release in the last 90 days (latest 2026-07-27)
registry: io.github.skivuha/federal-compass-mcp (active, first published 2026-04-15 · 2 versions)
packages: npm:federal-compass-mcp

06 · Federal Compass MCP FAQ

Is Federal Compass MCP still maintained?

Yes - as of 2026-08-25, its last commit was 2026-08-19 and it shipped 1 release in the last 90 days. We re-verify nightly.

What can Federal Compass MCP do?

How do I install Federal Compass MCP?

Run `npx -y federal-compass-mcp`. The README documents 2 environment variables (USAJOBS_API_KEY, USAJOBS_EMAIL) to set first. Set USAJOBS_API_KEY, USAJOBS_EMAIL before connecting. You can also paste the ready-made client config above.

Does Federal Compass MCP run locally?

Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Federal Compass MCP

Alternatives to Federal Compass MCP

Maintained API integration servers if Federal Compass MCP isn't the fit.

More API integration MCP servers · OeBB (Austrian Railways) · Social Champ · Socialloop MCP · Openunfurl

More TypeScript MCP servers · Leclerc Drive · Cellar Tracker · Llmkit · Skillsmith · Govtoolspro MCP Server · see all