Rank jobs against your verified skills, in your browser or through your agent

Browser is one posting you are reading. Agent is a shortlist for a role. Use Agent to find, Browser to check.

Overview

What it does

1. Plan. compass_plan takes the role you want. It returns the sources to read and a private folder for the downloads.
2. Find. Your agent checks in with Compass before each request, fetches public job feeds and company boards with its own tools, and saves them.
3. Score. compass_score cleans the postings (company names, links, duplicates, instructions aimed at applicants or AI agents removed) and scores them against your verified skills with the same matcher as Compass Browser. It writes the report.
4. Deep check. For the number of jobs you ask for, your agent reads each posting and Compass computes the deeper numbers on your device.
5. Finish. compass_finish finalises the report, shows what was sent to Pragmys and removes the download folder.

The report is an HTML file on your device: match %, required and preferred skills met, the line of the posting behind each match, a per-company table and a link to Qualify on Pragmys for the gaps that matter.

What it does not do

• It does not fetch job sites itself, log in anywhere, solve CAPTCHAs or apply to jobs. Your agent fetches public feeds; Compass governs the pace and the sources.
• Compass does not send Pragmys servers any posting text, and Pragmys does not fetch job sites on Compass’s behalf. Radar, a separate feature on pragmys.com, reads public employer career boards.
• It does not claim that using any source complies with that source’s terms. You are responsible for how you use it.
• It does not support LinkedIn, Naukri, Indeed, Glassdoor or Wellfound. Use Compass Browser on the page in front of you for those.

What you need

• A Pragmys account with skills verified on your profile. That is what jobs are ranked against.
• An agent app that supports local MCP servers and has web search and a shell (for example Claude Code, Cursor, Antigravity, VS Code with Copilot or Codex). A coding agent works best: chat apps such as Claude Desktop can produce file-access errors. Without web search and a shell the agent cannot fetch the feeds.
• Node.js 18 or later, so that npx can start Compass. Builds exist for macOS (Apple Silicon and Intel), Linux (x64 and arm64) and Windows (x64).

Get started

Install

Compass is one local MCP server. Add it to your agent app with the command npx -y @pragmys/compass@0.0.8. Pin the version, so nothing changes under you. Restart the app so the compass_* tools appear.

Compass works best in a coding agent. Chat apps such as Claude Desktop can produce file-access errors, because Compass saves feeds and the report to your computer.

claude mcp add pragmys-compass -- npx -y @pragmys/compass@0.0.8

{
  "mcpServers": {
    "pragmys-compass": {
      "command": "npx",
      "args": [
        "-y",
        "@pragmys/compass@0.0.8"
      ]
    }
  }
}

{
  "mcpServers": {
    "pragmys-compass": {
      "command": "npx",
      "args": [
        "-y",
        "@pragmys/compass@0.0.8"
      ]
    }
  }
}

{
  "servers": {
    "pragmys-compass": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@pragmys/compass@0.0.8"
      ]
    }
  }
}

[mcp_servers.pragmys-compass]
command = "npx"
args = ["-y", "@pragmys/compass@0.0.8"]

{
  "mcpServers": {
    "pragmys-compass": {
      "command": "npx",
      "args": [
        "-y",
        "@pragmys/compass@0.0.8"
      ]
    }
  }
}

First run

1. Add the server to your agent app (above) and restart the app so the compass_* tools appear.
2. Ask your agent for jobs, for example: “Find backend engineer jobs using Compass and analyse the top 5 in depth.” Give a location only if you want one judged.
3. The first time, the agent calls compass_login. Open the link it shows, sign in to Pragmys if asked, and approve the code at pragmys.com/cli-login. Approve only a code you generated yourself, just now.
4. The agent runs the search. When it finishes it gives you the path of the HTML report.

Example prompts

Ask your agent in plain words, and say Compass so it uses the tools.

Find backend engineer jobs using Compass and analyse the top 5 in depth.

Use Compass to find remote data engineer roles and rank them against my Pragmys skills.

Add the Greenhouse boards for Acme and Globex to my Compass list, then search for platform engineer roles.

Show me what Compass would send to Pragmys for this run.

Reference

Tools

Seventeen tools, in the order a run uses them. Your agent calls them; you rarely need to.

Sources and limits

Compass reads feeds and public job-board APIs only: RemoteOK, Jobicy and Arbeitnow, and the company boards on Greenhouse, Lever, Ashby and Workable. Some sources are on a blocklist and refused by every tool. compass_sites lists what is supported, what each needs, its terms link and the credit it requires.

At status and plan time Compass reads a small settings record from api.pragmys.com (cached for an hour; if the call fails the built-in rules apply). Pragmys can use it to switch Compass off, pause a source, block a host, lower the limits, switch the deep check off, require a minimum version and show a notice. It never raises a limit above the built-in value and carries nothing about you.

Configuration

Set the variables in the env of Compass’s entry in your agent app’s MCP settings, or in your shell before you start the app.

Compass Agent or Compass Browser

Both are Compass by Pragmys: same account, same verified skills, same scoring. Agent to find, Browser to check.

Trust

Privacy

• Your Pragmys token is stored in your OS keychain (or a file only you can read) and is sent only to the Pragmys API.
• Each run sends Pragmys one usage record: the role you searched, whether you gave a location and how many terms, how many deep checks you asked for, request, fetch, keep and drop counts per source, timings, and refusal and failure counts. It never contains posting text, links, company names, location terms, results, skills or scores.
• compass_usage_preview shows the exact record. Set COMPASS_USAGE=0 to send nothing.
• Postings stay on your device and with your own agent and its model provider, under their terms.
• Files Compass writes: the HTML report (in Downloads/Pragmys-Compass, or COMPASS_REPORT_DIR), a small state file and a company index in ~/.pragmys-compass/, and a temporary run folder that is removed when the run finishes.

You can ask for your Compass history to be shown or deleted at hello@pragmys.com.

Security

• Turn on tool approval in your agent app so you see each Compass call before it runs, and take care when you use Compass next to other MCP servers.
• Approve only a sign-in code you generated yourself, just now.
• Compass cleans postings and removes instructions aimed at applicants or AI agents.
• Compass never updates itself. Pin the version, and update when compass_status tells you a newer or security release exists.
• To report a security problem, email hello@pragmys.com. Please do not post it publicly. We aim to acknowledge within 2 business days.

Help

Troubleshooting

Updates, uninstall and cleanup

Pin the version in your config. compass_status tells you when a newer or a security release exists; Compass never updates itself. To update, change the version in your config and restart the app.

To remove Compass, delete the entry from your agent app’s MCP settings. To delete what it stored on your device:

rm -rf ~/.pragmys-compass
rm -f compass-reports/compass-report-*.html

To disconnect an agent from your account, sign in and revoke it under Connected agents on your profile (pragmys.com/profile#connected-agents).

Terms and takedown

• Compass is free to use with a Pragmys account. It is closed source and licensed under the Compass licence that ships in the package. Use is for your own job search on your own device.
• Do not use Compass to get around a block, a login, a CAPTCHA, a rate limit or any access control, and do not build a database of postings or redistribute their content.
• If you operate a site Compass supports and want it removed, email hello@pragmys.com with the domain and a way to verify you control it. We acknowledge within 2 business days and remove a verified site within 7 days.