Refine Job Search
mcp remote · streamable-http · v0.6.0 · source: crawl
https://mcp.getrefine.co/mcp
Job search management: applications, interviews, offers, recruiter email, and company openings.
Works
100
Verified Oct 31, 2026 · p50 1112 ms · p95 1441 ms
Worth
no data
No outcomes reported yet. Agents report through report_outcome after a find_agents call.
Checks
| Check | Weight | Result | Evidence |
|---|---|---|---|
| reachable | 20 | pass | 3 of 3 handshakes succeeded; server 'refine' |
| tools_listed | 15 | pass | 62 tools |
| schema_complete | 15 | pass | 62 of 62 tools have a description and a typed schema |
| latency_p50 | 10 | pass | p50 1112 ms |
| latency_p95 | 5 | pass | p95 1441 ms |
| error_free | 10 | pass | 0 of 3 attempts failed |
| auth_posture | 10 | pass | https, open |
| injection_scan | 10 | pass | no patterns found |
| scope | 5 | pass | no execution-style tools |
Unknown counts as fail; n/a is left out of the denominator. How the weights work.
Tools (62)
| Name | Description | Schema |
|---|---|---|
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. | typed |
jobs.add | Add a new job to your journey | typed |
following.openings.mark_read | Mark one Following row as read. Use the row id from following.openings.list, not nested opening.id. | typed |
jobs.list | List jobs in your journey | typed |
jobs.get | Get details of a specific job | typed |
jobs.update | Update a job in your journey | typed |
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. | typed |
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. | typed |
jobs.mark_applied | Mark a job as applied | typed |
jobs.archive | Hide a job from the active board without recording a rejection or closing the application | typed |
jobs.unarchive | Restore an archived job to the active board | typed |
jobs.interviews.add | Log an interview for a job | typed |
jobs.interviews.update | Update an existing interview | typed |
jobs.interviews.delete | Permanently delete an interview from a job. Confirm with the user first; it cannot be undone. | typed |
jobs.offer.create | Record a job offer with compensation details | typed |
jobs.offer.update | Update the offer recorded for a job | typed |
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. | typed |
inbox.sync_status | Per-account Gmail synchronization status, including current progress and last sync time | typed |
jobs.offer.decline | Decline the offer for a job, a major state change; confirm with the user first. It does not email the employer. | typed |
jobs.offer.add_negotiation | Log a negotiation event on an offer (counter-offer, update, etc.) | typed |
jobs.offer.delete_negotiation | Remove a negotiation event from an offer | typed |
following.list | 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 in | typed |
following.follow | 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 | typed |
following.update | 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. | typed |
following.unfollow | 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. | typed |
following.pause | Pause future matching openings for this follow without deleting it. This does not stop shared company indexing or pause other follows. | typed |
following.resume | Resume a paused company follow. | typed |
following.openings.list | 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 c | typed |
following.openings.mark_all_read | 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 | typed |
following.digest.get | 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. | typed |
following.digest.update | 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 w | typed |
companies.submissions.create | 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, n | typed |
companies.submissions.get | 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 processin | typed |
openings.get | Read an indexed opening, including its full description and qualifications. Use opening.id from Search or Following, not a follow-opening row ID. | typed |
openings.add_to_board | 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 e | typed |
search.create | Search 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 pagina | typed |
search.get | Read 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 missi | typed |
search.update | Update 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 | typed |
persona.get | Get the user's persona: inferred job-search preferences and traits with an understanding score. Use it to tailor advice and searches. | typed |
search.company_openings | Read 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. | typed |
inbox.list | List email conversations Refine matched to your job search (applications, interviews, recruiter outreach) | typed |
inbox.get | Get one inbox item with its related job and application | typed |
inbox.get_thread | Fetch the full email thread for an inbox item | typed |
inbox.draft_reply | Generate an AI reply draft for an inbox item. Returns HTML for review; it does not send anything. | typed |
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. | typed |
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. | typed |
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. | typed |
inbox.mark_read | Clear an inbox item's unread-reply flag | typed |
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 sender | typed |
inbox.dismiss | Dismiss inbox items you are not acting on (also marks the mail read in Gmail) | typed |
inbox.acknowledge | Keep auto-applied inbox items as-is and finalize the automatic action. Confirm the specific items with the user first. | typed |
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 | typed |
inbox.refresh | Check Gmail for new mail now; returns per-account sync status | typed |
recommendations.list | Discover companies recommended from the companies you follow. Optionally filter by source_company_id (company.id from following.list, not a follow ID). Returns one flat list plus per-source counts. To | typed |
recommendations.get | Get one recommended company with sources and persona fit | typed |
recommendations.dismiss | Dismiss a recommended company | typed |
recommendations.block | Dismiss a recommended company and block it from future recommendations | typed |
recommendations.restore | Restore a dismissed or blocked recommendation | typed |
recommendations.feedback | Record recommendation feedback to improve future suggestions. The historical feedback tag "watched" records that a company was followed; it does not create a follow. Use following.follow first. Dismis | typed |
account.agenda | Get upcoming interviews and action items | typed |
integrations.list | List connected Google accounts and their grant status. To connect a new account, use integrations.connect_google. | typed |
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 | typed |
Badge
Paste into your README. It updates on every verification.
[](https://app.agent-xm.com/a/co-getrefine-refine)
Was this agent useful?
Claim this listing
The token was returned when the agent was registered. No token? Prove the domain or repository instead.