Agents Index

Refine Job Search

Online

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

Visit publisherConnectJSON

What it can do: 62 tools

  • jobs.list read-onlyList jobs in your journey
  • jobs.get read-onlyGet details of a specific job
  • jobs.addAdd a new job to your journey
  • jobs.updateUpdate a job in your journey
  • jobs.deletePermanently 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.refreshQueue a job posting to be re-scraped. The returned job may remain pending; use jobs.get later to inspect the refreshed state.
  • jobs.mark_appliedMark a job as applied
  • jobs.archiveHide a job from the active board without recording a rejection or closing the application
  • jobs.unarchiveRestore an archived job to the active board
  • jobs.interviews.addLog an interview for a job
  • jobs.interviews.updateUpdate an existing interview
  • jobs.interviews.deletePermanently delete an interview from a job. Confirm with the user first; it cannot be undone.
  • jobs.offer.createRecord a job offer with compensation details
  • jobs.offer.updateUpdate the offer recorded for a job
  • jobs.offer.deletePermanently 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.acceptAccept 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.declineDecline the offer for a job, a major state change; confirm with the user first. It does not email the employer.
  • jobs.offer.add_negotiationLog a negotiation event on an offer (counter-offer, update, etc.)
  • jobs.offer.delete_negotiationRemove a negotiation event from an offer
  • following.list read-onlyList all followed companies, their filters, state, and unread counts. Returns the full list without pagination. Following delivers future matching openings; use Search to browse jobs already in the index.
  • following.followFollow an indexed company for future matching openings and company recommendations. Get company_id from Search, a ready submission, or a recommendation candidate_company.id. Specify at least one match; [{}] follows all n
  • following.updateReplace all match filters for a followed company. Other follow settings are unchanged. Pass [{}] for all new openings. Pending means the new filters are being applied; old unread counts may change.
  • following.unfollowUnfollow a company and remove its Following feed and recommendation source. Confirm with the user first. Board jobs remain. To pause temporarily instead, use following.pause.
  • following.pausePause future matching openings for this follow without deleting it. This does not stop shared company indexing or pause other follows.
  • following.resumeResume a paused company follow.
  • following.openings.list read-onlyRead matching openings from followed companies. tab defaults to unread. Use the row id for marking read and nested opening.id for opening details or adding to the board. meta.unread_count/read_count cover the selected fo
  • following.openings.mark_readMark one Following row as read. Use the row id from following.openings.list, not nested opening.id.
  • following.openings.mark_all_readMark all unread openings as read for one follow, or every followed company if follow_id is omitted. Includes every page and openings hidden by view filters. Confirm the scope with the user first. The API returns no affec
  • following.digest.get read-onlyRead the user-wide Following email digest schedule. data is null if no schedule is configured. Company match filters are managed separately with following.update.
  • following.digest.updateSet the user-wide Following email digest schedule after the user requests it. Requires Plus or Student. For a new schedule supply frequency, hour (0–23), timezone (IANA), and weekday (Sunday=0) when weekly. Existing sche
  • companies.submissions.createSubmit a missing company using its public HTTPS careers URL, supplied or confirmed by the user. Refine detects supported sources and processes openings asynchronously. This adds to the shared index, not to Following. Use
  • companies.submissions.get read-onlyRead company submission progress. queued/detecting/processing means wait; ready means search again using the company name. unsupported means the careers source is not supported; failed means processing failed. Do not cla
  • openings.get read-onlyRead an indexed opening, including its full description and qualifications. Use opening.id from Search or Following, not a follow-opening row ID.
  • openings.add_to_boardAdd an indexed opening to the board after the user chooses it. Uses opening.id, not the Following row ID. Returns the existing board job if already added. This does not apply to the employer or send email; it also marks
  • search.createSearch indexed jobs or companies. Supply input OR query, not both. Natural-language searches return a search ID and processing state: use search.get later, without rapid polling. Keep the ID to paginate or update this sa
  • search.get read-onlyRead a search and its results, switch jobs/companies view, or fetch results.next_page. Pending/interpreting/processing means it is still working: do not create another search or poll rapidly. If missing_company_name is s
  • search.updateUpdate the existing search instead of creating another. Supply input OR the complete replacement query; omitted filters are cleared. Wait until the current search is ready or failed before updating it.
  • search.company_openings read-onlyRead all matching jobs for a company in a ready search, not just its three preview jobs. Continue with data.next_page until null. Use company.id from the search results.
  • inbox.list read-onlyList email conversations Refine matched to your job search (applications, interviews, recruiter outreach)
  • inbox.get read-onlyGet one inbox item with its related job and application

…and 22 more.

Connect it

Claude Code
claude mcp add --transport http refine-job-search https://mcp.getrefine.co/mcp
Claude.ai / ChatGPT
Settings → Connectors → Add custom connector
URL: https://mcp.getrefine.co/mcp
Cursor (~/.cursor/mcp.json)
{
  "mcpServers": {
    "refine-job-search": {
      "url": "https://mcp.getrefine.co/mcp"
    }
  }
}
VS Code (.vscode/mcp.json)
{
  "servers": {
    "refine-job-search": {
      "type": "http",
      "url": "https://mcp.getrefine.co/mcp"
    }
  }
}

Questions

What does Refine Job Search do?

Job search management: applications, interviews, offers, recruiter email, and company openings. It exposes 62 tools to AI assistants.

What tools does Refine Job Search provide?

62 tools, including jobs.list, jobs.get, jobs.add, jobs.update, jobs.delete, jobs.refresh, jobs.mark_applied, jobs.archive, jobs.unarchive, jobs.interviews.add, jobs.interviews.update, jobs.interviews.delete….

How do I connect Refine Job Search to Claude, ChatGPT or Cursor?

Add the remote MCP endpoint https://mcp.getrefine.co/mcp as a custom connector or MCP server. Copy-paste setup is on this page.

Does Refine Job Search require an account or API key?

No sign-in was needed to list its tools. Individual tools may still need an account or API key.

Is Refine Job Search online?

As of 2026-11-19 our probe found it online. It answered 100% of our last 3 checks.

Who publishes Refine Job Search?

getrefine.co. The official MCP Registry verified that the publisher controls this domain before accepting the listing.

Similar in HR & Recruiting