@career-now/mcp

Search 376k fresh tech jobs from your AI agent. Works with Claude Desktop, Claude Code, and Codex CLI via MCP.

Status: early. The npm package is not published yet. See career.now/byoa for status.

Quick start

npx @career-now/mcp init

That's it. The installer detects your AI clients, walks you through login (one browser tab), and writes the configs for you.

After install, ask your AI things like:

"Find me remote senior Rust jobs at startups in EU, posted in the last week"

"Show me the full description of job #2"

"How many searches do I have left today?"

Tools

The MCP server exposes:

• search_jobs(query, board?, remote_type?, seniority?, country?, limit?) — full-text + filtered search
• get_job(token) — full job detail with description, skills, salary
• list_boards() — available job boards with counts
• check_quota() — your current rate-limit status

Limits

Free tier (the only tier for now):

• 100 searches / day
• 500 job lookups / day
• Max 25 results per search
• Max 3 pages per query

Limits reset at midnight UTC.

Account

You need a free career.now account. init walks you through it via magic-link auth. No password.

To revoke a device or see your account: https://career.now/settings.

Manual setup

If you don't want to run the installer, see docs/manual-setup.md.

Development

npm install
npm run build
npm link
# Test locally:
npx @career-now/mcp init

Backend URL is configurable via env:

CAREERNOW_API_URL=http://localhost:3210/api/v1 npx @career-now/mcp init

License

MIT