Refine Job Search MCP Server

by getrefine Your server? Claim it

answering

Refine Job Search is answering right now. Last checked 5 min ago. It exposes 55 tools.

Job search management: applications, interviews, offers, recruiter email, and company openings.

Uptime history 55 days of history · worst day 88%

55 days agonow

100.0%

Uptime 24h

92 of 92 checks

Tools

read from the server

247 ms

Response time

average over 24h

open, no key

Access

streamable-http

What changed 77

Every tool that appeared, vanished or quietly changed what it asks for. Recorded since 24 August 2026. No other catalogue keeps this.

26 Aug 31 tools disappeared inbox.accept, inbox.status, interviews.add and 28 more

26 Aug 24 tools appeared inbox.apply_suggestion, inbox.sync_status, jobs.interviews.add and 21 more

26 Aug 12 tools changed the parameters they ask for inbox.acknowledge, inbox.decline, inbox.dismiss and 9 more

26 Aug 6 tool descriptions were rewritten inbox.acknowledge, inbox.undo, integrations.connect_google and 3 more

26 Aug a tool changed version3 times that day

24 Aug a tool changed version

and 2 more, back to 24 August 2026

Tools have disappeared from this server

A tool that vanishes takes a piece of your agent with it, and the change arrives silently. Watch this server and every such change lands in your inbox.

Connect this server

Endpoint below is the one we actually reach during checks — not the one copied from a README. Last verified 5 min ago.

Claude Code Claude Desktop Codex Cursor VS Code

run in your terminal

claude mcp add refine --transport http https://mcp.getrefine.co/mcp

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "refine": {
      "url": "https://mcp.getrefine.co/mcp"
    }
  }
}

~/.codex/config.toml

[mcp_servers.refine]
url = "https://mcp.getrefine.co/mcp"

.cursor/mcp.json

{
  "mcpServers": {
    "refine": {
      "url": "https://mcp.getrefine.co/mcp"
    }
  }
}

.vscode/mcp.json

{
  "mcpServers": {
    "refine": {
      "url": "https://mcp.getrefine.co/mcp"
    }
  }
}

Available tools 55

Read directly from the server with tools/list, grouped by what they act on. If a tool disappears, we record the date.

jobs

jobs.add

Add a new job to your journey

jobs.archive

Hide a job from the active board without recording a rejection or closing the application

jobs.delete

Permanently delete a job and its application from the board. Confirm with the user first; it cannot be undone. To hide a job without recording a rejection or closure, use jobs.archive instead.

jobs.get

Get details of a specific job

jobs.interviews.add

Log an interview for a job

jobs.interviews.delete

Permanently delete an interview from a job. Confirm with the user first; it cannot be undone.

jobs.interviews.update

Update an existing interview

jobs.list

List jobs in your journey

jobs.mark_applied

Mark a job as applied

jobs.offer.accept

Accept the offer for a job. This is a major state change that closes out the search for this role; confirm with the user before calling. It does not email the employer.

jobs.offer.add_negotiation

Log a negotiation event on an offer (counter-offer, update, etc.)

jobs.offer.create

Record a job offer with compensation details

jobs.offer.decline

Decline the offer for a job, a major state change; confirm with the user first. It does not email the employer.

jobs.offer.delete

Permanently delete the offer recorded for a job (the job stays). Use only to fix a mistake, and confirm with the user first; it cannot be undone.

jobs.offer.delete_negotiation

Remove a negotiation event from an offer

jobs.offer.update

Update the offer recorded for a job

jobs.refresh

Queue a job posting to be re-scraped. The returned job may remain pending; use jobs.get later to inspect the refreshed state.

jobs.unarchive

Restore an archived job to the active board

jobs.update

Update a job in your journey

signals

signals.list

List companies you are tracking

signals.list_applied_jobs

List jobs in your journey that came from a tracked company

signals.openings.list

List signal notifications (new openings at tracked companies)

signals.openings.mark_all_read

Mark every unread opening notification as read after the user confirms the bulk action

signals.openings.mark_read

Mark one opening notification returned by signals.openings.list as read

signals.openings.save

Save a matched opening returned by signals.openings.list to your job journey

signals.pause

Pause tracking for a company

signals.recommendations.block

Dismiss a recommended company and block it from future recommendations

signals.recommendations.dismiss

Dismiss a recommended company

signals.recommendations.feedback

Record why a recommendation was or was not a fit; this sharpens future recommendations and the persona

signals.recommendations.get

Get one recommended company with sources and persona fit

signals.recommendations.list

List companies recommended from one company you track. Get signal_id from signals.list.

signals.recommendations.restore

Restore a dismissed or blocked recommendation

signals.recommendations.watch

Start tracking a recommended company (converts it into a signal)

signals.resume

Resume tracking for a company

signals.track

Start tracking a company for new job openings

signals.untrack

Stop tracking a company and delete its signal. Confirm with the user first; they stop getting new openings from it. To stop notifications temporarily instead, use signals.pause.

signals.update

Update filters on a tracked company

inbox

inbox.acknowledge

Keep auto-applied inbox items as-is and finalize the automatic action. Confirm the specific items with the user first.

inbox.apply_suggestion

Apply an inbox item's suggested action, such as adding an application to the board or recording a rejection. Confirm the specific action with the user first.

inbox.decline

Queue decline replies to recruiter outreach. Depending on the user's preference this SENDS email from their address. Only call after the user explicitly approved declining these specific conversations.

inbox.dismiss

Dismiss inbox items you are not acting on (also marks the mail read in Gmail)

inbox.draft_reply

Generate an AI reply draft for an inbox item. Returns HTML for review; it does not send anything.

inbox.get

Get one inbox item with its related job and application

inbox.get_thread

Fetch the full email thread for an inbox item

inbox.list

List email conversations Refine matched to your job search (applications, interviews, recruiter outreach)

inbox.mark_read

Clear an inbox item's unread-reply flag

inbox.refresh

Check Gmail for new mail now; returns per-account sync status

inbox.send_reply

Send an email reply through the user's Gmail. This emails a real person from the user's address. Only call after the user has seen the exact message body and explicitly approved sending it.

inbox.sync_status

Per-account Gmail synchronization status, including current progress and last sync time

inbox.undo

Undo an auto-applied inbox action. This can delete a board record that the automatic action created, so confirm with the user first.

inbox.unsubscribe

Unsubscribe the user from this sender's mailing list via one-click list-unsubscribe. This changes the user's real email subscriptions; confirm with them before calling. Use it for unwanted bulk senders, not for a person you can simply decline.

integrations

integrations.connect_google

Get a link for the user to connect Gmail to Refine or approve a missing Gmail permission. Refine selects the permission needed for the connected account. The connection happens in the browser with no Refine sign-in required. Share the link only with the owner of this Refine account.

integrations.list

List connected Google accounts and their grant status. To connect a new account, use integrations.connect_google.

account

account.agenda

Get upcoming interviews and action items

persona

persona.get

Get the user's persona: inferred job-search preferences and traits with an understanding score. Use it to tailor advice and searches.

Tools removed

Tools this server used to expose. Anything built against them stopped working on the day they went.

inbox.accept

removed 26 Aug 2026

inbox.status

removed 26 Aug 2026

interviews.add

removed 26 Aug 2026

interviews.delete

removed 26 Aug 2026

interviews.list

removed 26 Aug 2026

interviews.update

removed 26 Aug 2026

jobs.update_notes

removed 26 Aug 2026

notifications.list

removed 26 Aug 2026

notifications.read

removed 26 Aug 2026

notifications.read_all

removed 26 Aug 2026

offers.accept

removed 26 Aug 2026

offers.add_negotiation

removed 26 Aug 2026

offers.create

removed 26 Aug 2026

offers.decline

removed 26 Aug 2026

offers.delete

removed 26 Aug 2026

offers.delete_negotiation

removed 26 Aug 2026

offers.get

removed 26 Aug 2026

offers.update

removed 26 Aug 2026

persona.confirm_trait

removed 26 Aug 2026

persona.correct_trait

removed 26 Aug 2026

persona.remove_trait

removed 26 Aug 2026

recommendations.block

removed 26 Aug 2026

recommendations.dismiss

removed 26 Aug 2026

recommendations.feedback

removed 26 Aug 2026

recommendations.get

removed 26 Aug 2026

recommendations.list

removed 26 Aug 2026

recommendations.restore

removed 26 Aug 2026

recommendations.watch

removed 26 Aug 2026

signals.save_opening

removed 26 Aug 2026

journey.get

removed 26 Aug 2026

journey.update

removed 26 Aug 2026

Endpoints

URL	Transport	State	Latency	Checked
https://mcp.getrefine.co/mcp	streamable-http	answering	250 ms	5 min ago

Alternatives to Refine Job Search

same job, measured the same way

RecruitMCP

by recruitmcp

Search people and companies, enrich profiles, and find email and phone over MCP.

answering

Company and Lead Research

by gptshopltd

Emails and socials from company sites, WHOIS, live job listings, Hacker News and App Store search.

answering

Outlook

by mcp-z

Outlook integration with OAuth, message search, batch operations, and calendar management

464 installs/wk local only

Apple Mail

by jonathanrreed

Read, search, compose, and send emails via Apple Mail on macOS.

1 560 installs/wk local only

CommSync

by commsync

One inbox for SMS and email: read threads, search, manage contacts, and send texts and emails.

answering

Gmail

by mcp-z

Gmail integration with OAuth authentication, message search, batch operations, and Sheets export

2 390 installs/wk local only

Banger

by bangermail

All your company email, operated by agents and reviewed by you.

answering

Siftsmith Company Signals

by siftsmith

Open jobs from a company's ATS, plus hiring, tech stack, intent, email-security and launch signals.

answering

Refine Job Search — questions

Answers built from our own checks of this server.

What can Refine Job Search do?

It exposes 55 tools, read directly from the server on our last check. Among them: account.agenda, inbox.acknowledge, inbox.apply_suggestion, inbox.decline, inbox.dismiss, inbox.draft_reply and 49 more. The full list with descriptions is on this page — we take it from the server itself via tools/list, not from a README. How MCP servers expose tools in the first place →

What is Refine Job Search mostly used for?

Its tools cluster around jobs, signals and inbox. That is what this server is built to work with — the grouping comes from the actual tool names, not from a category we assigned.

Is Refine Job Search working right now?

We send a real MCP handshake every 15 minutes. Over the last 24 hours 92 of 92 checks got a reply (100.0%), average response time 247 ms. The bar chart above shows every period we have measured.

Did Refine Job Search ever remove tools?

Yes. inbox.accept, inbox.status, interviews.add, interviews.delete and 27 more are no longer exposed — we recorded the date each one disappeared. A tool vanishing usually means a breaking change for anything that depended on it.

How do I connect Refine Job Search?

Copy the ready config from this page — we generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each with the file path that client actually reads. It is a remote server, so there is nothing to install — the client connects to the address.

Does Refine Job Search need an API key?

No. Refine Job Search completed a full MCP handshake with us as an anonymous client and listed its tools without asking for anything. All 55 of them are readable on this page. This is what we observed, not what the docs claim.

How fast is Refine Job Search?

It answers our handshake in 247 ms on average, which is faster than 52% of all working MCP servers we measure. The comparison comes from our own checks across the whole registry, every 15 minutes.