If you spend most of your day in Claude Code, Cursor or Codex, a job search is one more set of tabs: careers pages, a spreadsheet, an inbox, a calendar. This post shows how to run that search from the assistant you already have open, using Refine's hosted MCP server.
Refine is a job-search workspace. You follow companies with filters, new matching roles show up as they're posted, and every role you care about sits on a board from saved to offer. The MCP server exposes all of that as tools your assistant can call.
What you get
Once it's connected, your assistant can:
- Search roles from companies' own careers pages (Greenhouse, Lever, Ashby, Workday, SmartRecruiters and others).
- Follow companies with filters for role, seniority, location, remote work and pay. Refine checks each company's listings about once a day and matches new roles hourly.
- Save roles and track them from saved to applied, interviewing and offer, with notes, interview details and offer terms.
- Work with recruiter email (Refine Plus, after you connect Gmail separately in the browser): summarize threads and draft replies. Refine's tools are built so the assistant shows you the exact message and asks before sending anything.
The data lives in your Refine account, not the chat. So when you open a new session tomorrow, or switch from Cursor to Claude Code, your search is still where you left it, and you can see it all at getrefine.co.
Setup
The server is hosted, so there's nothing to install or run locally. The first time you use it, a browser window opens to sign in to Refine (OAuth) and approve access. No API keys go in your config.
Server address: https://mcp.getrefine.co/mcp
Claude Code
claude mcp add --transport http refine https://mcp.getrefine.co/mcp
Then run /mcp in Claude Code, select refine and sign in.
Cursor
Add this to ~/.cursor/mcp.json (or .cursor/mcp.json in a project):
{
"mcpServers": {
"refine": {
"url": "https://mcp.getrefine.co/mcp"
}
}
}
Codex
Add this to ~/.codex/config.toml:
[mcp_servers.refine]
url = "https://mcp.getrefine.co/mcp"
Then sign in:
codex mcp login refine
VS Code
Open the command palette, run MCP: Add Server, choose HTTP, and paste the address above.
Gemini CLI
gemini mcp add --transport http refine https://mcp.getrefine.co/mcp
Run /mcp auth refine if it asks you to sign in.
Claude Desktop and claude.ai
Go to Settings → Connectors, add a custom connector with the address above, and connect. Custom connectors depend on your Claude plan.
Prompts to try
Start with the companies you'd actually want to work for:
Follow Linear, Vercel and Notion for senior frontend roles, remote or New York.
What new openings matched the companies I follow this week? Save the two that fit best.
Then use it to keep your process up to date between other work:
Mark the Datadog role as applied today and add a note: referred by Sam.
Add a 45-minute technical interview for the Figma role next Tuesday at 2pm.
Show my upcoming interviews and anything I owe a reply on.
And when an interview is coming up:
Prepare me for my next interview using what's saved for that role.
A couple of habits worth keeping
- Ask for drafts, not sends. Even with confirmation built in, "draft replies, but don't send them" is the safest way to work with email from any assistant.
- Keep follows specific. A follow with a role and location filter gives you a handful of relevant roles a week instead of every posting at a large company.
- Check the board now and then. Everything the assistant saves is visible and editable at getrefine.co, so it's easy to catch a role it filed in the wrong stage.
Before you connect any job-search tool
The same checklist applies to Refine and to anything else you plug into your assistant:
- Does it sign in through the browser (OAuth), or does it want a key or password pasted somewhere?
- What can it access: jobs, email, calendar?
- Can it send email, and does it ask first?
- Where is your data kept? Read the privacy policy.
- How do you disconnect it, both from the assistant and from the tool?
Cost
Search, following companies and the application board are on Refine's Free plan. Connected inboxes and email alerts for new matches are part of Plus ($14.99/month, first 30 days free). Students get Plus for $4.99/month with a .edu email.
More
- Setup for every assistant, plus non-developer instructions: How to use your AI assistant for your job search
- Skills and plugin bundles for Claude Code, Codex, Cursor and Gemini CLI: github.com/the-tearoom/refine-plugins
- Start free: getrefine.co
Top comments (0)