---

The pitch

Every AI-powered job board says the same thing: "Upload your resume, we'll do the rest." Then they match you against 5%-fit jobs because their AI doesn't know you. Your conversations, your projects, your taste — all on your machine, where the AI you're already paying for can already see them.

So why hand all that to one more job board?

Crosswalk is an MCP server. Install it once into your AI client (Claude Desktop, Cursor, etc.). Your AI gains 16 new tools to find jobs, score fit, tailor resumes, draft applications, track your pipeline, and run scheduled workflows — using the model you already pay for, with your data on your machine.

What you say to your AI:                   What Crosswalk does behind the scenes:
─────────────────────────────────────────  ──────────────────────────────────────────
"Set up my profile from this description"   stores a structured profile in SQLite
"Add my resume from ~/Documents/cv.pdf"      parses + structures via your AI
"Find PM roles at H-1B sponsors"             hits 8 ATSs in parallel, ranks by H-1B
"Why am I a fit for the Stripe role?"        narrative explanation via your AI
"Draft an application for that job"          tailored resume + cover letter, persisted
"Mark it submitted"                          status update + event log
"Show me my pipeline"                        every application with company context
"Refresh job cache every Monday at 9am"      cron-driven workflow, runs without you

---

Quick start

npx crosswalk-mcp install

Restart Claude Desktop. Then say:

"Set up my profile: I'm a PM with 2 years at Acme, want NYC or remote, looking at AI infra." "Add my resume from ~/Documents/resume.pdf, label it 'Generic PM'." "Find PM roles at H-1B sponsors with 0.8+ confidence." "Why am I a fit for the Stripe Payments PM role?" "Tailor my resume for that role and give me the DOCX." "Draft an application for it."

That's it. No signup. No API keys. Your data stays in ~/.crosswalk/.

---

What it does

16 MCP tools across 5 surfaces. v0.4.0 adds the live-fit guardrail gate to draft_application and the crosswalk-mcp uninstall + crosswalk-mcp status CLI subcommands.

Profile & resumes

Tool	What it does
setup_profile	Store a structured profile from a free-form description.
add_resume	Parse and store a labeled resume version (DOCX/PDF/text). Multiple resumes supported.
list_resumes	List stored resume versions.

Discovery & matching

Tool	What it does
fetch_jobs	Pull live roles from 8 ATSs. Filter by title, location, recency, H-1B sponsor confidence, comp range.
score_fit	Numeric 0–1 fit score plus structured strengths and gaps.
explain_fit	Markdown narrative — why you're a fit, where you're weak, how to position.

Authoring

Tool	What it does
tailor_resume	Edits your best base resume for a specific JD. Returns markdown by default; optional DOCX (base64) or print-ready HTML on request.
draft_application	Builds a complete "application PR": tailored resume + cover letter + deep link, persisted. Anti-spam guardrail enforces a weekly cap, refuses obvious duplicates, and refuses drafts where cached fit < 0.50 (override with confirmLowFit: true).

Pipeline tracker

Tool	What it does
submit_application	Mark an application submitted (after you click Apply in your browser). Stamps the timestamp, logs an event.
set_status	Change status: `draft → submitted → interviewing → rejected
add_note	Append a free-text note to an application's event log ("recruiter emailed back").
list_pipeline	List all applications with company + job context. Filter by status.

Scheduling

Tool	What it does
schedule_workflow	Schedule a recurring non-sampling workflow (job-cache refresh, old-job pruning) via cron expression.
run_workflow	Manually run a scheduled workflow now.
list_workflows	List all scheduled workflows with their last-run status.
delete_workflow	Delete a scheduled workflow by id.

---

ATS coverage

Crosswalk fetches live jobs from 8 ATSs, covering 51 seed companies. Each adapter is a small file in src/ats/ — adding more is a one-PR change.

ATS	Endpoint type	Seed coverage
Greenhouse	JSON	Stripe, Airbnb, Anthropic, Vercel, Figma, Linear, DoorDash, Robinhood, Coinbase, Datadog, Snowflake, +4 more
Lever	JSON	Netflix, Spotify, Shopify, Brex, Lyft, GitHub, Checkr, Kraken
Ashby	JSON	OpenAI, Ramp, Hex, Deel, Notion, Browserbase, Modal Labs
Workable	JSON	Miro, n8n, Remote.com, Deepfence
SmartRecruiters	JSON	Bosch, Siemens, Ubisoft, OpenText
BambooHR	JSON	Klaviyo, Buffer, Zapier, Tinybird
Recruitee	JSON	Mollie, MessageBird, HelloFresh, The Trade Desk
Personio	XML	Personio, Clue, Trade Republic, Scalable Capital

Want to add your favorite company? Send a PR to registry/companies.json — the registry is MIT-licensed.

Workday and iCIMS aren't supported yet. They don't expose public JSON endpoints; both need a Playwright-sandbox scraping framework, planned for M5.

---

Why it's different

1. Zero API keys

Every LLM call (resume parsing, fit scoring, tailoring, cover letters) runs through MCP sampling — a callback into your AI client's model. Crosswalk has no provider SDK, no OPENAI_API_KEY, no AI bill, no rate limits beyond your own plan's.

When jobos.us tailors your resume, they pay Gemini and bill you $19/month. When Crosswalk tailors your resume, your existing Claude/GPT/whatever subscription does the work and Crosswalk costs $0 to run.

2. Local-first

Profile, resumes, cached jobs, applications, notes, scheduled workflows — all in ~/.crosswalk/state.db. SQLite. Your machine. No signup. No cloud. git-friendly.

cd ~/.crosswalk && git init && git add -A && git commit -m "snapshot before fall recruiting"

3. The Open Job Graph

The company → ATS registry is a checked-in JSON file. 51 companies at v0.3, on a path to 200+ via community PRs. You can extend it, fork it, and other tools can use it as infrastructure.

4. Anti-spam by design

Crosswalk refuses to draft an 11th application in 7 days. It refuses duplicate applications. The user can override, but has to ask. We're the only job tool that tells you to apply less.

5. Applications-as-PRs

Each application is a reviewable artifact: tailored resume + cover letter + answer pack + deep link, persisted with a status (draft → submitted → interviewing → rejected | offer) and an event log. You review and edit before submitting. The tracker is a git-like log of these.

6. Scheduled background workflows

Add one line to your crontab and Crosswalk refreshes your job cache every Monday at 9 AM, prunes stale listings nightly, etc. — without the AI host needing to be open.

* * * * * /usr/local/bin/crosswalk-mcp run-scheduled >> ~/.crosswalk/scheduler.log 2>&1

---

Scheduled workflows

Crosswalk can run non-sampling workflows (job cache refresh, old-job pruning) on a schedule. These don't need the AI host to be running — Crosswalk pokes the ATS APIs directly.

Schedule one in chat:

"Schedule a workflow to refresh PM jobs every Monday at 9 AM."

Then add a single line to your crontab:

* * * * * /usr/local/bin/crosswalk-mcp run-scheduled >> ~/.crosswalk/scheduler.log 2>&1

Every minute, any due workflow runs. Long workflows are safe — Crosswalk uses an atomic claim pattern in SQLite so overlapping cron invocations don't double-run.

Sampling-driven workflows ("tailor the top 3 fits") are an M5+ feature — they need a live AI host connection.

---

Privacy

• One file: ~/.crosswalk/state.db. SQLite. Your machine.
• No telemetry. No phone-home. No analytics.
• ATS API calls go directly from your machine to the ATS (Greenhouse, Lever, etc.). No proxy.
• LLM calls go through your AI host (Claude Desktop, Cursor) to its provider. Crosswalk never sees a token of API key.
• Removing Crosswalk: rm -rf ~/.crosswalk and remove the entry from claude_desktop_config.json.

---

Roadmap

Version	Theme	Status
v0.0.1 — M1	Discover + match + explain · 6 tools · 3 ATSs · 42 tests	Shipped
v0.1.0 — M2	Tailor resume + draft application · 8 tools · 68 tests	Shipped
v0.2.0 — M3	Pipeline tracker + anti-spam guardrail + scheduled workflows · 16 tools · 110 tests	Shipped
v0.3.0 — M4	5 more ATS adapters (8 total) · 51-company registry · M3 carry-overs · 124 tests	Shipped
v0.4.0 — M5	Live-fit guardrail gate · uninstall + status CLI · 74-company registry · 146 tests	Current
v0.5.0 — M6	Workday + iCIMS via Playwright sandbox · Cursor/Windsurf installers · registry to 200+	Next
v1.0.0 — v2	Autonomous apply via Playwright in a sandbox · full agent loop	Planned

See docs/superpowers/plans/ for the full TDD-ordered implementation plans for each milestone.

---

Architecture

A high-level diagram lives in docs/ARCHITECTURE.md. Short version:

• src/server.ts boots the MCP server, opens SQLite, registers 16 tools and 2 resources.
• src/tools/ — one file per MCP tool, each with a zod input schema.
• src/services/ — pure business logic (resume picker, tailorer, cover-letter drafter, guardrail, workflow engine). Doesn't know about MCP.
• src/ats/ — 8 self-registering adapters, all conforming to the ATSAdapter interface.
• src/store/ — typed SQLite CRUD across 7 tables.
• src/sampling/client.ts — wraps MCP createMessage with retry + JSON-mode.
• src/exporters/ — markdown → DOCX / print-styled HTML.

See the full architecture document for component-by-component breakdown, data model, tool surface, and design rationale.

---

Requirements

• Node 24 LTS (Node 22+ probably works but isn't tested)
• An MCP host that supports sampling — primarily Claude Desktop. Cursor and Windsurf have partial support; ChatGPT MCP doesn't ship sampling yet.

---

Development

git clone https://github.com/Mohakgarg5/crosswalk-mcp.git
cd crosswalk-mcp
npm install
npm test           # 124 tests
npm run lint       # tsc --noEmit
npm run dev        # run the MCP server over stdio
npm run build      # bundle dist/server.js + dist/cli.js

The full development guide — including how to add a new ATS adapter, how to add a new MCP tool, and how the test fixtures work — lives in docs/ARCHITECTURE.md.

---

Contributing

The fastest contribution path:

1. Add a company to the Open Job Graph. Find the company's ATS, get their slug, send a one-line PR to registry/companies.json.
2. File an issue if an ATS adapter mis-parses a field on a real org you care about. Include the org slug.
3. Send a PR for new ATS adapters — the framework lives at src/ats/adapter.ts and existing adapters like src/ats/greenhouse.ts are good templates.

For larger changes, see the implementation plans at docs/superpowers/plans/ for the project's working style (TDD, small PRs, frequent commits).

---

Credits

• Inspired by jd-intel — the LinkedIn-post MCP that proved the "fetch jobs from your AI" hook works.
• The H-1B confidence dataset is derived from the publicly-published USCIS H-1B Employer Data Hub (FY2025).
• Built with Claude Code (Opus 4.7, 1M context). Every commit is co-authored by the model that wrote it.

---

License

MIT © 2026 Mohak Garg