Krew Guru

Search open vacancies for seafarers on Krew Guru by rank, vessel type and boarding date. Use this when a seafarer asks which jobs are open, for example "2/E jobs on bulk carriers joining in November" or "AB vacancies on tankers". Returns up to 20 published vacancies with a boarding date that has not passed, salary range in USD per month (net), contract length in months and a vacancy_url to open the vacancy on krew.guru. Company contacts are not returned; the seafarer applies on krew.guru. Do not use for checking whether a crewing agency or a job offer is genuine, for jobs ashore, or for a seafarer's own applications.

{
  "type": "object",
  "properties": {
    "rank": {
      "type": "string",
      "maxLength": 100,
      "description": "Rank (position on board). Use the full name or a short code, for example: Master; Chief Officer (CO, C/O); Second Officer (2O, 2/O); Chief Engineer (CE, C/E); Second Engineer (2E, 2/E); Third Engineer (3E); ETO (Electro-Technical Officer); Bosun; AB (Able Seaman); OS (Ordinary Seaman); Motorman/Oiler; Chief Cook. Write 2/E as \"2E\" or \"Second Engineer\".",
      "examples": [
        "Second Engineer",
        "AB"
      ]
    },
    "ship_type": {
      "type": "string",
      "maxLength": 100,
      "description": "Vessel type, for example: Bulk carrier, Container ship, Oil tanker, Product tanker, Chemical tanker, LNG carrier, LPG carrier, General cargo vessel, Car carrier, AHTS (anchor handling tug supply), PSV (Platform Supply Vessel), Cruise ship, Dredger. Groups are accepted too: oil, chem, gas, bulk, container, cargo, offshore.",
      "examples": [
        "Bulk carrier",
        "oil"
      ]
    },
    "date_of_boarding": {
      "type": "string",
      "format": "date",
      "description": "Planned joining date, YYYY-MM-DD. Matches vacancies boarding within one week of this date.",
      "examples": [
        "2026-11-15"
      ]
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 20,
      "default": 10,
      "description": "How many vacancies to return (1-20)."
    },
    "offset": {
      "type": "integer",
      "minimum": 0,
      "default": 0,
      "description": "Skip this many vacancies (paging)."
    }
  },
  "additionalProperties": false
}

Get the details of one Krew Guru vacancy by its vac_id: rank, vessel type and size, salary range in USD per month (net), contract length, boarding date and port, requirements (citizenship, English level, certificates, visas) and a vacancy_url to open it on krew.guru. Use this when the seafarer wants more about a vacancy returned by search_maritime_jobs or by create_seafarer_profile_draft (matched_vacancies). Do not use for searching (use search_maritime_jobs) or for company contact details, which are not returned.

{
  "type": "object",
  "properties": {
    "vac_id": {
      "type": "string",
      "format": "uuid",
      "description": "Vacancy id (vac_id) from search_maritime_jobs or matched_vacancies.",
      "examples": [
        "4f1c2a9e-0000-4000-8000-000000000000"
      ]
    }
  },
  "required": [
    "vac_id"
  ],
  "additionalProperties": false
}

Turn a seafarer CV (plain text the seafarer pasted or shared: sea service records, ranks, vessels, certificates) into a Krew Guru profile draft. Sends a sign-in code and link to the email in the CV (or to the email argument if the CV has none); the seafarer opens the email and enters the code on krew.guru to save the profile; no tool accepts that code. Returns the same result as the Krew Guru website: status (verification_sent, email_required, not_a_cv), masked email, handoff_url for the seafarer, up to 5 matched_vacancies, user_message and next_actions. Contacts and document numbers are not returned. If status is email_required, ask the seafarer for an email and call again with the same text and the email argument. Drafts expire after 24 hours. Limit: 6 CVs per 10 minutes. Use this when the seafarer asks to create or update a Krew Guru profile from a CV or to find jobs matching a CV. Do not use for CVs of other people without their consent, for non-maritime CVs, or for employer or vacancy data.

{
  "type": "object",
  "properties": {
    "raw_cv_text": {
      "type": "string",
      "minLength": 40,
      "maxLength": 48000,
      "description": "Full CV text as provided by the seafarer, 40-48,000 characters, any language. Keep sea service records (vessel name, IMO, type, rank, dates)."
    },
    "email": {
      "type": "string",
      "format": "email",
      "maxLength": 120,
      "description": "The seafarer's own email. Only needed after status email_required; an email found in the CV is used first."
    }
  },
  "required": [
    "raw_cv_text"
  ],
  "additionalProperties": false
}

Check a Krew Guru profile draft by its draft_token from create_seafarer_profile_draft: status (verification_sent or email_required), masked email, CV preview without contacts, handoff_url and matched_vacancies. Use this when the seafarer comes back later and asks about the draft or the matched vacancies. An unknown or expired token returns an error; then create a new draft. Do not use for signing in or for entering the email code: the seafarer does that on krew.guru.

{
  "type": "object",
  "properties": {
    "draft_token": {
      "type": "string",
      "pattern": "^[0-9a-f]{64}$",
      "description": "draft_token returned by create_seafarer_profile_draft (64 hex characters)."
    }
  },
  "required": [
    "draft_token"
  ],
  "additionalProperties": false
}