com.keywordise/keywordise

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

Auto-apply to jobs: matches your CV, tailors a fresh CV per posting, and applies for you.

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "keywordise": {
      "url": "https://keywordise.com/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (69)

• create_account

  Register a new Keywordise account from the terminal and receive an API key for it. Requires accept_terms=true: the person accepts the Terms and Privacy Policy (https://keywordise.com/terms) and authorises Keywordise to apply for jobs on their behalf. A confirmation email is sent; applying opens once the address is confirmed. Trial: 7 days and 27 applications, then Starter at $24.99/month (500 applications) or Pro at $49/month (1,000).

  Parameters:

  • email (required) — string
  • password (required) — string
  • accept_terms (required) — boolean

  Hints: read-only no · destructive no · idempotent no · open-world no

• login

  Exchange the account's email and password for a new API key, so a terminal or an assistant can act on the account. The key is shown once; keep it. Up to five keys may be active per account (revoke_api_key frees a slot).

  Parameters:

  • email (required) — string
  • password (required) — string
  • label — string — A name for this key, e.g. the machine it lives on.

  Hints: read-only no · destructive no · idempotent no · open-world no

• get_account read-only

  The account behind this key: email and whether it is confirmed, plan state (trial days left, applications used and remaining, subscription), and how many API keys are active.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• resend_verification_email

  Send the email-confirmation link again to this account's address. Applying is blocked until the address is confirmed; nothing else is.

  Hints: read-only no · destructive no · idempotent no · open-world no

• get_upgrade_link

  A checkout link for a paid plan from the active payment provider: Starter ($24.99/month, 500 applications a month) or Pro ($49/month, 1,000 a month; the default). The person opens it in a browser to pay; the account upgrades automatically when the payment lands.

  Parameters:

  • plan — string

  Hints: read-only no · destructive no · idempotent no · open-world no

• get_billing_portal_link read-only

  A link to the payment provider's customer portal for this account's subscription, where invoices, the payment method and cancellation live.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• cancel_subscription destructive

  Cancel the Pro subscription at the end of the current billing period. Access stays until then. Irreversible from here; the person can resubscribe later.

  Hints: read-only no · destructive yes · idempotent no · open-world no

• list_api_keys read-only

  The active API keys on this account: prefix, label, created and last used. Never the key itself.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• create_api_key

  Mint an additional API key for this account, for another machine or assistant. Shown once. Five active keys maximum.

  Parameters:

  • label — string

  Hints: read-only no · destructive no · idempotent no · open-world no

• revoke_api_key destructive

  Revoke one of this account's API keys immediately. Any terminal or assistant using it stops working at once. Revoking the key you are calling with ends this session.

  Parameters:

  • key_id (required) — string — From list_api_keys.

  Hints: read-only no · destructive yes · idempotent no · open-world no

• export_my_data read-only

  The account's complete data as one JSON file (profile, targeting, matched jobs, applications, saved answers, run history, audit trail). Returned as a file; large accounts are told to download it in the app instead.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• delete_my_account destructive

  Erase the account and everything in it: profile, CV files, matches, applications, answers, keys. Irreversible. Requires confirm_email equal to the account's address.

  Parameters:

  • confirm_email (required) — string

  Hints: read-only no · destructive yes · idempotent no · open-world no

• get_my_profile read-only

  Use when the person asks what is on their profile or CV. Not needed before searching or applying: those tools read the saved CV themselves. The CV profile Keywordise holds for this account (name, contact, summary, skills, roles, education), the job-targeting rules (countries, remote preference, keywords) and the plan status (applications remaining). Call this first.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• upload_cv

  Use when the person shares or mentions their resume/CV ('here's my resume', 'use my CV'). Upload a CV file and turn it into the account's profile: the same parser the app uses reads the document into name, contact, summary, roles, skills, languages and education. With save=true (default) the profile is saved and the job feed is built from it; with save=false the parsed profile is returned for review only. Max 8 MB.

  Parameters:

  • filename (required) — string — e.g. cv.pdf
  • content_base64 (required) — string — The file's bytes, base64-encoded.
  • save — boolean

  Hints: read-only no · destructive no · idempotent no · open-world no

• update_profile

  Change fields of the saved profile without re-uploading the CV. Send only the fields to change (full_name, contact_email, phone, location, city, address, postcode, professional_summary, skills, pinned_skills, languages, experience, education, projects, certifications, links, …); everything else is untouched. The feed is re-ranked against the new CV.

  Parameters:

  • patch (required) — object — Profile fields to change, by name.

  Hints: read-only no · destructive no · idempotent no · open-world no

• get_profile_gaps read-only

  The gaps in the saved profile that weaken applications (missing dates on a role, no contact phone, empty summary, …), each with a severity, so they can be fixed with update_profile.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• suggest_keywords read-only

  Search keywords derived from the saved profile, useful as include_keywords in update_targeting (jobs that mention one are ranked first; nothing is filtered out).

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• list_cv_designs read-only

  The CV designs a tailored CV can be rendered in, with the account's current pick.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• set_cv_design

  Set the design every tailored CV is rendered in (a key from list_cv_designs).

  Parameters:

  • design (required) — string

  Hints: read-only no · destructive no · idempotent no · open-world no

• get_my_cv_pdf read-only

  The account's base CV (the saved profile, untailored) rendered as a PDF in the chosen design, returned as a file. No model call.

  Parameters:

  • design — string — Optional; defaults to the saved design.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_targeting read-only

  Every targeting rule the feed and the apply run obey: remote mode, geo scope and countries, locations, include/exclude keywords, title allow/block lists, seniority, salary, languages, work authorisation, company allow/block, daily and per-company caps, cover-letter and CV settings, screening defaults.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• update_targeting

  Change targeting rules; send only the keys to change (remote_mode any|remote|hybrid|onsite, geo_scope worldwide|region|country, geo_countries [ISO-2], locations, include_keywords, exclude_keywords, title_allow, title_block, seniority, salary_min, currency, languages, company_block, max_apps_per_day, max_apps_per_company, cover_letter_enabled, cv_tone, tailor_instructions, years_experience, salary_expectation, notice_period, …). The feed re-matches in the background.

  Parameters:

  • patch (required) — object — Targeting fields to change, by name.

  Hints: read-only no · destructive no · idempotent no · open-world no

• describe_what_i_want

  Use when the person says what they are looking for in their own words ('senior remote data roles in the US, no agencies'). Turn a plain sentence ('remote data roles in Germany or the Netherlands, senior, not agencies') plus the saved CV into concrete targeting rules. Returns the inferred rules and the chips a person would confirm; with apply=true they are saved and the feed re-matches. preset: balanced | broad | focused.

  Parameters:

  • sentence (required) — string
  • apply — boolean
  • preset — string

  Hints: read-only no · destructive no · idempotent no · open-world no

• get_feed_reach read-only

  How many jobs the current targeting shows versus how many each single rule is hiding, and which one change would widen the feed most. Every number comes from re-asking the feed's own predicate with one control relaxed.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• list_countries_with_jobs read-only

  The countries the live pool actually has inventory in (ISO-2, name, job count), for choosing geo_countries in update_targeting.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• list_matching_jobs read-only

  Use when the person wants jobs or their best matches: 'find me jobs', 'my top matches', 'remote marketing jobs that fit my resume', 'what's new for me this week'. It already uses the saved CV, so there is no need to read the profile first. Live vacancies matched to this account's CV, ranked. Each job carries a calibrated match percentage, a recruiter-pass verdict with a one-line reason, whether we apply to it automatically from start to finish, whether it waits on an answer from the person, and whether an application was already sent. Jobs that apply automatically come first. Filter by match tier, freshness and applies-automatically; page with offset.

  Parameters:

  • sort — string — fit = best match first; fresh = newest day first, best match within it.
  • fresh — string — new = posted in the last two weeks; all = the last month.
  • limit — integer
  • match — string — Match tier. 'all' includes weak matches the recruiter pass rejected.
  • offset — integer
  • applied — string — hide = leave out jobs already applied to.
  • auto_only — boolean — true = only jobs we apply to automatically, start to finish.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_job_posting read-only

  The full description of one matched vacancy, with a short summary and highlights, plus the link that opens the posting from the app.

  Parameters:

  • job_id (required) — string — A job_id from list_matching_jobs or list_my_applications.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• explain_job_match read-only

  Use for 'is this job a good fit', 'why this match', 'what am I missing for this role'. For one vacancy: the match percentage, the requirements this account's CV covers and the ones it is missing. With narrative=true, also a short written assessment with strengths and gaps (a paid model call; limited to 60 per hour).

  Parameters:

  • job_id (required) — string — A job_id from list_matching_jobs or list_my_applications.
  • narrative — boolean

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• preview_tailored_cv read-only

  Use for 'tailor my resume for this job' or 'what would you send for this one'. Rewrite this account's CV for one vacancy the way Keywordise would send it: headline, summary, the roles selected for this job with rewritten bullets, curated skills and a cover letter, every segment labelled tailored, verbatim or pinned. Nothing is sent. A paid model call, limited to 20 per hour; the same billing gate as applying.

  Parameters:

  • job_id (required) — string — A job_id from list_matching_jobs or list_my_applications.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• rate_job

  Feedback on one job: hide or dislike removes it from the feed and teaches the matcher what this person rejects; interested is a positive signal. Undo with unhide_job.

  Parameters:

  • job_id (required) — string — A job_id from list_matching_jobs or list_my_applications.
  • action (required) — string
  • reason — string

  Hints: read-only no · destructive no · idempotent no · open-world no

• unhide_job

  Undo hide or dislike: the job returns to the feed and the negative signal is dropped.

  Parameters:

  • job_id (required) — string — A job_id from list_matching_jobs or list_my_applications.

  Hints: read-only no · destructive no · idempotent no · open-world no

• list_hidden_jobs read-only

  The jobs this account hid or disliked, newest first, so one can be put back.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• refresh_matches

  Match the account's CV against the vacancies added since it last looked, in the background. Idempotent and cheap when nothing is new. force=true runs a full re-match regardless. rebuild=true rebuilds the feed from scratch through the same build as the app's Rebuild button (use it when the feed looks wrong). Every answer carries `feed_build`: poll get_match_status until its state is `ready` before reading list_matching_jobs, because a feed that is still building is not an empty feed.

  Parameters:

  • force — boolean
  • rebuild — boolean

  Hints: read-only no · destructive no · idempotent no · open-world no

• get_match_status read-only

  Only for checking on a match or feed rebuild that is already running (after upload_cv, update_targeting or refresh_matches); to find or show jobs use list_matching_jobs. Live status of the latest match run (scanned, inserted, elapsed), the feed counts it produced, and `feed_build`: where the feed is in its build (queued, building, ready, failed). Poll after upload_cv, update_targeting or refresh_matches; the feed is final only when feed_build.feed_state.state is `ready`.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• start_apply_run destructive

  Use when the person says 'apply for me', 'apply to the best matches' or 'apply to this job' (pass job_id). Show them the jobs first. Start an application run: Keywordise takes up to `limit` of the matching jobs (same filters as list_matching_jobs, best fit first, never one already applied to), tailors the CV and cover letter for each, answers the employer's screening questions from the saved answers, and SUBMITS inside the employer's own system. Real applications leave in the person's name; needs a confirmed email and an active plan; counts against the plan. dry_run=true does everything except submit. Poll get_apply_run_status.

  Parameters:

  • fresh — string — Freshness window; defaults to the account's saved filter.
  • limit — integer
  • match — string — Match tier to draw from; defaults to the account's saved filter.
  • job_id — string — Apply to exactly this ONE job (an id from list_matching_jobs) instead of a filtered batch — the same run, scoped to it. limit/match/fresh are ignored when set.
  • dry_run — boolean

  Hints: read-only no · destructive yes · idempotent no · open-world yes

• get_apply_run_status read-only

  Live progress of the latest run: running or not (from a heartbeat, not a status claim), processed of total, the job being worked on now, confirmed, needs review, skipped, closed.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• stop_apply_run

  Use for 'stop applying', 'pause', 'hold off'. Ask the running application run to stop after the job it is on. Nothing is left half-done; applications already sent stay sent.

  Hints: read-only no · destructive no · idempotent no · open-world no

• list_my_applications read-only

  Use for 'what did I apply to', 'any replies', 'status of my applications'. Every application sent for this account: company, title, stage, outcome, when it went out, how many screening questions it still waits on, and the employer's acknowledgement where one was received.

  Parameters:

  • limit — integer
  • only_waiting_on_me — boolean — Only applications stalled on unanswered screening questions.
  • include_cover_letter — boolean

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• list_blocking_questions read-only

  Questions employers asked on applications that are stalled until this account answers them, grouped by application, each with a suggested answer drawn from what the person answered before. Answer with answer_screening_question.

  Parameters:

  • limit — integer — Maximum number of applications to expand.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• answer_screening_question destructive

  Record the person's answer to one screening question on one application. The answer is written in the person's name and saved to their answer book, so the same question is never asked again. When it is the last required answer, the application is SUBMITTED to the employer. Only give an answer the person actually stated.

  Parameters:

  • application_id (required) — string
  • question_id (required) — string
  • answer (required) — string

  Hints: read-only no · destructive yes · idempotent no · open-world yes

• get_sent_cv_pdf read-only

  The tailored CV PDF that went to the employer for one application, returned as a file.

  Parameters:

  • application_id (required) — string

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• list_run_history read-only

  The last five match runs and the last five application runs, with their counts and status.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• list_saved_answers read-only

  The answer book: every screening answer this account has given or taught, which future applications reuse automatically in any phrasing or language.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• save_answer

  Add or replace a screening answer in the answer book ('What is your notice period?' → '1 month'). Applications already waiting on that fact are completed and sent in the background. Only save what the person actually stated.

  Parameters:

  • question (required) — string
  • answer (required) — string
  • kind — string
  • options — array — For select questions: the choices the form offers.

  Hints: read-only no · destructive no · idempotent no · open-world no

• delete_saved_answer destructive

  Remove one answer from the answer book (an answer_id from list_saved_answers).

  Parameters:

  • answer_id (required) — string

  Hints: read-only no · destructive yes · idempotent no · open-world no

• list_facts_to_provide read-only

  The universal screening facts this account has not answered yet (right to work, notice period, salary expectation, …), ranked by how many waiting applications each one unblocks. Answer them with save_answer.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_tracker read-only

  The tracker board: applications grouped by the stage the person set (saved, applied, interview, offer, rejected) with their own notes.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• move_tracker_card

  Set the tracker stage of one application: saved, applied, interview, offer or rejected.

  Parameters:

  • application_id (required) — string
  • stage (required) — string

  Hints: read-only no · destructive no · idempotent no · open-world no

• set_tracker_note

  Replace the person's own note on one tracked application (interview date, contact, next step).

  Parameters:

  • application_id (required) — string
  • notes (required) — string

  Hints: read-only no · destructive no · idempotent no · open-world no

• get_live_job_counts read-only

  Use for 'how many jobs are there' or before quoting a number. The size of the live job pool Keywordise can apply to right now, from the same measurement the keywordise.com homepage prints: all live jobs, how many were found in the last 30 days, how many employers, and how many of them Keywordise applies to start to finish without the person doing anything.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• search_live_jobs read-only

  Use for 'find remote data engineer jobs', 'nursing jobs in Germany', 'what is new in marketing this week'. Searches the WHOLE live job pool (about two million open jobs), not only the person's matches, and needs no CV. Words must all appear in the title, employer or description. Filters: remote only, a two-letter country code, jobs found within N days. Newest first. Each job has a pool_job_id; jobs that also have a page on keywordise.com/jobs carry a public_id. To apply, call apply_to_public_job (public_id) or apply_to_live_job (pool_job_id). For jobs ranked against this person's CV use list_matching_jobs instead.

  Parameters:

  • limit — integer
  • query — string — Words such as 'data engineer' or 'python kubernetes'.
  • offset — integer
  • remote — boolean
  • country — string — Two-letter country code, e.g. DE, US, GB (list_countries_with_jobs).
  • posted_within_days — integer

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_live_job read-only

  The full posting text of one live job from search_live_jobs (pool_job_id): title, employer, place, date and the description. For a job in the person's own matches use get_job_posting.

  Parameters:

  • pool_job_id (required) — string — The pool_job_id from search_live_jobs.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_public_job read-only

  Use when the person gives a Keywordise job id (ten characters) or a keywordise.com/jobs link, for example 'tell me about job abcde23456'. Returns what the public page of that job shows: title, employer, place, date and a plain summary of the role. A job that has closed answers that it has closed. Apply with apply_to_public_job.

  Parameters:

  • public_id (required) — string — The Keywordise job id: ten letters and digits, the last part of a keywordise.com/jobs address (for example abcde23456).

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• apply_to_public_job destructive

  Use for 'Apply to Keywordise job abcde23456' or when the person asks to apply to a job from keywordise.com/jobs. Finds that job, puts it into the person's matches and starts the same application as the Apply button for that ONE job: tailors the CV and cover letter, answers the employer's questions and SUBMITS in the person's name. Needs the saved CV, a confirmed email and an active plan, and counts against the plan. Show the job first (get_public_job) and confirm with the person. dry_run=true prepares everything and sends nothing. Poll get_apply_run_status.

  Parameters:

  • public_id (required) — string — The Keywordise job id: ten letters and digits, the last part of a keywordise.com/jobs address (for example abcde23456).
  • dry_run — boolean

  Hints: read-only no · destructive yes · idempotent no · open-world yes

• apply_to_live_job destructive

  Use after search_live_jobs when the person picks one of the results to apply to. The same as apply_to_public_job, for a pool_job_id: puts the job into the person's matches and starts the application for that ONE job, which SUBMITS in the person's name. Needs the saved CV, a confirmed email and an active plan. Confirm with the person first. dry_run=true prepares and sends nothing.

  Parameters:

  • pool_job_id (required) — string — The pool_job_id from search_live_jobs.
  • dry_run — boolean

  Hints: read-only no · destructive yes · idempotent no · open-world yes

• get_referrals read-only

  Use for 'what is my referral code', 'how much did I earn from referrals', 'who signed up through me'. The person's referral code and link, the share they earn (and the discount a friend gets), their stats (signups, paying customers, earned, pending, paid out), recent commissions and payouts, and whether they were referred by someone.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• set_referral_code

  Set or change the person's own referral code (letters, digits and dashes, shown in their referral link). Fails with the app's own sentence when the code is taken or not allowed.

  Parameters:

  • code (required) — string

  Hints: read-only no · destructive no · idempotent no · open-world no

• claim_referral_code

  Record that the person was referred by the owner of a referral code, for the discount and the friend's credit. Allowed once, before the first payment; fails with the app's own sentence otherwise.

  Parameters:

  • code (required) — string

  Hints: read-only no · destructive no · idempotent no · open-world no

• get_inbox_address read-only

  The email address Keywordise uses on the person's applications (employers reply to it), whether replies are also forwarded to their own mailbox, and whether applying by email is active.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• list_inbox read-only

  Use for 'any replies?', 'did anyone get back to me?'. The person's Inbox: one thread per application with the employer's results (interview invitations, rejections, requests), unread count, newest first. Read one with read_inbox_message.

  Parameters:

  • limit — integer
  • unread_only — boolean

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• read_inbox_message read-only

  The full text of one Inbox message (from list_inbox), the employer's reply thread, and any verification code or link in it. Reading marks the message as read.

  Parameters:

  • message_id (required) — string

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• reply_to_inbox_message destructive

  SENDS an email to the employer in the person's name, as a reply to one Inbox message. Use only with the person's approval of the exact text. Fails with the app's own sentence when the message is not found or the text is empty.

  Parameters:

  • message_id (required) — string
  • text (required) — string

  Hints: read-only no · destructive yes · idempotent no · open-world yes

• list_cv_profiles read-only

  Use for 'which CVs do I have', 'is my CV uploaded'. The CVs on the account (a person can keep several; one is the default the matches and applications use) with their labels, plus `cv_state`: whether a usable CV is held and why not when it is not.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_application_details read-only

  The facts application forms ask beyond the CV: address, postcode, city, country, phone type, salutation, work authorisation by region, sponsorship, salary expectation, standard screening answers, and which of them are still missing. Read before telling the person what an application may be waiting for.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• update_application_details

  Change some of the application details. Only the fields given change; an empty string clears a field. Fields: salutation, address, postcode, city, state, country (two-letter code), phone_type (mobile, home or work), work_auth (object such as {"eu": true}), sponsorship (list of regions), salary_expectation (number). Only values the person actually stated.

  Parameters:

  • details (required) — object — The fields to change, see the description.

  Hints: read-only no · destructive no · idempotent no · open-world no

• get_application_review read-only

  For one application: every field of the form with its value and where the value came from (the CV, a saved answer, the person, or a model). For an application that waits for the person's review (`editable`), these are the answers about to be sent.

  Parameters:

  • application_id (required) — string

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• approve_application destructive

  The Send button of the review screen: SUBMITS an application that is waiting for review (get_application_review says editable), in the person's name. `edits` maps a field's label exactly as get_application_review shows it to the new answer; edits are saved to the person's answer book. Use only with the person's approval of the answers.

  Parameters:

  • application_id (required) — string
  • edits — object — Optional {field label: new answer}.

  Hints: read-only no · destructive yes · idempotent no · open-world yes

• prepare_external_application

  For a job the app marks as applied on the employer's own site (apply_to_public_job / start_apply_run answer that they do not apply there for the person): tailors the person's CV and writes the cover letter for that one job, on request, using no application credit. Returns the cover letter text; fetch the two PDFs with get_external_pack_pdf. A paid model call, cached per job. Nothing is sent to the employer.

  Parameters:

  • job_id (required) — string — A job_id from list_matching_jobs or from apply_to_public_job.

  Hints: read-only no · destructive no · idempotent no · open-world no

• get_external_pack_pdf read-only

  The tailored CV or the cover letter PDF written by prepare_external_application for one job, returned as a file.

  Parameters:

  • job_id (required) — string
  • document — string

  Hints: read-only yes · destructive no · idempotent yes · open-world no

Publisher website

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.