MCP serverco.getrefine/refine

Get upcoming interviews and action items

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

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.

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 sp

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

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

Get one inbox item with its related job and application

Fetch the full email thread for an inbox item

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

Clear an inbox item's unread-reply flag

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

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 se

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

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

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

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

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

Add a new job to your journey

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

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.arch

Get details of a specific job

Log an interview for a job

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

Update an existing interview

List jobs in your journey

Mark a job as applied

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.

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

Record a job offer with compensation details

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

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.

Remove a negotiation event from an offer

Update the offer recorded for a job

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

Restore an archived job to the active board

Update a job in your journey

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

List companies you are tracking

List jobs in your journey that came from a tracked company

List signal notifications (new openings at tracked companies)

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

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

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

Pause tracking for a company

Dismiss a recommended company and block it from future recommendations

Dismiss a recommended company

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

Get one recommended company with sources and persona fit

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

Restore a dismissed or blocked recommendation

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

Resume tracking for a company

Start tracking a company for new job openings

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.

Update filters on a tracked company