Refine Job Search
REMOTE · MCP.GETREFINE.CO
Job search management: applications, interviews, offers, recruiter email, and company openings.
Available components
Last scanned (6 hours ago)
Scores higher than 91% of remote servers
Reachable. Last reached 5 Nov 2026.
Category Project Management
How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. How we score → Why this is hard to score →
Endpoint Security81
- The endpoint's TLS certificate is valid, in date, and uses a strong key. View diagnostics → Pass
- Authorisation is enforced on tool calls, advertised via RFC 9728 protected-resource metadata. Discovery is public, which costs nothing: no tool can be invoked without a token. View diagnostics → Pass
- HTTPS enforcement could not be verified: the plaintext port answered with HTTP 401, which proves neither a plaintext path nor enforcement. View diagnostics → Unverified
- HSTS check failed: the Strict-Transport-Security header is absent. See how to fix → View diagnostics → Fail
- DNSSEC check failed: this domain isn't protected by DNSSEC. See how to fix → View diagnostics → Fail
- The authorisation server supports Client ID Metadata Documents, the current MCP client-registration mechanism. View diagnostics → Pass
Transport & Reachability100
- Verified streamable-http transport via a live MCP handshake. View diagnostics → Pass
Schema Quality & AI Usability85
- 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).Pass
- AI-judged instruction clarity (good).Pass
- Tool/resource definitions use about 4811 tokens (~72/item across 66 items; 62 tools + 4 resources), lean.Pass
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management67
- Stability check failed: schema churn in the 30 days we've observed: 18 tool removals, 0 breaking changes, 0 auth/transport breaks, 25 additions. See how to fix → Fail
Tool Coverage96
- 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
- 86% of tool parameters carry a description.Partial
- Structured output schemas are declared (100% of tools); any adoption earns full credit.Pass
Tool Safety100
- No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
- All 5 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation.Pass
- An AI judge read all 63 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities100
- Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 22 Oct 26 −5
- Stability: pass → fail ▼ security
- Tool “signals.list” was removed ▼ security
- Tool “signals.list_applied_jobs” was removed ▼ security
- Tool “signals.openings.list” was removed ▼ security
- Tool “signals.openings.mark_all_read” was removed ▼ security
- Tool “signals.openings.mark_read” was removed ▼ security
- Tool “signals.openings.save” was removed ▼ security
- Tool “signals.pause” was removed ▼ security
- Tool “signals.recommendations.block” was removed ▼ security
- Tool “signals.recommendations.dismiss” was removed ▼ security
- Tool “signals.recommendations.feedback” was removed ▼ security
- Tool “signals.recommendations.get” was removed ▼ security
- Tool “signals.recommendations.list” was removed ▼ security
- Tool “signals.recommendations.restore” was removed ▼ security
- Tool “signals.recommendations.watch” was removed ▼ security
- Tool “signals.resume” was removed ▼ security
- Tool “signals.track” was removed ▼ security
- Tool “signals.untrack” was removed ▼ security
- Tool “signals.update” was removed ▼ security
- New tool “following.unfollow”, which the server declares destructive security
- Tool coverage: 100% → 86% ▼ functional
- Schema quality: 4003 → 4811 ▼ functional
- Schema quality: excellent → good functional
- Server version: 0.5.2 → 0.6.0 functional
- New tool “companies.submissions.create” functional
- New tool “companies.submissions.get” functional
- New tool “following.digest.get” functional
- New tool “following.digest.update” functional
- New tool “following.follow” functional
- New tool “following.list” functional
- New tool “following.openings.list” functional
- New tool “following.openings.mark_all_read” functional
- New tool “following.openings.mark_read” functional
- New tool “following.pause” functional
- New tool “following.resume” functional
- New tool “following.update” functional
- New tool “openings.add_to_board” functional
- New tool “openings.get” functional
- New tool “recommendations.block” functional
- New tool “recommendations.dismiss” functional
- New tool “recommendations.feedback” functional
- New tool “recommendations.get” functional
- New tool “recommendations.list” functional
- New tool “recommendations.restore” functional
- New tool “search.company_openings” functional
- New tool “search.create” functional
- New tool “search.get” functional
- New tool “search.update” functional
- 28 Sept 26 0
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
- 25 Sept 26 0
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
- 27 Aug 26 0
- Server version: 0.5.1 → 0.5.2 functional
- 26 Aug 26 0
- Stability: 0.07 → fail ▼ security
- Tool “interviews.add” was removed ▼ security
- Tool “interviews.delete” was removed ▼ security
- Tool “interviews.list” was removed ▼ security
- Tool “interviews.update” was removed ▼ security
- Tool “persona.remove_trait” was removed ▼ security
- Tool “recommendations.block” was removed ▼ security
- Tool “inbox.accept” was removed ▼ security
- Tool “inbox.status” was removed ▼ security
- Tool “jobs.update_notes” was removed ▼ security
- Tool “journey.update” was removed ▼ security
- Tool “notifications.list” was removed ▼ security
- Tool “notifications.read” was removed ▼ security
- Tool “notifications.read_all” was removed ▼ security
- Tool “offers.accept” was removed ▼ security
- Tool “offers.add_negotiation” was removed ▼ security
- Tool “offers.create” was removed ▼ security
- Tool “offers.decline” was removed ▼ security
- Tool “offers.delete” was removed ▼ security
- Tool “offers.delete_negotiation” was removed ▼ security
- Tool “offers.get” was removed ▼ security
- Tool “offers.update” was removed ▼ security
- Tool “persona.confirm_trait” was removed ▼ security
- Tool “persona.correct_trait” was removed ▼ security
- Tool “recommendations.dismiss” was removed ▼ security
- Tool “recommendations.feedback” was removed ▼ security
- Tool “recommendations.get” was removed ▼ security
- Tool “recommendations.list” was removed ▼ security
- Tool “recommendations.restore” was removed ▼ security
- Tool “recommendations.watch” was removed ▼ security
- Tool “signals.save_opening” was removed ▼ security
- First check of Injection markers: pass security
- First check of Judged manipulation: pass security
- New tool “inbox.apply_suggestion”, which the server declares destructive security
- New tool “jobs.interviews.delete”, which the server declares destructive security
- New tool “jobs.offer.accept”, which the server declares destructive security
- New tool “jobs.offer.decline”, which the server declares destructive security
- New tool “jobs.offer.delete”, which the server declares destructive security
- New tool “jobs.offer.delete_negotiation”, which the server declares destructive security
- Tool “inbox.acknowledge” rewrote its description, which is the text the model reads security
- Tool “inbox.undo” rewrote its description, which is the text the model reads security
- Tool “integrations.connect_google” rewrote its description, which is the text the model reads security
- Tool “jobs.archive” rewrote its description, which is the text the model reads security
- Tool “jobs.delete” rewrote its description, which is the text the model reads security
- Tool “jobs.refresh” rewrote its description, which is the text the model reads security
- Tool “jobs.update” no longer declares itself destructive security
- Tool “signals.update” no longer declares itself destructive security
- Tool “inbox.acknowledge” is now declared destructive security
- Schema quality: 59 → 67 ▼ functional
- “inbox.acknowledge” added a required parameter “confirmed”, so existing callers break ▼ functional
- “inbox.dismiss” added a required parameter “confirmed”, so existing callers break ▼ functional
- “inbox.undo” added a required parameter “confirmed”, so existing callers break ▼ functional
- “inbox.unsubscribe” added a required parameter “confirmed”, so existing callers break ▼ functional
- “jobs.delete” added a required parameter “confirmed”, so existing callers break ▼ functional
- “signals.untrack” added a required parameter “confirmed”, so existing callers break ▼ functional
- Schema quality: 78% → 100% ▲ functional
- First check of Destructive annotations: 100 functional
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
- Server version: 0.4.1 → 0.5.1 functional
- New tool “inbox.sync_status” functional
- New tool “jobs.interviews.add” functional
- New tool “jobs.interviews.update” functional
- New tool “jobs.offer.add_negotiation” functional
- New tool “jobs.offer.create” functional
- New tool “jobs.offer.update” functional
- New tool “signals.openings.list” functional
- New tool “signals.openings.mark_all_read” functional
- New tool “signals.openings.mark_read” functional
- New tool “signals.openings.save” functional
- New tool “signals.recommendations.block” functional
- New tool “signals.recommendations.dismiss” functional
- New tool “signals.recommendations.feedback” functional
- New tool “signals.recommendations.get” functional
- New tool “signals.recommendations.list” functional
- New tool “signals.recommendations.restore” functional
- New tool “signals.recommendations.watch” functional
- “inbox.list” added an optional parameter “limit” cosmetic
- “inbox.list” added an optional parameter “page” cosmetic
- “jobs.update” added an optional parameter “notes” cosmetic
- “signals.list_applied_jobs” added an optional parameter “limit” cosmetic
- “signals.list_applied_jobs” added an optional parameter “page” cosmetic
- “jobs.add” dropped the optional parameter “captured_at” cosmetic
- “jobs.add” dropped the optional parameter “journey_id” cosmetic
- “jobs.add” dropped the optional parameter “state” cosmetic
- “jobs.update” dropped the optional parameter “captured_at” cosmetic
- “jobs.update” dropped the optional parameter “journey_id” cosmetic
- “jobs.update” dropped the optional parameter “state” cosmetic
- 24 Aug 26 0
- Stability: unverified → 0.03 ▲ functional
- Server version: 0.4.0 → 0.4.1 functional
- 23 Aug 26 0
First indexed and scored.
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 5 Nov 2026 · Probed https://mcp.getrefine.co/mcp
TLS valid
Negotiated TLS 1.3 with TLS_AES_128_GCM_SHA256 .
| Subject | Issuer | Valid from | Valid until | Key | Signature | Serial |
|---|---|---|---|---|---|---|
| CN=getrefine.co | CN=WE1,O=Google Trust Services,C=US | 7 Oct 2026 | 5 Jan 2027 | ECDSA 256 | ECDSA-SHA256 | 5d8dd664195403d60e796d257f0978a9 |
| SANs: getrefine.co, mcp.getrefine.co, *.mcp.getrefine.co | ||||||
| CN=WE1,O=Google Trust Services,C=US (CA) | CN=GTS Root R4,O=Google Trust Services LLC,C=US | 13 Dec 2023 | 20 Feb 2029 | ECDSA 256 | ECDSA-SHA384 | 7ff31977972c224a76155d13b6d685e3 |
| CN=GTS Root R4,O=Google Trust Services LLC,C=US (CA) | CN=GlobalSign Root CA,OU=Root CA,O=GlobalSign nv-sa,C=BE | 15 Nov 2023 | 28 Jan 2028 | ECDSA 384 | SHA256-RSA | 7fe530bf331343bedd821610493d8a1b |
Background: What to check on a remote MCP endpoint →
DNSSEC insecure
Validation of mcp.getrefine.co. — Not signed
| Zone | DS | Keys | Algorithms | Outcome |
|---|---|---|---|---|
| . | trust_anchor | 20326, 38696 | 8, 8 | Verified |
| co. | present | 7786 | 8 | Verified |
| getrefine.co. | absent | Unsigned (proven) parent-signed NSEC/NSEC3 proves an unsigned delegation |
Authentication Enforced and verified
The endpoint asked for a token and published valid RFC 9728 metadata describing how to get one.
| Result | Enforced and verified |
|---|---|
| Enforced | On tool calls |
| HTTP status | 200 |
WWW-Authenticate challenge Bearer resource_metadata="https://mcp.getrefine.co/.well-known/oauth-protected-resource", scope="openid read_user read_jobs write_jobs read_companies write_companies read_inbox write_inbox read_integrations write_integrations"
Bearer resource_metadata="https://mcp.getrefine.co/.well-known/oauth-protected-resource", scope="openid read_user read_jobs write_jobs read_companies write_companies read_inbox write_inbox read_integrations write_integrations"Protected resource metadata
| Document | https://mcp.getrefine.co/.well-known/oauth-protected-resource |
|---|---|
| Retrieved | Yes |
| Resource | https://mcp.getrefine.co/mcp |
| Authorisation server | https://api.getrefine.co |
Background: How OAuth 2.1 works in the 2026 MCP spec →
Transports 2 probes
| Transport | URL | Outcome | Status | Location |
|---|---|---|---|---|
| streamable-http | https://mcp.getrefine.co/mcp | Verified | 200 | |
| http (plaintext) | http://mcp.getrefine.co/mcp | Inconclusive | 401 |
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →
account.agenda ~16
Get upcoming interviews and action items
Input schema present but exposes no named parameters.
| Name | Type | Req | Description |
|---|---|---|---|
| data | object | yes | – |
| meta | object | – | – |
No examples provided.
companies.submissions.create ~81
Submit 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 for progress; follow separately once company.id is available.
| Name | Type | Req | Description |
|---|---|---|---|
| careers_url | string | yes | – |
| company_name | string | yes | – |
| Name | Type | Req | Description |
|---|---|---|---|
| data | object | yes | – |
No examples provided.
companies.submissions.get ~71
Read 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 claim the company was added or invent jobs while it is still working.
| Name | Type | Req | Description |
|---|---|---|---|
| submission_id | string | yes | – |
| Name | Type | Req | Description |
|---|---|---|---|
| data | object | yes | – |
No examples provided.
following.digest.get ~37
Read the user-wide Following email digest schedule. data is null if no schedule is configured. Company match filters are managed separately with following.update.
Input schema present but exposes no named parameters.
| Name | Type | Req | Description |
|---|---|---|---|
| data | – | yes | – |
No examples provided.
following.digest.update ~90
Set 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 schedules can be patched.
| Name | Type | Req | Description |
|---|---|---|---|
| frequency | string | – | – |
| hour | integer | – | – |
| timezone | string | – | – |
| weekday | integer | – | – |
| Name | Type | Req | Description |
|---|---|---|---|
| data | – | yes | – |
No examples provided.
following.follow ~108
Follow 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 new openings. This does not submit an unknown careers page or collect historical matches.
| Name | Type | Req | Description |
|---|---|---|---|
| company_id | string | yes | – |
| filters | array | yes | Alternative matches (OR). Fields inside each match combine with AND. [{}] follows every new opening. This is the complete filter set, not a patch. |
| Name | Type | Req | Description |
|---|---|---|---|
| data | object | yes | – |
No examples provided.
following.list ~45
List 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.
Input schema present but exposes no named parameters.
| Name | Type | Req | Description |
|---|---|---|---|
| data | array | yes | – |
No examples provided.
following.openings.list ~147
Read 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 follow or all companies before view filters; meta.filtered_count covers the current filtered tab.
| Name | Type | Req | Description |
|---|---|---|---|
| department | string | – | – |
| follow_id | string | – | Follow ID from following.list, not company.id. |
| limit | integer | – | Maximum records to return |
| location | string | – | Exact location facet or "remote". |
| page | string | – | Pagination cursor returned as meta.next_page |
| q | string | – | Search opening titles. |
| tab | string | – | – |
| Name | Type | Req | Description |
|---|---|---|---|
| data | array | yes | – |
| meta | object | yes | – |
No examples provided.
following.openings.mark_all_read ~86
Mark 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 affected count; do not invent one.
| Name | Type | Req | Description |
|---|---|---|---|
| confirmed | boolean | yes | – |
| follow_id | string | – | Follow ID from following.list, not company.id. |
| Name | Type | Req | Description |
|---|---|---|---|
| message | string | yes | Human-readable confirmation of the action |
No examples provided.
following.openings.mark_read ~43
Mark one Following row as read. Use the row id from following.openings.list, not nested opening.id.
| Name | Type | Req | Description |
|---|---|---|---|
| follow_opening_id | string | yes | – |
| Name | Type | Req | Description |
|---|---|---|---|
| data | object | yes | – |
No examples provided.
following.pause ~48
Pause future matching openings for this follow without deleting it. This does not stop shared company indexing or pause other follows.
| Name | Type | Req | Description |
|---|---|---|---|
| follow_id | string | yes | Follow ID from following.list, not company.id. |
| Name | Type | Req | Description |
|---|---|---|---|
| data | object | yes | – |
No examples provided.
following.resume ~31
Resume a paused company follow.
| Name | Type | Req | Description |
|---|---|---|---|
| follow_id | string | yes | Follow ID from following.list, not company.id. |
| Name | Type | Req | Description |
|---|---|---|---|
| data | object | yes | – |
No examples provided.
following.unfollow ~65
Unfollow 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.
| Name | Type | Req | Description |
|---|---|---|---|
| confirmed | boolean | yes | – |
| follow_id | string | yes | Follow ID from following.list, not company.id. |
| Name | Type | Req | Description |
|---|---|---|---|
| message | string | yes | Human-readable confirmation of the action |
No examples provided.
following.update ~100
Replace 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.
| Name | Type | Req | Description |
|---|---|---|---|
| filters | array | yes | Alternative matches (OR). Fields inside each match combine with AND. [{}] follows every new opening. This is the complete filter set, not a patch. |
| follow_id | string | yes | Follow ID from following.list, not company.id. |
| Name | Type | Req | Description |
|---|---|---|---|
| data | object | yes | – |
No examples provided.
inbox.acknowledge ~64
Keep auto-applied inbox items as-is and finalize the automatic action. Confirm the specific items with the user first.
| Name | Type | Req | Description |
|---|---|---|---|
| confirmed | boolean | yes | Must be true after the user confirms keeping these automatic actions |
| ids | array | yes | Inbox item ids to acknowledge |
| Name | Type | Req | Description |
|---|---|---|---|
| data | object | yes | – |
| meta | object | – | – |
No examples provided.
inbox.apply_suggestion ~67
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.
| Name | Type | Req | Description |
|---|---|---|---|
| confirmed | boolean | yes | Must be true after the user confirms applying this suggestion |
| item_id | string | yes | Inbox item id |
| Name | Type | Req | Description |
|---|---|---|---|
| data | object | yes | – |
| meta | object | – | – |
No examples provided.
inbox.decline ~105
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.
| Name | Type | Req | Description |
|---|---|---|---|
| confirmed | boolean | yes | Must be true, and only after the user explicitly approved declining these conversations |
| ids | array | yes | Inbox item ids to decline |
| preference | string | – | Send preference to apply; omit to use the saved preference |
| remember | boolean | – | Save the preference for future declines |
| Name | Type | Req | Description |
|---|---|---|---|
| data | object | yes | – |
| meta | object | – | – |
No examples provided.
inbox.dismiss ~61
Dismiss inbox items you are not acting on (also marks the mail read in Gmail)
| Name | Type | Req | Description |
|---|---|---|---|
| confirmed | boolean | yes | Must be true after the user confirms dismissing these items and marking their mail read |
| ids | array | yes | Inbox item ids to dismiss |
| Name | Type | Req | Description |
|---|---|---|---|
| data | object | yes | – |
| meta | object | – | – |
No examples provided.
inbox.draft_reply ~59
Generate an AI reply draft for an inbox item. Returns HTML for review; it does not send anything.
| Name | Type | Req | Description |
|---|---|---|---|
| item_id | string | yes | Inbox item id |
| kind | string | yes | decline politely passes; interested asks to continue the conversation |
| Name | Type | Req | Description |
|---|---|---|---|
| data | object | yes | – |
| meta | object | – | – |
No examples provided.
inbox.get ~30
Get one inbox item with its related job and application
| Name | Type | Req | Description |
|---|---|---|---|
| item_id | string | yes | Inbox item id |
| Name | Type | Req | Description |
|---|---|---|---|
| data | object | yes | – |
| meta | object | – | – |
No examples provided.
inbox.get_thread ~30
Fetch the full email thread for an inbox item
| Name | Type | Req | Description |
|---|---|---|---|
| item_id | string | yes | Inbox item id |
| Name | Type | Req | Description |
|---|---|---|---|
| data | array | yes | – |
| meta | object | – | – |
No examples provided.
inbox.list ~153
List email conversations Refine matched to your job search (applications, interviews, recruiter outreach)
| Name | Type | Req | Description |
|---|---|---|---|
| account | string | – | Filter to one connected Google account id |
| limit | integer | – | Maximum records to return |
| page | string | – | Pagination cursor returned as meta.next_page |
| shelf | string | – | For the outreach tab: show the low-signal shelf instead of the main feed |
| status | string | – | pending needs a decision, auto was auto-applied, active has an open conversation, handled is done |
| tab | string | – | Which inbox tab to list; defaults to applications |
| unread | boolean | – | With status=active: only conversations with (or without) an unread reply |
| Name | Type | Req | Description |
|---|---|---|---|
| data | array | yes | – |
| meta | object | – | – |
No examples provided.
inbox.mark_read ~29
Clear an inbox item's unread-reply flag
| Name | Type | Req | Description |
|---|---|---|---|
| item_id | string | yes | Inbox item id |
| Name | Type | Req | Description |
|---|---|---|---|
| message | string | yes | Human-readable confirmation of the action |
No examples provided.
inbox.refresh ~21
Check Gmail for new mail now; returns per-account sync status
Input schema present but exposes no named parameters.
| Name | Type | Req | Description |
|---|---|---|---|
| data | array | yes | – |
| meta | object | – | – |
No examples provided.
inbox.send_reply ~115
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.
| Name | Type | Req | Description |
|---|---|---|---|
| body | string | yes | HTML body of the reply, exactly as approved by the user |
| confirmed | boolean | yes | Must be true, and only after the user explicitly approved sending this exact message |
| draft_kind | string | – | Set when the body came from inbox.draft_reply |
| item_id | string | yes | Inbox item id |
| Name | Type | Req | Description |
|---|---|---|---|
| data | object | yes | – |
| meta | object | – | – |
No examples provided.
inbox.sync_status ~23
Per-account Gmail synchronization status, including current progress and last sync time
Input schema present but exposes no named parameters.
| Name | Type | Req | Description |
|---|---|---|---|
| data | array | yes | – |
| meta | object | – | – |
No examples provided.
inbox.undo ~65
Undo an auto-applied inbox action. This can delete a board record that the automatic action created, so confirm with the user first.
| Name | Type | Req | Description |
|---|---|---|---|
| confirmed | boolean | yes | Must be true after the user confirms undoing the automatic action |
| item_id | string | yes | Inbox item id |
| Name | Type | Req | Description |
|---|---|---|---|
| data | object | yes | – |
| meta | object | – | – |
No examples provided.
inbox.unsubscribe ~91
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.
| Name | Type | Req | Description |
|---|---|---|---|
| confirmed | boolean | yes | Must be true, and only after the user explicitly approved unsubscribing from this sender |
| item_id | string | yes | Inbox item id |
| Name | Type | Req | Description |
|---|---|---|---|
| message | string | yes | Human-readable confirmation of the action |
No examples provided.
integrations.connect_google ~66
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.
Input schema present but exposes no named parameters.
| Name | Type | Req | Description |
|---|---|---|---|
| connect_url | string | yes | Single-use browser URL for connecting Gmail |
| expires_at | string | – | When the connection URL expires |
| instructions | string | yes | Safety and usage instructions for the connection URL |
No examples provided.
integrations.list ~28
List connected Google accounts and their grant status. To connect a new account, use integrations.connect_google.
Input schema present but exposes no named parameters.
| Name | Type | Req | Description |
|---|---|---|---|
| data | array | yes | – |
| meta | object | – | – |
No examples provided.
jobs.add ~98
Add a new job to your journey
| Name | Type | Req | Description |
|---|---|---|---|
| company | string | yes | Company name |
| compensation_text | string | – | Compensation text from the posting |
| description | string | – | Job description |
| location | string | – | Job location |
| qualifications | string | – | Job qualifications |
| source | string | – | Where this job came from |
| title | string | yes | Job title |
| url | string | – | URL of the job posting |
| Name | Type | Req | Description |
|---|---|---|---|
| data | object | yes | – |
| meta | object | – | – |
No examples provided.
jobs.archive ~34
Hide a job from the active board without recording a rejection or closing the application
| Name | Type | Req | Description |
|---|---|---|---|
| job_id | string | yes | Job id |
| Name | Type | Req | Description |
|---|---|---|---|
| data | object | yes | – |
| meta | object | – | – |
No examples provided.
jobs.delete ~73
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.
| Name | Type | Req | Description |
|---|---|---|---|
| confirmed | boolean | yes | Must be true after the user confirms permanent deletion |
| job_id | string | yes | Job id |
| Name | Type | Req | Description |
|---|---|---|---|
| message | string | yes | Human-readable confirmation of the action |
No examples provided.
jobs.get ~25
Get details of a specific job
| Name | Type | Req | Description |
|---|---|---|---|
| job_id | string | yes | Job id |
| Name | Type | Req | Description |
|---|---|---|---|
| data | object | yes | – |
| meta | object | – | – |
No examples provided.
jobs.interviews.add ~89
Log an interview for a job
| Name | Type | Req | Description |
|---|---|---|---|
| job_id | string | yes | Job id |
| location | string | – | Location or meeting link |
| name | string | yes | Interview name, e.g. phone screen, technical, behavioral, onsite |
| notes | string | – | Notes or debrief from the interview |
| scheduled_at | string | – | ISO 8601 date/time with timezone |
| Name | Type | Req | Description |
|---|---|---|---|
| data | object | yes | – |
| meta | object | – | – |
No examples provided.
jobs.interviews.delete ~66
Permanently delete an interview from a job. Confirm with the user first; it cannot be undone.
| Name | Type | Req | Description |
|---|---|---|---|
| confirmed | boolean | yes | Must be true after the user confirms permanent deletion |
| interview_id | string | yes | Interview id |
| job_id | string | yes | Job id |
| Name | Type | Req | Description |
|---|---|---|---|
| message | string | yes | Human-readable confirmation of the action |
No examples provided.
jobs.interviews.update ~206
Update an existing interview
| Name | Type | Req | Description |
|---|---|---|---|
| cancelled_at | string | – | ISO 8601 cancellation time with timezone |
| cancelled_reason | string | – | Why the interview was cancelled |
| completed_at | string | – | Completion date in YYYY-MM-DD format |
| feedback | string | – | Feedback received or given |
| interview_id | string | yes | Interview id |
| interviewers | string | – | Names or roles of the interviewers |
| job_id | string | yes | Job id |
| location | string | – | Location or meeting link |
| name | string | – | Interview name, e.g. phone screen, technical, onsite |
| next_action | string | – | The next step after this interview |
| notes | string | – | Notes or debrief from the interview |
| outcome | string | – | Interview outcome |
| rating | integer | – | Your rating of the interview, 1 to 5 |
| scheduled_at | string | – | ISO 8601 date/time with timezone |
| Name | Type | Req | Description |
|---|---|---|---|
| data | object | yes | – |
| meta | object | – | – |
No examples provided.
jobs.list ~39
List jobs in your journey
| Name | Type | Req | Description |
|---|---|---|---|
| limit | integer | – | Maximum records to return |
| page | string | – | Pagination cursor returned as meta.next_page |
| Name | Type | Req | Description |
|---|---|---|---|
| data | array | yes | – |
| meta | object | – | – |
No examples provided.
jobs.mark_applied ~26
Mark a job as applied
| Name | Type | Req | Description |
|---|---|---|---|
| job_id | string | yes | Job id |
| Name | Type | Req | Description |
|---|---|---|---|
| data | object | yes | – |
| meta | object | – | – |
No examples provided.
jobs.offer.accept ~72
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.
| Name | Type | Req | Description |
|---|---|---|---|
| confirmed | boolean | yes | Must be true after the user confirms accepting the offer |
| job_id | string | yes | Job id |
| Name | Type | Req | Description |
|---|---|---|---|
| data | object | yes | – |
| meta | object | – | – |
No examples provided.
jobs.offer.add_negotiation ~143
Log a negotiation event on an offer (counter-offer, update, etc.)
| Name | Type | Req | Description |
|---|---|---|---|
| bonus_cents | integer | – | Signing bonus in cents |
| equity_text | string | – | Equity details (e.g. "0.05% over 4 years") |
| event_date | string | – | Event date in YYYY-MM-DD format |
| event_type | string | yes | Whether the event records an employer offer or your counter |
| job_id | string | yes | Job id |
| notes | string | – | Notes about this negotiation event |
| salary_cents | integer | – | Salary in cents (e.g. 15000000 for $150k) |
| Name | Type | Req | Description |
|---|---|---|---|
| data | object | yes | – |
| meta | object | – | – |
No examples provided.
jobs.offer.create ~286
Record a job offer with compensation details
| Name | Type | Req | Description |
|---|---|---|---|
| base_salary_cents | integer | – | Base salary in cents (e.g. 15000000 for $150k) |
| bonus_cents | integer | – | Bonus in cents |
| currency | string | – | Supported currency code |
| deadline_at | string | – | ISO 8601 offer deadline with timezone |
| equity_text | string | – | Equity details as text |
| initial_bonus_cents | integer | – | The originally offered bonus in cents |
| initial_equity_text | string | – | The originally offered equity as text |
| initial_rsu_text | string | – | The originally offered RSUs as text |
| initial_salary_cents | integer | – | The originally offered base salary in cents |
| job_id | string | yes | Job id |
| next_action | string | – | The next step on this offer |
| notes | string | – | Notes about the offer |
| rsu_text | string | – | RSU details as text |
| target_bonus_cents | integer | – | The bonus you are negotiating toward, in cents |
| target_equity_text | string | – | The equity you are negotiating toward, as text |
| target_rsu_text | string | – | The RSUs you are negotiating toward, as text |
| target_salary_cents | integer | – | The base salary you are negotiating toward, in cents |
| Name | Type | Req | Description |
|---|---|---|---|
| data | object | yes | – |
| meta | object | – | – |
No examples provided.
jobs.offer.decline ~63
Decline the offer for a job, a major state change; confirm with the user first. It does not email the employer.
| Name | Type | Req | Description |
|---|---|---|---|
| confirmed | boolean | yes | Must be true after the user confirms declining the offer |
| job_id | string | yes | Job id |
| Name | Type | Req | Description |
|---|---|---|---|
| data | object | yes | – |
| meta | object | – | – |
No examples provided.
jobs.offer.delete ~68
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.
| Name | Type | Req | Description |
|---|---|---|---|
| confirmed | boolean | yes | Must be true after the user confirms permanent deletion |
| job_id | string | yes | Job id |
| Name | Type | Req | Description |
|---|---|---|---|
| message | string | yes | Human-readable confirmation of the action |
No examples provided.
jobs.offer.delete_negotiation ~57
Remove a negotiation event from an offer
| Name | Type | Req | Description |
|---|---|---|---|
| confirmed | boolean | yes | Must be true after the user confirms deletion |
| event_id | integer | yes | Negotiation event id |
| job_id | string | yes | Job id |
| Name | Type | Req | Description |
|---|---|---|---|
| message | string | yes | Human-readable confirmation of the action |
No examples provided.
jobs.offer.update ~286
Update the offer recorded for a job
| Name | Type | Req | Description |
|---|---|---|---|
| base_salary_cents | integer | – | Base salary in cents (e.g. 15000000 for $150k) |
| bonus_cents | integer | – | Bonus in cents |
| currency | string | – | Supported currency code |
| deadline_at | string | – | ISO 8601 offer deadline with timezone |
| equity_text | string | – | Equity details as text |
| initial_bonus_cents | integer | – | The originally offered bonus in cents |
| initial_equity_text | string | – | The originally offered equity as text |
| initial_rsu_text | string | – | The originally offered RSUs as text |
| initial_salary_cents | integer | – | The originally offered base salary in cents |
| job_id | string | yes | Job id |
| next_action | string | – | The next step on this offer |
| notes | string | – | Notes about the offer |
| rsu_text | string | – | RSU details as text |
| target_bonus_cents | integer | – | The bonus you are negotiating toward, in cents |
| target_equity_text | string | – | The equity you are negotiating toward, as text |
| target_rsu_text | string | – | The RSUs you are negotiating toward, as text |
| target_salary_cents | integer | – | The base salary you are negotiating toward, in cents |
| Name | Type | Req | Description |
|---|---|---|---|
| data | object | yes | – |
| meta | object | – | – |
No examples provided.
jobs.refresh ~46
Queue a job posting to be re-scraped. The returned job may remain pending; use jobs.get later to inspect the refreshed state.
| Name | Type | Req | Description |
|---|---|---|---|
| job_id | string | yes | Job id |
| Name | Type | Req | Description |
|---|---|---|---|
| data | object | yes | – |
| meta | object | – | – |
No examples provided.
jobs.unarchive ~28
Restore an archived job to the active board
| Name | Type | Req | Description |
|---|---|---|---|
| job_id | string | yes | Job id |
| Name | Type | Req | Description |
|---|---|---|---|
| data | object | yes | – |
| meta | object | – | – |
No examples provided.
jobs.update ~119
Update a job in your journey
| Name | Type | Req | Description |
|---|---|---|---|
| company | string | – | Company name |
| compensation_text | string | – | Compensation text from the posting |
| description | string | – | Job description |
| job_id | string | yes | Job id |
| location | string | – | Job location |
| notes | string | – | Markdown notes about this application |
| qualifications | string | – | Job qualifications |
| source | string | – | Where this job came from |
| title | string | – | Job title |
| url | string | – | URL of the job posting |
| Name | Type | Req | Description |
|---|---|---|---|
| data | object | yes | – |
| meta | object | – | – |
No examples provided.
openings.add_to_board ~71
Add 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 any matching Following item as read.
| Name | Type | Req | Description |
|---|---|---|---|
| opening_id | string | yes | – |
| Name | Type | Req | Description |
|---|---|---|---|
| data | object | yes | – |
| meta | object | – | – |
No examples provided.
How do I install the Refine Job Search MCP server?
Refine Job Search is a hosted endpoint at https://mcp.getrefine.co/mcp, so there is nothing to install locally. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.
remote · mcp.getrefine.co
claude mcp add --transport http co-getrefine-refine 'https://mcp.getrefine.co/mcp'
What is the Refine Job Search MCP server?
Refine Job Search is an MCP server listed in the public MCP registry as co.getrefine/refine. Job search management: applications, interviews, offers, recruiter email, and company openings. This page covers its hosted endpoint (https://mcp.getrefine.co/mcp).
Is the Refine Job Search MCP server safe to use?
Refine Job Search scores 85 out of 100 on VerifyMCP. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.
What tools does the Refine Job Search MCP server expose?
Refine Job Search exposes 62 tools: jobs.list, jobs.get, jobs.add, jobs.update, jobs.delete, and 57 more. Their descriptions and schemas cost roughly 4,730 tokens of context every time the server is loaded.
Does the Refine Job Search MCP server require authentication?
Yes. Refine Job Search asked us for credentials when we connected, so you will need to authorise it in your MCP client before it can do anything.
Is the Refine Job Search MCP server still maintained?
Refine Job Search is still listed as active in the MCP registry. We last reached this channel on 5 November 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.