Setup
Works with any MCP-aware AI client: Claude Desktop, Claude Code, Cursor, Windsurf, VS Code. ChatGPT, Gemini, and other non-MCP clients are not supported yet, since they use different tool-calling systems.
Claude Desktop
RecommendedThe simplest path. No terminal, no Node.js. Claude Desktop runs the server on its own bundled runtime.
Download the jd-intel extension, a .mcpb file.
In Settings, open Extensions, then Advanced settings, and click Install Extension. Pick the file you downloaded.
Review the access summary, click Install, then start a new chat. The tools appear automatically.
The extension is open source and unsigned, so Claude Desktop shows an "unverified" notice. Choose Install Anyway.
Prefer the command line?
You will need Node.js 18 or newer first. Then run:
npx jd-intel-mcp install
Quit and reopen Claude Desktop. The tools appear automatically.
Claude Code, Cursor, Windsurf, VS Code
These run the same server and need Node.js 18+. Only the wrapper differs.
- Claude Code: run claude mcp add jd-intel -- npx -y jd-intel-mcp
- Cursor: add it under mcpServers in Settings, Tools and MCP.
- Windsurf: Settings, Tools, Add Server.
- VS Code: add it under servers with type stdio in .vscode/mcp.json.
{
"mcpServers": {
"jd-intel": {
"command": "npx",
"args": ["-y", "jd-intel-mcp"]
}
}
}
Confirm it works
Start a new chat and ask: "What fintech companies are in your jd-intel registry?" If it lists companies, you are set. Then try the real thing: "Find senior PM roles open right now that I would be a fit for."
Using it
jd-intel fetches. Your AI thinks. Ask in plain language and your assistant calls the tools, then reasons over the results with everything it already knows about you.
Things to ask
The tools your AI calls
Filtering
Filters narrow what comes back, and they AND together.
- title matches the job title only.
- topic matches title, department, and description.
- posted within days recency cuts.
- location include / exclude region targeting.
- limit cap the number of results.
What you get back
Every job normalizes to one consistent schema across every platform. This part is for your AI to read, not for you.
How those roles come back to you is a separate thing entirely: a quick list, a side-by-side comparison, a shortlist with fit notes. That is up to the assistant and what you asked for.
{
"company": "Example Co",
"title": "Senior Software Engineer, Platform",
"department": "Engineering",
"location": "Remote - US",
"locationType": "remote",
"salary": { "min": 180000, "max": 240000, "currency": "USD" },
"url": "https://boards.example.com/jobs/12345",
"postedAt": "2026-04-10T14:30:00Z"
}
Troubleshooting
Tools not appearing?
Fully quit and reopen the client, do not just close the window. For npx clients, run npx clear-npx-cache then restart. Confirm node --version is 18 or newer for the npx paths.
"Unverified" warning at install
Expected. The extension is open source and unsigned, so Claude Desktop flags it. Choose Install Anyway. The source is on GitHub if you want to read it first.
Am I current?
Every result includes the running version in its metadata, so you can ask your AI which version it is on. The registry refreshes on its own at startup, so new companies show up without reinstalling.
Updating
The one-click extension does not auto-update: download the latest .mcpb and install over it. The npx path updates on its own, running the published version each restart.
Uninstalling
Extension: remove it under Settings, then Extensions. Command-line install: run npx jd-intel-mcp uninstall, then restart Claude Desktop.