Ocean of Jobs

Create a job alert: Ocean of Jobs emails the user new jobs that match the filter, at the times set in their preferences. Up to 5 alerts per account. The email goes to the address the account had when the token was made. Create one only when the user asks for it. Needs the user's personal access token.

Delete a job alert. Its emails stop. Needs the user's personal access token.

A company on Ocean of Jobs by name or domain: how many jobs it has open, how many are new this week, how long it has been tracked, its newest jobs, and its Ocean of Jobs page.

One job on Ocean of Jobs by its id (from search_jobs or get_company): the description as plain text, its lifetime, whether its data is verified against the employer's ATS, and both links, the Ocean of Jobs page first.

The user's search preferences: their skills, the seniority, workplace and places they want, and when alert emails are sent. The board's best matches and the account overview use them. Needs the user's personal access token.

The user's job alerts: each one a saved search whose new matches are emailed to them, with its filter and whether it is on. Needs the user's personal access token.

The jobs the extension worked on for the user, newest first, with each one's status, where the job came from and the outcome the user reported. status is the extension's: submitted means the site confirmed it; unconfirmed means it was sent or may have been, with no confirmation; sent means the user sent it with the site's own button and the site didn't confirm it. Never call unconfirmed or sent submitted. outcome is only what the user marked (interview, offer, rejected, no_reply) and null when they haven't; never treat silence as no reply. Needs the user's personal access token.

The jobs waiting in the user's auto apply queue, oldest first, with the same fields as search results and when each was queued. A job leaves the queue once the extension has tried it. Needs the user's personal access token.

The jobs saved on the user's Ocean of Jobs account, newest saved first, with the same fields as search results and when each was saved. Needs the user's personal access token.

Queue a job for the Ocean of Jobs Chrome extension to apply to with the user's profile and resume. The extension applies to queued jobs on its next check, every 15 minutes, so the user needs the extension installed and connected. The user must also turn on "Jobs queued by my AI assistant through MCP" in their auto apply settings. For now the extension fills Greenhouse Ashby and Workable forms only (an apply_url on boards.greenhouse.io, job-boards.greenhouse.io, jobs.ashbyhq.com or apply.workable.com); a job on any other site is refused, so pick those jobs. This sends a real application, so queue a job only when the user asks for it. Needs the user's personal access token. Queueing the same job twice is harmless: a job already in the queue, from anywhere, stays one entry. A job already applied to or being applied to is refused.

Take a job out of the user's auto apply queue before the extension applies to it. Needs the user's personal access token.

Take a job off the user's saved list. Needs the user's personal access token.

Save a job to the user's Ocean of Jobs account, where it shows under Saved jobs on every device. Needs the user's personal access token. Saving the same job twice is harmless.

Search open jobs on Ocean of Jobs. Give at least one of query, company, city or country (IL for Israel; most listings are in the US). Returns up to 25 jobs per call, best match first when there is a query, newest first otherwise, with the total number of matches. Every job includes its lifetime (days listed, first and last seen) and two links: url, the Ocean of Jobs page, to show first, and apply_url, the employer's page. How to search well: - Put one or two core title or skill words in query, such as "backend", "python" or "devops", and use the filters for place, seniority and dates. Every word in query must match, so a long description of the person returns little or nothing. - Search once. If that gives relevant candidates, do not search again for synonyms. If it gives nothing useful, change or broaden query once, keeping the same filters. - Across searches, treat the same id or the same apply_url as one job. - Open only the strongest few candidates with get_job, and read their descriptions for seniority, required skills and where the job can be done from before ranking them. - Give the number of recommendations asked for when enough jobs fit, and say so when fewer do. - Never call a listing reposted because of its age. Use lifetime.reappeared_at, and say when the tracked history is too short to tell.

Record what the user says happened with an application that went out (submitted, unconfirmed or sent): interview, offer, rejected or no_reply, or none to clear it. Only when the user tells you; never guess. It changes nothing else: not the status and not the user's credits. Needs the user's personal access token.

Pause or resume a job alert, or replace its filter. A new filter starts from now: jobs already open are not emailed. Needs the user's personal access token.

Change some of the user's search preferences. Only the fields given change; a list given replaces the old list, so read get_preferences first to add to one. Skills outside Ocean of Jobs' own list are dropped, and the answer shows what was kept. Change them only when the user asks. Needs the user's personal access token.